核心用法
onedrive-files 是一款面向 OpenClaw 生态的文档型 Skill，通过 ClawLink 托管代理无缝接入 Microsoft Graph API，实现对 OneDrive 个人云盘及 SharePoint 企业文档库的完整管理。用户无需自行配置 Azure AD 应用或管理 API 密钥，只需完成三步引导式账户配对即可使用。
该 Skill 提供 70 余项原子化工具，覆盖六大核心场景：驱动器与文件元数据查询、文件与文件夹的 CRUD 操作、权限管理与外链分享、文档签入签出版本控制、SharePoint 站点数据访问，以及格式转换与下载。所有工具调用均采用声明式指令（如 clawlink_call_tool --tool "one_drive_search_items"），ClawLink 自动注入 OAuth 令牌完成身份代理。
执行 workflow 区分安全等级：读操作（list/get/search）可直接执行；写操作（create/update/delete/share）强制遵循"描述→预览→确认→执行"四步流程，杜绝误触风险。大文件采用分块上传会话，删除操作默认进入回收站而非永久清除，分享外链支持细粒度权限控制（view/edit/organization/anyone）。
显著优点
零配置接入体验：传统 Microsoft Graph 集成需开发者注册 Azure AD 应用、配置重定向 URI、处理令牌刷新流程。该 Skill 通过 ClawLink 托管连接流将复杂度降为零，用户仅需浏览器 OAuth 授权即可生产可用。
功能完整度极高：对比官方 API 封装类 Skill，onedrive-files 几乎完整暴露 Graph API 能力边界，从基础的文件列举到高级的 SharePoint 站点列定义查询、版本历史追溯、签入签出协作机制均有覆盖，满足企业级文档管理需求。
安全设计前置：文档明确强制"All write operations require explicit user confirmation"，结合 Skill 自身的零本地代码架构（纯 Markdown），从根本上消除了传统代码注入、密钥硬编码、依赖项漏洞等典型风险。
生态协同优势：与同作者的 Outlook Inbox、OneNote Notes、SharePoint Sites 等 Skill 形成 Microsoft 365 工具矩阵，统一 ClawLink 认证体系下可实现跨服务数据流转。
潜在缺点与局限性
代理服务依赖单点：所有 API 流量必经 ClawLink 中转，形成额外的信任锚点与服务可用性依赖。若 ClawLink 服务中断或发生供应链攻击，用户令牌安全与功能可用性均受影响。
OAuth 权限范围过宽：为支持 70+ 工具的能力全集，授权时可能请求 Files.ReadWrite.All 等宽泛权限，超出特定只读场景的最小必要原则。用户需在授权对话框中主动审查并拒绝非必要权限。
个人开发者维护风险：来源级别 T3 意味着维护连续性依赖单一开发者（hith3sh），存在更新停滞、账户被盗后恶意版本注入、或开发者失去兴趣导致文档过时等社区项目常见问题。
无本地缓存与离线能力：纯代理架构下，文件内容传输需经 ClawLink 与 Microsoft 双重网络跳，大文件下载场景下延迟与带宽成本高于原生 SDK 直连方案。
适合的目标群体
- Microsoft 365 重度用户：日常深度使用 OneDrive/SharePoint 存储工作文档，希望通过自然语言指令快速完成文件检索、批量重命名、权限审计等操作。
- 无代码/低代码自动化构建者：需在 OpenClaw 工作流中集成云端文件操作，但缺乏 Azure AD 开发经验或权限配置资源。
- 中小团队协作场景：快速搭建基于 SharePoint 文档库的轻量级内容管理流程，无需部署专用服务器或购买第三方 SaaS。
- 合规敏感型组织：欣赏其"零本地代码+显式确认写操作"的安全架构设计，便于通过内部安全审计。
使用风险说明
供应链与代理风险：ClawLink 作为闭源托管服务，其内部数据处理方式、日志保留策略、子处理器清单均未完全公开。建议处理高度敏感数据（如财务报表、个人身份信息）前，通过官方渠道索取 SOC 2 或 ISO 27001 审计报告副本。
误操作与数据丢失：尽管写操作强制确认，但自然语言交互的歧义性仍可能导致意图误解（如"删除旧文件"的时间范围歧义）。建议关键操作前人工二次核对，并启用 OneDrive 版本历史与回收站保护机制。
权限蔓延与外链泄露：Skill 便捷生成的分享链接若未设置过期时间，可能形成长期有效的匿名访问入口。建议建立定期外链审计机制，或优先使用 organization-scoped 链接限制访问范围。
速率限制与配额消耗：Microsoft Graph API 对租户级请求频率存在限制，高频自动化场景可能触发 429 错误。需实现指数退避重试逻辑，并关注 ClawLink 是否透明传递 Retry-After 响应头。