notion

Notion 技能使您的 OpenClaw 助理能够直接与 Notion 平台互动，将您的工作区转变为可编程的数据中心。此技能在 AI 驱动的智慧与结构化的个人或团队数据之间架起桥梁，实现自动化内容生成、数据库项目管理与复杂的资讯检索。它专为依赖 Notion 进行工作流程记录、任务清单维护或存储知识库的高级用户、研究人员与专案经理所设计。

• 与 Notion API (v1, 2025-09-03 版本) 完全整合，可读取、更新及建立页面与区块。

• 支持进阶数据管理，包括查询数据库（数据来源）、排序结果及应用特定的属性筛选器。

• 修改页面内容的功能，例如附加富文本、段落区块或结构化数据库条目。

• 支持处理多样化的 Notion 属性类型，包括标题、富文本、单选、多选、日期范围、复选框、数字与关联属性。

• 根据最新的 Notion API 惯例识别数据库架构，将数据库视为数据来源进行操作。

• 请确保您已建立 Notion 集成并取得 API 密钥（以 ntn_ 或 secret_ 开头），并将其存储于您的本地设置目录中。

• 您必须透过 Notion 使用者界面手动将目标页面或数据库与您的集成进行“连接 (Connect to)”，以便代理程序获得访问权限。

• 请尊重 Notion API 每秒约 3 次请求的速率限制；代理程序会使用标准的重试逻辑来处理 429 速率限制响应。

• 请注意，复杂的 UI 专属功能（如已存储的数据库视图筛选器）无法透过 API 修改；请专注于数据导向的操作。

• 建立数据来源时，建议使用 is_inline 参数将其直接嵌入现有页面中，以提升组织层级。

• API 使用 UUID 进行页面与区块识别；执行读取或修补 (patch) 操作时请务必确保提供正确的 ID。

• 此技能需要始终使用 2025-09-03 API 版本标头，以确保与现代数据来源结构的相容性。