写在前面
安装完成并不等于真正能用。对大多数人来说,OpenClaw 真正开始产生价值,是在它接入第一个聊天平台之后。
这一步只做一件事:先接通一个平台,并完成一次最小消息验证。
第一步:只选一个你自己高频使用的平台
第一次接入口,不要同时铺 Telegram、Discord、Slack 等多个平台。
更稳妥的选择标准是:
- 你本来就每天会打开;
- 该平台创建机器人或应用的流程比较清楚;
- 接通后你能立刻发一条消息验证。
如果只是为了先跑通链路,优先选你最熟的平台,而不是“以后可能要用的平台”。
第二步:先在平台侧把信息准备完整
不管你选哪个平台,先把下面几类信息准备好,再进入 OpenClaw 配置:
- 机器人或应用身份;
- Token、密钥或平台授权信息;
- webhook、回调地址或消息入口;
- 平台要求的基础权限。
如果这些信息还没拿全,后面即使填了配置,也很难判断问题到底出在 OpenClaw 还是平台侧。
第三步:用向导或命令添加渠道
如果你想重新走一遍交互式配置,可以运行:
openclaw configure如果你已经知道自己要接哪个平台,也可以直接用渠道命令添加。
Telegram
openclaw channels add \
--channel telegram \
--account alerts \
--name "Alerts Bot" \
--token $TELEGRAM_BOT_TOKENDiscord
openclaw channels add \
--channel discord \
--account work \
--name "Work Bot" \
--token $DISCORD_BOT_TOKEN添加完成后,先不要急着做复杂任务,先检查渠道状态:
openclaw channels status
openclaw channels status --probe判断标准:
- 渠道已经出现在状态列表中;
--probe没有直接给出认证失败、配置缺失或连接错误;- Gateway 日志中没有持续性的渠道报错。
第四步:发一条最小测试消息
渠道加好后,立刻从对应平台发一条最简单的测试消息,例如:
你好帮我复述这句话现在你能正常收到消息吗
这一步不是为了测试模型聪不聪明,而是为了确认链路已经跑通。
你要同时看两边:
- 平台侧是否真的收到了回复;
- OpenClaw 侧日志是否正确记录了这次消息处理。
建议同时开一个日志窗口:
openclaw logs --follow第五步:如果收不到回复,按这个顺序排查
1. 先看渠道状态
openclaw channels status --probe如果这里已经报认证或连接问题,就先修平台配置,不要继续猜模型或技能问题。
2. 再看渠道日志
openclaw channels logs --channel telegram --limit 200如果你接的是 Discord,就把 telegram 换成 discord。
3. 再看 Gateway 总日志
openclaw logs --limit 100重点排查:
- Token 是否填错;
- webhook 或回调设置是否缺失;
- 权限是否不足;
- Gateway 是否根本没收到平台事件。
常见错误或风险
- 不要一开始就接多个平台,否则很难定位问题;
- 不要只看平台侧成功提示,要同时看 OpenClaw 的渠道状态和日志;
- 不要把“平台连上了”误判成“整条消息处理链路已经没问题”;
- 如果平台消息都还没跑通,就不要继续测试复杂任务。
下一步
平台接通后,继续看 命令行与基础配置。