$cd ../integrations/
⚡ Productivityv1.3+
$ cat notion-integration.md
openclaw.integrate('notion')
/** “添加任务：写一篇关于 OpenClaw 的教程，本周五前完成，P1 优先级” — 直接写入 Notion */
notion_commands.md
💬 强大的自然语言指令集
添加任务
"写一篇博客文章，本周五前完成，优先级 P1"
复杂查询
"帮我查一下跨所有项目，本周截止的全部任务"
状态更新
"将 Sprint 中的“API 接口文档”标记为已完成"
创建新页
"在研发团队库中创建新页面：2026-03-02 周会记录"
语义搜索
"帮我找到所有提到了“OpenClaw 架构迁移”的战略文档"
智能总结
"用三个要点总结一下我整个第一季度的 OKRs 数据库"
step_01_notion_api.md
步骤 1：创建一个自定义的 Notion 集成
1.
1. 前往 notion.so/my-integrations → 点击“新建集成”
给它起一个描述性的名字，比如 'OpenClaw Agent'。类型设置为 Internal（内部）。确保勾选了内容能力（Content Capabilities）：Read（读取）、Update（更新）和 Insert（插入）。
2.
2. 复制内部集成密钥 (Internal Integration Secret)
它的格式以 'secret_' 开头。请像对待密码一样保管它——这是您 Notion 空间的超级 API 密钥。
3.
3. 与集成共享您的目标数据库
Notion 集成默认没有全局访问权限。您必须显式地邀请机器人加入每个特定数据库。打开您的目标 Notion 页面/数据库 → 点击右上角的 ··· 菜单 → Connections (连接) → 点击添加您的 'OpenClaw Agent'。
config.yaml
步骤 2：将 OpenClaw 连接到 Notion
# openclaw/config.yaml
integrations:
notion:
enabled: true
token: "secret_YOUR_INTEGRATION_TOKEN"
databases:
tasks: "YOUR_TASKS_DB_ID"
// 💡 查找数据库 ID 技巧：在浏览器中打开您的数据库 → URL 地址中 '?' 前面的那串 32 位字符就是您的数据库 ID。
example_session.log
📱 自动化工作流实时演示
您
添加任务：写 OpenClaw 教程，截止本周五，优先级高
OpenClaw
✓ 已成功在 '内容日历' 数据库中创建：
标题：写 OpenClaw 教程
截止日期：2026-03-06
优先级：High
状态：未开始
快速链接：https://notion.so/abc123def456
您
在我目前所有进行中的项目里，本周有几个 P1 首要任务？
OpenClaw
您本周共有 3 个高优先级 (P1) 任务将要到期：
1. 编写 OpenClaw 教程 (截止: 周五) [所属: 内容库]
2. 代码审查 PR #47 (截止: 周三) [所属: 研发库]
3. Q1 季度规划文档 (截止: 周四) [所属: 管理库]
sync_daemon.ts
⚡ 自动化双向数据同步
// OpenClaw 可以轮询外部计算系统，并将结构化数据自动写入您的 Notion 工作区。
*GitHub Issues 同步至 Notion
遇到标记为 'bug' 的新 GitHub issues 时，OpenClaw 可以包含错误堆栈信息在内，自动将其镜像同步到您的 Notion Bug 追踪数据库中。
*会议语音自动总结
把会议录音文件拖入聊天框。OpenClaw 能够转录音频、提炼出 Action Items (待办事项)，并在您的 Notion 会议记录数据库中创建排版整洁的纪要页面。
troubleshoot.log
🔧 常见问题与修复指南
Q: 错误: object not found (HTTP 404 / 找不到对象)
A: 您的集成 Token 没有该特定页面或数据库的访问权限。请转到那个 Notion 页面，点击右上角三个点，选择 'Connect to' (连接到) 并添加您的 OpenClaw 机器人。
Q: 验证错误: body failed validation (请求体验证失败)
A: 您可能试图将数据插入一个根本不存在的字段，或者使用了错误的数据类型（例如：想把一段纯文本写入 Date 日期属性中）。请确保 OpenClaw 的数据映射与您 Notion 表格的 Schema 完全一致。
🚀 完美搭档：组合使用
❓ FAQ
Q1. 需要付费 Notion 吗？
不需要。API 可用于免费账户。只需内部集成令牌。
Q2. 能编辑现有页面吗？
能。追加内容、更新属性、创建新页面/数据库。