OneNote Notes

核心用法

该技能通过 ClawLink 插件桥接 OpenClaw 与 Microsoft OneNote API。用户无需自行申请 Azure AD 应用或管理 OAuth 令牌，由 ClawLink 托管完成身份验证流程。典型工作流程包括：

1. 插件安装：执行 openclaw plugins install clawhub:clawlink-plugin 并重启会话
2. 设备配对：调用 clawlink_begin_pairing 生成配对 URL，用户在浏览器中完成 ClawLink 账户授权
3. 服务连接：访问 claw-link.dev/dashboard?add=onenote 完成 Microsoft 账号授权
4. 工具发现：使用 clawlink_list_tools 动态获取 OneNote 相关工具，避免硬编码假设
5. 安全执行：写入操作前必须调用 clawlink_preview_tool 并获取用户确认

显著优点

• 零配置集成：省去 Azure AD 应用注册、重定向 URI 配置、令牌刷新等基础设施工作
• 动态工具发现：ClawLink 根据用户实际权限返回可用工具列表，避免功能假设错误
• 安全默认：工具元数据包含 safeDefaults、askBefore 等安全提示，降低误操作风险
• 本地凭证隔离：设备凭证仅存储于 OpenClaw 本地配置，不暴露于对话上下文

潜在局限与风险

| 类别 | 说明 |

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

| **供应商锁定** | 功能完全依赖 ClawLink 服务可用性，若 claw-link.dev 宕机则技能失效 |

| **权限盲区** | 实际可用功能取决于 Microsoft Graph 授予的 OAuth Scope，可能存在企业策略限制 |

| **延迟问题** | 每次工具调用需经 ClawLink 中继，较原生 API 调用增加网络跳数 |

| **调试困难** | 错误信息经过 ClawLink 封装，原始 OneNote API 错误可能丢失 |

适合人群

• 需要快速原型验证 OneNote 自动化的开发者
• 不具备 Azure AD 管理权限的企业用户
• 希望避免 OAuth 实现细节的对话式 AI 使用者

常规风险

• 凭证泄露：虽设备凭证本地存储，但 ClawLink 服务端持有用户的 Microsoft Graph 刷新令牌
• 数据驻留：笔记内容需经 ClawLink 服务器中转，敏感信息存在第三方暴露面
• 权限蔓延：建议定期审查 clawlink_list_integrations 返回的授权范围，及时断开未使用的集成

核心用法

本 Skill 为纯文档型集成方案，通过 ClawLink 托管服务实现与 Microsoft OneNote 的无缝对接。用户无需自行配置 OneNote API 访问凭证，只需安装 ClawLink 插件并完成设备配对流程，即可在聊天会话中调用动态工具集管理笔记内容。

典型操作流程包括：安装 clawhub:clawlink-plugin 插件 → 启动配对流程 clawlink_begin_pairing → 用户浏览器授权 → 连接 OneNote 服务 → 通过 clawlink_list_tools 动态发现可用工具。所有工具调用均通过 ClawLink 代理执行，支持笔记本/分区/页面的列表查询、内容读取、创建更新及搜索等功能。

显著优点

零配置集成：消除传统 API 集成的复杂OAuth流程，ClawLink 统一处理凭证托管与刷新。 动态工具发现：无需硬编码工具定义，实时根据用户连接状态返回可用操作集。 安全隔离设计：设备凭证仅存储于本地 OpenClaw 配置，不向聊天会话暴露敏感信息。 操作可预览：所有写入操作支持 clawlink_preview_tool 预演，降低误操作风险。

潜在缺点与局限性

外部服务依赖：核心功能完全依赖 ClawLink 服务的可用性与连续性，若服务中断将导致功能失效。 权限边界模糊：动态工具集的具体能力取决于用户 Microsoft 账户的实时授权范围，存在功能不确定性。 T3 来源风险：维护者为个人开发者，长期维护承诺与商业支持能力存疑。 网络延迟：所有操作需经 claw-link.dev 中转，对网络稳定性敏感。

适合的目标群体

• 需要快速接入 OneNote 且不愿处理 Azure AD 应用注册流程的个人用户
• 使用 OpenClaw 生态并追求统一集成管理体验的技术爱好者
• 轻量级笔记管理场景，无需复杂自定义逻辑的非企业用户

常规使用风险

凭证集中化风险：ClawLink 作为凭证托管方成为单点信任实体，需关注其安全公告与合规认证。 数据流经第三方：笔记内容通过 ClawLink 基础设施传输，敏感信息场景建议评估数据驻留政策。 版本兼容性：OneNote API 变更可能导致工具集行为漂移，需保持插件更新。 功能漂移：动态工具发现模式可能在未来版本中引入破坏性变更，自动化脚本需做适配预留。