教程 21 — OpenClaw Notion Skill 教程：用 AI 创建页面、查询数据库、自动写周报（2026）
目标：安装 Notion Skill，通过 Notion API 让 OpenClaw 用自然语言操作 Notion：创建页面、查询数据库、更新任务状态。
什么是 Notion Skill？
Notion Skill 是 ClawHub 上的高频工作效率 Skill（68k 下载），通过官方 Notion API 让 OpenClaw 完全控制你的 Notion 工作区。创建页面、查询数据库、更新任务状态、生成周报——这些原本需要在 Notion 界面手动完成的操作，现在用一句话就能搞定。
SEO 关键词覆盖：openclaw 自动创建 notion 页面、ai 帮我写 notion 周报 自动化、openclaw notion 替代 zapier 更便宜
第一步：创建 Notion Integration 并获取 API Key
在安装 Skill 前，需要先在 Notion 创建一个 Integration：
步骤 1：访问 https://www.notion.so/my-integrations，点击右上角 "+ New integration"。
步骤 2：填写 Integration 名称（如"OpenClaw"），选择关联的 Workspace，点击 "Submit"。
步骤 3：创建成功后，复制 "Internal Integration Token"，格式为 secret_xxxxxxxxx，这就是你的 API Key。
步骤 4：给 Integration 授权访问指定页面或数据库。在 Notion 中打开目标页面，点击右上角 "..." → "Add connections" → 选择你刚创建的 Integration。
注意：Notion Integration 默认没有任何权限，必须手动把它连接到你需要操作的页面，否则 AI 无法访问。
第二步：安装 Skill 并配置 API Key
在 WebChat 或 Telegram 中发送：
/install @steipete/notion
配置 API Key：
/config notion api_key secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
或者通过命令行：
pnpm openclaw config set notion.api_key "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"验证配置：
pnpm openclaw run "列出我 Notion 工作区里所有数据库的名称"如果返回数据库列表，说明 openclaw notion api 授权 教程 配置成功。
第三步：创建页面和子页面
创建独立页面：
在 Notion 的"项目文档"页面下创建一个新子页面，标题是"OpenClaw 集成方案"，
正文写一份简单的项目背景介绍，大约 200 字
创建带结构的页面：
在"会议记录"页面下创建一篇今天（2026-03-30）的会议记录，
包含以下模块：参会人员、议题、决策事项、待办清单
通过 API 创建（适合自动化脚本）：
pnpm openclaw run "用 Notion API 在 page_id=xxx 下创建子页面，标题：Q2 OKR 规划，内容：[你的内容]"openclaw 自动创建 notion 页面 最常用的场景是会议记录、项目文档、知识库词条的快速创建。
第四步：数据库查询（过滤 + 排序）
查询带过滤条件的数据库：
查询"任务管理"数据库里所有状态为"进行中"的任务，按截止日期升序排列
多条件过滤：
在"项目追踪"数据库里找出：负责人是"张三"、优先级是"高"、本周截止的任务
全文搜索：
搜索 Notion 里所有包含"MCP 协议"关键词的页面
openclaw 查询 notion 数据库 过滤条件 支持 Notion 的所有过滤类型：文本匹配、数字范围、日期区间、多选标签、关系字段等。
第五步：更新数据库条目
批量更新任务状态：
把"任务管理"数据库里所有截止日期早于今天且状态不是"已完成"的任务，状态改为"已逾期"
添加标签：
给"知识库"数据库里所有涉及"AI"的页面添加标签"人工智能"
更新单个条目：
把任务"完成 API 文档"的状态改为"已完成"，完成日期设为今天
第六步：实际工作流——自动生成每周周报
这是 ai 帮我写 notion 周报 自动化 最典型的落地场景。每周五下班前发送：
从我的"任务管理"数据库里，汇总本周（2026-03-24 到 2026-03-28）已完成的任务，
生成一篇结构化周报，创建到"周报存档"页面，标题格式：2026-W13 周报
生成的周报结构示例：
# 2026-W13 周报
## 本周完成
- [x] 完成 OpenClaw Notion Skill 文档（Lesson 21）
- [x] 修复 MCP 连接超时 bug
- [x] 上线用户反馈收集功能
## 本周数据
- 完成任务：8 项
- 新增任务：3 项
- 逾期任务：1 项
## 下周计划
- [ ] 完成 Lesson 22 Auto-Updater 文档配合 cron 自动触发（参考 Lesson 06）：
# 每周五 17:30 自动生成并创建周报
30 17 * * 5 pnpm openclaw run "生成本周 Notion 周报并保存"第七步：和 GitHub Skill 组合使用
把 Lesson 14 的 GitHub Skill 与 Notion Skill 串联，实现开发记录自动同步：
查询过去 7 天合并到 main 分支的所有 PR，
按功能模块分类，同步到 Notion 的"开发日志"数据库，
每条记录包含：PR 标题、合并时间、作者、关联 Issue
这个工作流实现了 openclaw notion 替代 zapier 更便宜 的核心价值：不需要 Zapier 订阅，直接用 OpenClaw 把 GitHub 和 Notion 打通。
常见问题
OpenClaw Notion Skill 需要付费的 Notion 账号吗？
不需要付费账号。Notion API 对免费账号完全开放，你可以在免费计划上创建 Integration 并使用所有 API 功能，包括创建页面、查询数据库、更新条目。免费账号的限制主要是成员数量（最多 10 人协作）和文件上传大小（5MB），这些限制不影响 OpenClaw 的 AI 自动化操作。唯一需要注意的是，Notion API 有速率限制（每秒 3 次请求），批量操作时 Skill 会自动控制请求频率。
如何让 AI 每天自动更新 Notion 任务状态？
配合 Lesson 06 的定时任务功能，在 crontab 中添加每日任务：0 9 * * * pnpm openclaw run "更新 Notion 今日任务状态"，然后在提示词中描述你的更新规则，比如"把昨天未完成的任务截止日期顺延一天"。你也可以在 OpenClaw 的 Hooks 配置中设置基于条件触发的更新，比如当 GitHub PR 合并时自动更新 Notion 里对应任务的状态。
Notion API Key 会不会被泄露？
API Key 存储在 OpenClaw 的本地配置文件中（~/.openclaw/config.json），不会上传到任何云端。建议把配置文件的权限设为 600（chmod 600 ~/.openclaw/config.json），防止同机器上的其他用户读取。如果你怀疑 Key 已泄露，立刻到 Notion Integration 设置页面重新生成一个新 Token，旧 Token 会立即失效。此外，建议创建一个权限最小化的 Integration，只连接它实际需要操作的页面，而不是整个 Workspace。
支持 Notion 数据库的所有属性类型吗？
支持 Notion API 公开的所有属性类型，包括：文本、数字、选择（单选/多选）、日期、人员、文件、复选框、URL、邮箱、电话、公式、关系、汇总（Rollup）。唯一的限制是公式字段只能读取计算结果，不能修改公式本身。AI 在操作数据库前会先读取 Schema，自动识别每个字段的类型，你用自然语言描述"把状态改为已完成"时，它会自动对应到正确的属性类型。