Notion
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @org-eyw2ohcx/sundial-org-awesome-openclaw-skills-notion-2。
技能介绍
要解决什么问题
智能体要操作 Notion,不能只靠「打开网页、复制粘贴」:页面和数据库都有正式 REST API,但鉴权(Integration Token、页面共享)、块级追加与查询参数、数据库 schema 与行 ID 等细节很容易踩坑。本技能把官方 Notion API 上相对安全、可重复的操作收成一份声明式说明,并假定本地由 notion-cli 真正发起请求,让 agent 按文档执行而不是即兴拼装 curl。
技能如何工作
鉴权与可见范围:在 Notion Integrations 创建集成,使用 Internal Integration Token(如 NOTION_TOKEN),并把集成邀请到目标页面或数据库;未共享的内容对 API 不可见。
多环境:可通过环境变量或配置定义 personal / work 等 profile,默认 personal,用 NOTION_PROFILE 切换。
页面:notion-cli page read 读取页面;page append 追加块(文档明确建议优先追加而非整页重写);page create 在父页面下新建子页面。
数据库:db inspect 查看 schema;db query 按条件查询;db create-row / db update-row 增改行。高级 schema 变更需先 schema diff 审阅差异,且未经明确确认不得改库结构。
边界与注意点
API 有速率限制,批量读写要分批。倾向 append 与 update,避免破坏性删除。页面/库/行的 ID 是 opaque 字符串,应显式存储,不要从 URL 猜测 ID。
使用场景
- 周报写完后,要把结构化要点以块形式追加到团队 Notion 父页面下,而不是手工粘贴整页
- 项目跟踪库里已有 schema,需按状态筛选行并把字段更新为最新里程碑日期
- 新建子页面挂到指定父页面 ID,用于一次性的需求说明或会议纪要归档
- 改数据库字段类型前先跑 schema diff,核对差异再决定是否应用变更
适合人员
- 用 Notion 管需求与会议纪要、希望 agent 按父页面 ID 追加内容而不是改乱版式的产品经理
- 维护多张 Notion 数据库(任务、客户、库存),需要按条件查询并批量改行的运营或项目协调
- 在个人与工作 workspace 间切换,要用 profile 区分 token 与默认环境的开发者
- 集成 OpenClaw 等 agent 框架、要把 Notion 读写收成 CLI 可调步骤的自动化维护者