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

😀 今天研究通过openclaw给notion写文章，以下是详细的安装和配置过程。

一、安装 Notion 插件

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

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

npm install -g clawhub

验证安装：

clawhub -v

步骤 2：登录 ClawHub

clawhub login

• 自动打开浏览器完成 GitHub 认证
• 生成 Token 后粘贴到终端

步骤 3：安装 Notion 插件

# 安装 notion-sync 技能
clawhub install notion-sync

步骤 4：验证安装

openclaw skills list

确认显示 Notion 相关技能。

二、获取 Notion API Token

步骤 1：创建 Notion 集成应用

1. 访问 notion.so/my-integrations
2. 点击 "New integration"
3. 填写信息：

• Name: OpenClaw（或自定义）
• Associated workspace: 选择目标工作区
• Type: Internal（自用）或 Public（分享）

4. 点击 Submit

步骤 2：复制 Integration Token

• 进入集成详情页
• 点击 "Show" 显示 Token
• 复制 Token（格式：ntn_xxx）
• ⚠️ Token 只显示一次，务必保存好

三、配置 Token 到 OpenClaw

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

openclaw onboard

按提示操作：

1. "Configure skills now?" → 选 Yes
2. "Set NOTION_API_KEY for notion?" → 选 Yes
3. 粘贴 Token
4. 完成配置

方法 ：通过环境变量

# 临时设置
echo "notion:
  token: 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" >> ~/.openclaw/config.yaml

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

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

授权单个页面/数据库：

1. 在 Notion 中打开目标页面/数据库
2. 点击右上角 "..." → "Connect to" / "Add connections"
3. 搜索并选择你的集成应用名称（如"OpenClaw"）
4. 点击 Confirm

批量授权技巧：

• 创建顶层页面，将内容作为子页面
• 仅授权顶层页面，子页面自动继承权限

五、验证配置

# 方法 1：列出可访问的 Notion 页面
openclaw notion-cli pages list

# 方法 2：检查技能状态
openclaw skills list
# 确认 notion 技能显示为 active

# 方法 3：对话测试
"帮我列出 Notion 中所有数据库"

六、通过 OpenClaw 发布文章

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

示例指令：

"帮我在 Notion 的'博客'数据库中创建一篇新文章，标题是'OpenClaw 使用指南'"

"将以下内容发布到我的 Notion 页面：..."

或通过命令行：

openclaw notion-cli pages create --title "新文章标题" --parent "页面ID"

七、常见问题排查

快速诊断命令：

openclaw --version
openclaw skills list
openclaw config get
ls -la ~/.openclaw/extensions/

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

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

总结流程图：

安装 ClawHub → 安装 Notion 技能 → 获取 Notion Token → 配置到 OpenClaw → 授权页面访问 → 验证 → 开始使用