写在前面
第一次接入平台,不要把目标定成“把所有渠道都配好”,而是先跑通一条最小消息链路。
你现在要解决的是两件事:
- 先选一个最容易验证的平台;
- 让自己在失败时能快速定位问题。
如果你已经完成安装验证,这一步做完后就直接进入对应平台的接入页。
第一步:先按三个标准选平台
1. 你是否每天都在用
第一次接入最好选你本来就高频打开的平台。这样你能随时发测试消息,也更容易重复验证。
如果一个平台你平时几乎不用,哪怕它理论上也能接入,第一次也不建议优先选。
2. 平台侧准备是否简单
第一次接入时,平台侧准备越复杂,变量就越多。
你要优先考虑的是:
- 机器人或应用是否容易创建;
- Token 或凭据是否容易拿到;
- 平台是否还要求额外权限、事件订阅或复杂审核;
- 出问题时你能不能快速分清是平台侧还是 OpenClaw 侧。
3. 失败后是否容易定位
第一次最怕的不是失败,而是“看起来连上了,但不知道卡在哪”。
如果一个平台在失败时容易看清是凭据问题、权限问题,还是消息根本没进来,它就更适合作为第一条接入链路。
第二步:按实际场景做选择
如果你只是想先跑通一条最短链路,优先选 Telegram。
原因很简单:
- 私聊验证路径通常更短;
- 平台侧变量通常更少;
- 第一次更容易判断问题是在凭据、pairing,还是主进程。
如果你的真实使用场景主要在 Discord 社区或服务器里,可以直接选 Discord,但要接受它的变量更多:
- Bot 权限更细;
- 服务器、频道、私聊入口不是一回事;
- 提及规则和服务器门控更容易干扰第一次验证。
如果你主要服务中文团队协作,且后面就是要在组织环境里落地,可以选飞书,但要预留更多时间处理平台侧准备:
- 应用创建;
- 凭据和权限;
- 事件订阅;
- 平台后台设置是否真正生效。
第三步:不要同时接两个平台
第一次接入只做一个平台,不要并行。
正确做法是:
- 选一个平台;
- 完成该平台的最小接入;
- 发一条测试消息;
- 确认回复、状态和日志都正常;
- 再考虑第二个平台。
这样做的好处是,一旦失败,你知道问题只来自一条链路,而不是多个平台叠加。
怎么判断你选对了
如果你满足下面三条,就说明这次平台选择是合理的:
- 你能在 10 分钟内开始做接入,而不是一直停留在比较阶段;
- 你知道平台侧需要先准备哪些信息;
- 一旦失败,你知道该先回平台页还是先去看分诊页。
如果你还在“Telegram、Discord、飞书都想先试一下”,说明你还没有收敛变量,现在先停下来只选一个。
常见错误或风险
- 第一次就想同时接两个平台,导致问题无法定位;
- 按“以后也许会用”选平台,而不是按“现在最容易验证”选;
- 还没跑通私聊或最小入口,就先做群组、白名单和复杂路由;
- 只看平台热度,不看平台侧准备成本。
下一步
如果你决定先走 Telegram,继续看 Telegram 接入。
如果你的真实场景主要在 Discord,继续看 Discord 接入。
如果你要先在中文团队环境中落地,继续看 飞书接入。