OneNote Notes

核心功能

OneNote Notes 是一款基于 Microsoft Graph API 的笔记管理技能，专为 OpenClaw 平台设计。它通过 ClawLink 托管服务实现 OAuth 认证代理，让用户无需自行配置 Azure AD 应用即可安全访问 OneNote 完整功能栈。

主要能力

| 层级 | 功能 |

|------|------|

| **笔记本** | 列出、创建、复制（支持 SharePoint 站点和 Microsoft 365 组） |

| **分区** | CRUD 操作、重命名、跨笔记本复制 |

| **页面** | HTML 内容读写、增量更新（patch 命令）、删除 |

| **分区组** | 嵌套层级管理、计数查询 |

| **异步操作** | 复制任务状态轮询 |

显著优点

1. 零配置接入：ClawLink 托管 OAuth 流程，用户仅需网页授权
2. 原生 HTML 支持：页面内容以标准 HTML 交互，便于模板化和自动化生成
3. 企业级兼容：支持个人、SharePoint 站点、Microsoft 365 组三种存储上下文
4. 安全设计：所有写操作强制用户确认，token 由 ClawLink 安全托管

局限性与风险

| 限制类型 | 具体说明 |

|---------|---------|

| **平台绑定** | 仅支持 Microsoft OneNote，不与 Notion、Obsidian 等互通 |

| **命名约束** | 分区名 ≤50 字符，笔记本名 ≤128 字符，禁用特定特殊字符 |

| **异步延迟** | 复制操作需轮询状态，非即时完成 |

| **网络依赖** | 完全依赖 Microsoft Graph 可用性与 ClawLink 服务稳定性 |

| **权限边界** | 仅能访问已授权账户的笔记本，无法跨租户操作 |

适合人群

• 知识工作者：需要将对话内容结构化归档到企业笔记系统
• 自动化开发者：构建基于笔记模板的文档生成工作流
• Teams/SharePoint 用户：深度集成 Microsoft 365 生态的团队协作场景

常规风险提示

• 写操作（创建/更新/删除）需显式用户确认，避免误触数据丢失
• HTML 内容需符合规范（完整 html/head/body 结构），否则 API 可能拒绝
• 建议定期验证 clawlink_list_integrations 确保连接状态，避免 token 过期导致调用失败

核心用法

本 Skill 是一套面向 Microsoft OneNote 的云端笔记管理解决方案，通过 ClawLink 托管的 OAuth 认证流程，让用户无需自行申请 Microsoft Graph API 密钥即可完成账号授权。安装 ClawLink 插件后，用户可通过自然语言指令执行笔记本列表查询、分区管理、页面创建与更新、HTML 内容读取等操作。核心工作流分为三步：安装插件并完成设备配对、在 ClawLink 仪表板连接 OneNote 账号、通过 clawlink_call_tool 调用具体工具完成笔记操作。

所有 API 调用均通过 ClawLink 代理转发，用户侧仅需关注业务指令，无需处理 Token 刷新、权限校验等底层细节。支持的完整操作覆盖笔记本生命周期（创建、复制、查询）、分区层级管理（嵌套分区组、重命名、跨笔记本复制）、页面内容处理（HTML 读取、增量更新、批量删除）以及异步任务状态轮询。

显著优点

零配置接入：彻底消除了传统 Microsoft Graph 开发需要注册 Azure 应用、配置回调 URL、管理 Refresh Token 的门槛，普通用户可在 3 分钟内完成从安装到首条笔记查询的全过程。

权限边界清晰：Skill 严格遵循最小权限原则，读取操作可直接执行，所有写入类操作（创建、更新、删除）强制要求用户显式确认，避免误操作导致的数据丢失。

原生 HTML 支持：OneNote 页面内容以标准 HTML 形式交互，支持完整的文档结构（含 html/head/body 标签），便于与其他内容系统对接或进行程序化内容生成。

企业级生态兼容：深度支持 SharePoint 站点笔记本、Microsoft 365 组笔记本等企业场景，满足团队协作环境下的笔记迁移与同步需求。

潜在缺点与局限性

第三方代理依赖：核心功能完全依赖 ClawLink 服务中转，用户需额外信任该平台的稳定性与数据安全政策。若 ClawLink 服务中断或政策调整，Skill 将失效。当前文档未披露 ClawLink 的数据缓存策略、日志保留周期等关键信息。

异步操作复杂度：笔记本/分区复制等操作采用异步模式，返回 202 Accepted 后需手动轮询 Operation-Location 端点确认完成状态，增加了调用方的实现复杂度。

命名规则限制：分区名称限 50 字符、笔记本名称限 128 字符，且禁止包含 ?*/:<>|&#''%~ 等特殊字符，自动化生成名称时需额外校验。

网络可达性要求：ClawLink 服务器（claw-link.dev）与 Microsoft Graph API 均需稳定访问，网络波动可能导致授权失效或工具调用失败。

适合的目标群体

• 企业知识工作者：需集中管理 SharePoint/Teams 关联笔记本、进行跨部门笔记迁移的 Office 365 用户
• 自动化内容创作者：希望将 OneNote 作为最终输出渠道，通过程序生成结构化笔记的技术写作者
• 个人效率极客：追求笔记工作流自动化，希望用自然语言快速归档、检索、整理笔记的高级用户
• 低代码集成开发者：需在 OpenClaw 生态内快速打通 Microsoft 365 笔记数据，避免从零搭建 Graph API 连接的项目团队

使用风险

数据隐私风险：用户笔记内容在传输过程中经过 ClawLink 服务器，虽采用 TLS 1.2+ 加密，但 ClawLink 的数据处理政策（是否解析内容、留存日志时长）尚未在文档中充分披露。

供应商锁定风险：Skill 与 ClawLink 插件深度绑定，若 ClawLink 停止服务或更改 API，现有工作流将中断，迁移成本较高。

插件版本兼容性：ClawLink 插件更新可能引入 Breaking Changes，当前 Skill 未声明测试通过的插件版本范围，存在功能异常风险。

误操作数据丢失：尽管有确认机制，批量删除操作（如 onenote_delete_user_pages）一旦执行不可逆，需严格遵循"预览→确认→执行"的安全工作流。