核心功能
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 过期导致调用失败