OpenClaw 安装与配置 Notion 插件完整指南

type

Post

status

Published

date

Mar 15, 2026

slug

summary

一、安装 Notion 插件

方法一：通过 ClawHub 安装（官方推荐）

步骤 1：安装 ClawHub 命令行工具

验证安装：

步骤 2：登录 ClawHub

自动打开浏览器完成 GitHub 认证

生成 Token 后粘贴到终端

步骤 3：安装 Notion 插件

步骤 4：验证安装

确认显示 Notion 相关技能。

二、获取 Notion API Token

步骤 1：创建 Notion 集成应用

访问 notion.so/my-integrations

点击 "New integration"

填写信息：

Name: OpenClaw（或自定义）

Associated workspace: 选择目标工作区

Type: Internal（自用）或 Public（分享）

点击 Submit

步骤 2：复制 Integration Token

进入集成详情页

点击 "Show" 显示 Token

复制 Token（格式：ntn_xxx）

⚠️ Token 只显示一次，务必保存好

三、配置 Token 到 OpenClaw

方法 A：通过 onboard 向导（推荐）

按提示操作：

"Configure skills now?" → 选 Yes

"Set NOTION_API_KEY for notion?" → 选 Yes

粘贴 Token

完成配置

方法：通过环境变量

四、授权 Notion 页面/数据库访问

关键步骤：Notion 集成默认无访问权限，需手动授权。

授权单个页面/数据库：

在 Notion 中打开目标页面/数据库

点击右上角 "..." → "Connect to" / "Add connections"

搜索并选择你的集成应用名称（如"OpenClaw"）

点击 Confirm

批量授权技巧：

创建顶层页面，将内容作为子页面

仅授权顶层页面，子页面自动继承权限

五、验证配置

六、通过 OpenClaw 发布文章

配置完成后，直接在 OpenClaw 对话中使用：

示例指令：

或通过命令行：

七、常见问题排查

问题	原因	解决方案
`Unrecognized key: "notion"`	未安装 Notion 技能	先执行 `clawhub install notion-sync`
`API token is invalid`	Token 错误或已重置	重新到 Notion 后台复制正确 Token
`Could not find database`	未授权访问	在页面点击 "..." → "Connect to" 授权
`Insufficient permissions`	权限不足	检查集成 Capabilities 设置

快速诊断命令：

八、权限设置建议（安全最佳实践）

在 Notion 集成设置中建议开启：

能力	建议	用途
Read content	✅ 必须	读取页面和数据库
Update content	✅ 建议	修改页面内容
Insert content	✅ 建议	创建新页面
User information	⚪ 可选	获取用户信息
Comment access	⚪ 可选	读取和添加评论

总结流程图：

一、安装 Notion 插件

方法一：通过 ClawHub 安装（官方推荐）

二、获取 Notion API Token

三、配置 Token 到 OpenClaw

方法 A：通过 onboard 向导（推荐）

方法：通过环境变量

四、授权 Notion 页面/数据库访问

五、验证配置

六、通过 OpenClaw 发布文章

七、常见问题排查

八、权限设置建议（安全最佳实践）

AD

交流频道

加入我们的社群讨论分享

一、安装 Notion 插件

方法一：通过 ClawHub 安装（官方推荐）

二、获取 Notion API Token

三、配置 Token 到 OpenClaw

方法 A：通过 onboard 向导（推荐）

方法 ：通过环境变量

四、授权 Notion 页面/数据库访问

五、验证配置

六、通过 OpenClaw 发布文章

七、常见问题排查

八、权限设置建议（安全最佳实践）

AD

交流频道

加入我们的社群讨论分享

方法：通过环境变量