写在前面
平台接入页解决的是“让 OpenClaw 真正可用”。安装完成不代表你已经能在聊天软件里用起来;你还需要先选一个最合适的通道,准备平台侧凭据,再完成首条消息验证。
适合谁
- 已经完成基础安装和关键配置,准备接入第一个聊天平台的人;
- 不确定 Telegram、Discord、飞书该从哪个先下手的人;
- 已经有平台账号和 Token,但不清楚 OpenClaw 侧最小配置边界的人;
- 通道已连接却不回复,不知道是配对、提及门控还是平台权限问题的人。
你会完成什么
- 知道第一次接入时为什么通常优先选 Telegram,再考虑 Discord、飞书等平台;
- 知道平台侧要先准备哪些信息;
- 知道接入后的第一轮验证应该看什么;
- 知道平台接入失败后该先回哪一页排查。
推荐步骤
1. 先只选一个平台,不要同时铺开
第一次接入更重要的是建立一条稳定链路,而不是覆盖所有通道。优先选你本来就高频使用、资料最成熟、验证路径最短的平台。
先看:第一次接入先选哪个平台
2. 准备平台侧最小凭据
Telegram 需要 Bot Token,Discord 需要 Bot Token 和基础权限,飞书通常需要插件与 App ID/App Secret。先把平台侧信息准备完整,再回到 OpenClaw 侧填最小配置。
3. 做首条消息验证
验证顺序最好固定成四步:状态、pairing、第一条消息、日志。这样你能快速知道问题是在凭据、权限、策略还是主进程。
关键判断点
第一次接入,优先级怎么排?
默认推荐 Telegram,其次 Discord;如果你的真实场景是团队协作,再考虑飞书。第一次验证最好先走私聊入口,因为变量最少。
平台没回复,是不是 OpenClaw 没装好?
不一定。很多“已连接但不回复”其实是 pairing 未批准、群组 requireMention、生僻权限或平台侧应用设置不完整。
你是不是已经进入通道特定问题
如果问题已经明确是某个平台的 Token、Intent、事件订阅或插件能力,就该回 docs 或对应平台文档,而不是继续在概览页里兜圈子。
常见错误或风险
- 不要在第一天同时接 Telegram、Discord、飞书和群组策略;
- 不要把私聊 pairing、群组提及门控和平台权限当成同一类问题;
- 不要只看 connected 状态,真正的成功标准是首条消息闭环。
下一步
先去看 第一次接入先选哪个平台。
FAQ
第一次接入为什么通常推荐 Telegram?
因为 Telegram 的起步路径最短,通常只需要 Bot Token 就能完成第一轮验证,配对和日志信号也更直观。
Discord 和飞书适合什么时候接?
当你已经完成过至少一个简单通道,或你的真实场景本来就在 Discord 服务器、飞书团队协作里时,再接这两类平台会更自然。
通道显示已连接,但机器人不回复,先看哪里?
先按顺序检查:通道状态、pairing、群组是否需要提及、日志里有没有 allowlist、mention required、401/403 之类的信号。多数问题并不是主程序没跑起来,而是策略或平台权限没对上。