常用工具接入配置指南（Telegram/Notion/飞书/agent-reach）

📌 本页是集成配置参考手册。如果某个案例说”需要配置 Telegram/Notion/飞书”，来这里找对应的步骤就对了。

---

Telegram Bot 配置（5分钟）

适用案例：价格监控提醒、服务器告警、每日播报、定时任务通知……

第一步：创建 Bot

1. 在 Telegram 搜索 @BotFather，点击 Start
2. 发送 /newbot
3. 按提示输入：
   • Bot 名称（显示名，比如”我的OpenClaw助手”）
   • Bot 用户名（必须以 bot 结尾，比如 my_openclaw_bot）
4. BotFather 返回一串 API Token（格式：123456789:ABCdef...），复制保存

第二步：获取你的 Chat ID

1. 给你刚创建的 Bot 发任意一条消息
2. 在浏览器打开：https://api.telegram.org/bot你的TOKEN/getUpdates
3. 在返回的 JSON 里找 "chat":{"id":数字}，这个数字就是你的 Chat ID

第三步：告诉 OpenClaw

我的 Telegram Bot 配置如下：
- Bot Token：[你的 Token]
- 我的 Chat ID：[你的 Chat ID]

请帮我发一条测试消息到我的 Telegram，确认配置正常。
消息内容：OpenClaw 接入成功！🎉

---

Notion API 配置（10分钟）

适用案例：任务提醒、数据库AI助手、知识管理、周报汇总……

第一步：创建 Integration

1. 打开 notion.so/my-integrations
2. 点击 + New integration
3. 填写名称（比如”OpenClaw”），关联到你的工作区
4. 提交后复制页面上的 Internal Integration Token（格式：secret_xxx...）

第二步：连接数据库

1. 打开你要让 OpenClaw 访问的 Notion 数据库页面
2. 右上角点 ··· → Add connections → 找到刚创建的 Integration，连接

第三步：获取数据库 ID

打开数据库页面，URL 格式为：

https://www.notion.so/你的工作区/xxxxxxxxxxxxxxxxxxxxxxxxxx?v=...

URL 里那串 32 位字符（xxx...）就是 Database ID。

第四步：告诉 OpenClaw

我的 Notion 配置：
- Integration Token：[secret_xxx...]
- 数据库名称：任务管理
- 数据库 ID：[32位字符]

数据库的字段有：名称（标题）、截止日期（日期）、优先级（选择：高/中/低）、状态（选择：待处理/进行中/已完成）

请帮我查询所有状态为"进行中"且截止日期在本周内的任务，按截止日期排序。

---

飞书 Webhook 配置（5分钟）

适用案例：周报自动推送、服务器告警、团队通知……

配置飞书群机器人

1. 打开飞书群 → 右上角设置 → 群机器人 → 添加机器人
2. 选择 自定义机器人，填写名称和描述
3. 复制生成的 Webhook URL（格式：https://open.feishu.cn/open-apis/bot/v2/hook/xxx）

发送测试消息

请帮我往以下飞书 Webhook 发一条测试消息：

Webhook URL：[你的 URL]
消息内容：OpenClaw 飞书接入成功！🎉

使用 POST 请求，body 格式：
{"msg_type":"text","content":{"text":"消息内容"}}

飞书 App（读取消息/多功能）

如需读取消息或更多操作，需要创建飞书自建应用：

1. 打开 open.feishu.cn → 开发者后台 → 创建企业自建应用
2. 获取 App ID 和 App Secret
3. 开通所需权限（消息/日历/云文档等）
4. 发布应用

---

agent-reach 配置（15分钟）

适用案例：小红书热点监控、B站内容追踪、Twitter 信息流、竞品分析……

agent-reach 是 OpenClaw 的社交媒体数据技能，支持平台：Twitter/X、Reddit、YouTube、GitHub、Bilibili（B站）、小红书。

安装 agent-reach

帮我安装 agent-reach 技能

OpenClaw 会引导你完成安装。

配置各平台（按需）

Bilibili / 小红书（公开内容，无需登录）：

帮我用 agent-reach 搜索 B站 关键词"AI工具"的最新视频，返回标题、播放量和链接。

→ 公开内容无需额外配置，直接可用。

Twitter/X（需 API Key）：

1. 申请 developer.twitter.com Developer 账号
2. 创建 App，获取 Bearer Token
3. 告诉 OpenClaw：

我的 Twitter Bearer Token：[token]
请帮我搜索最近24小时提到 "OpenClaw" 的推文

小红书笔记监控（公开内容）：

帮我用 agent-reach 搜索小红书关键词"AI效率工具"的最新笔记，返回标题、点赞数和链接。

测试是否可用

帮我用 agent-reach 查一下 B站 UP主"林亦LYi"最近发了什么视频

---

配置完成后的验证

全部配置好后，测试一下整体联动：

请帮我做一个测试：
1. 用 agent-reach 搜索今天 B站 关键词"ChatGPT"的热门视频，取第一条
2. 把视频标题和链接通过 Telegram Bot 发给我（Chat ID：[你的ID]）

这个流程跑通的话，说明 agent-reach + Telegram 的组合已经可用了。

---

踩坑记录

Telegram Bot Token 错误
→ Token 格式是 数字:字母数字混合，不要包含空格，复制时注意不要多复制了换行符。

Notion API 返回 401 Unauthorized
→ 最常见原因：数据库没有连接 Integration。在数据库页面点 ··· → Add connections，确认你的 Integration 出现在列表里。

飞书 Webhook 发不出去
→ 检查 Webhook URL 是否完整，以 https://open.feishu.cn/... 开头。群机器人有一定的消息频率限制，测试时不要频繁发送。

agent-reach 小红书抓不到内容
→ 小红书有反爬机制，公开搜索通常可用，但特定用户主页可能需要登录态。如果遇到，改用 B站 或 微博 作为替代数据源。