Notion Agent

通过AI代理管理Notion工作区的OpenClaw技能。提供针对页面、数据库、块和搜索的CLI命令。

设置

1. 1. 创建Notion集成：

- 访问 https://www.notion.so/my-integrations - 点击新建集成 - 为其命名（例如OpenClaw） - 复制内部集成令牌

1. 2. 设置环境变量：

bash export NOTION_TOKEN=你的集成令牌

1. 3. 与集成共享页面/数据库：

- 在Notion中打开页面或数据库 - 点击... → 添加连接 - 选择你的集成

使用方法

所有命令均使用以下模式：
bash
uv run {baseDir}/scripts/notion.py <命令> [选项]

页面操作

创建页面：
bash
uv run {baseDir}/scripts/notion.py page create \
--parent <父页面ID> \
--title 我的新页面 \
--content 初始段落内容

获取页面：
bash
uv run {baseDir}/scripts/notion.py page get <页面ID>

更新页面：
bash
uv run {baseDir}/scripts/notion.py page update <页面ID> \
--title 更新后的标题

删除（归档）页面：
bash
uv run {baseDir}/scripts/notion.py page delete <页面ID>

列出子页面：
bash
uv run {baseDir}/scripts/notion.py page list --parent <页面ID>

数据库操作

查询数据库：
bash

简单查询

uv run {baseDir}/scripts/notion.py db query <数据库ID>

带筛选条件

uv run {baseDir}/scripts/notion.py db query <数据库ID> --filter Name=Todo

带排序

uv run {baseDir}/scripts/notion.py db query <数据库ID> --sort Priority:desc

向数据库添加页面：
bash
uv run {baseDir}/scripts/notion.py db add <数据库ID> \
--props {Name:{title:[{text:{content:任务}}]},Status:{select:{name:已完成}}}

列出所有数据库：
bash
uv run {baseDir}/scripts/notion.py db list

块操作

追加段落：
bash
uv run {baseDir}/scripts/notion.py block append <页面ID> \
--type paragraph \
--text 这是一个段落

追加待办事项：
bash
uv run {baseDir}/scripts/notion.py block append <页面ID> \
--type todo \
--text 待完成任务 \
--checked

追加标题：
bash
uv run {baseDir}/scripts/notion.py block append <页面ID> \
--type heading1 \
--text 章节标题

追加代码块：
bash
uv run {baseDir}/scripts/notion.py block append <页面ID> \
--type code \
--text print(Hello, World!) \
--language python

列出子块：
bash
uv run {baseDir}/scripts/notion.py block children <块ID>

搜索

搜索工作区：
bash

搜索全部

uv run {baseDir}/scripts/notion.py search 项目计划

仅搜索页面

uv run {baseDir}/scripts/notion.py search 会议记录 --type page

仅搜索数据库

uv run {baseDir}/scripts/notion.py search 任务 --type database

错误处理

CLI处理常见错误：

• - NOTIONTOKEN未设置 — 设置环境变量
• 无效的NOTIONTOKEN — 检查你的集成令牌
• 未找到资源 — 页面/数据库不存在或集成缺少访问权限
• 权限被拒绝 — 与你的集成共享该资源

API参考

• - 基础URL： https://api.notion.com/v1
• API版本： 2022-06-28
• 认证方式： 通过NOTION_TOKEN的Bearer令牌

限制

• - 仅使用requests库（不使用Notion SDK）
• 简单的筛选/排序语法（单一属性）
• 富文本仅限于纯文本内容
• 数据库属性必须格式化为JSON

AI代理示例

创建会议记录页面：
bash
uv run {baseDir}/scripts/notion.py page create \
--parent <工作区根ID> \
--title 会议记录 - 2026-03-10 \
--content 与会人员：团队

向项目数据库添加任务：
bash
uv run {baseDir}/scripts/notion.py db add <项目数据库ID> \
--props {Name:{title:[{text:{content:修复Bug #123}}]},Status:{select:{name:进行中}},Priority:{select:{name:高}}}

构建结构化页面：
bash
PAGE_ID=$(uv run {baseDir}/scripts/notion.py page create --parent <父页面> --title 报告 | jq -r .id)
uv run {baseDir}/scripts/notion.py block append $PAGE_ID --type heading1 --text 执行摘要
uv run {baseDir}/scripts/notion.py block append $PAGE_ID --type paragraph --text 关键发现...
uv run {baseDir}/scripts/notion.py block append $PAGE_ID --type heading2 --text 详细信息
uv run {baseDir}/scripts/notion.py block append $PAGE_ID --type todo --text 审查发现

帮助

bash
uv run {baseDir}/scripts/notion.py --help
uv run {baseDir}/scripts/notion.py page --help
uv run {baseDir}/scripts/notion.py db --help
uv run {baseDir}/scripts/notion.py block --help