10. 连接聊天渠道（上）：Telegram 与 Discord

渠道是什么

渠道（Channel）就是你和 OpenClaw 说话的”入口”。前面接好了模型（大脑），现在要把”嘴和耳朵”接上。

OpenClaw 支持一大票渠道：飞书、Telegram、Discord、WhatsApp、Slack、Signal、iMessage、Google Chat、Matrix、个人微信（插件）等。它们底层不同，但接入套路高度一致。

四步通用套路

不管接哪个渠道，基本都走这四步：

1. 在渠道方建应用。去人家开发者后台，创建一个机器人/应用，拿到一串凭证（通常是 token）。
2. 写进 OpenClaw 配置。把 token 填到 channels.<渠道名> 下面。
3. 做配对授权。很多渠道首次联系人要”配对”，防止陌生人随便使唤你的 AI。
4. 验证连通。用命令确认状态是 connected。

常用管理命令

这几个命令对所有渠道通用：

# 看支持哪些渠道、各自要求
openclaw channels capabilities

# 列出已配置的渠道
openclaw channels list

# 添加渠道（部分渠道支持）
openclaw channels add --channel telegram --token <BOT_TOKEN>

# 看某个渠道连没连上
openclaw channels status

# 看渠道日志，排错用
openclaw channels logs --channel all

万一消息没送达、又查不到原因，OpenClaw 会把它放进”死信”（dead-letters）暂存，方便你事后翻。

例子一：Telegram

Telegram 是海外用户最常用的远程遥控器。

第一步，找 BotFather 建机器人。 在 Telegram 里给 @BotFather 发 /newbot，按提示取名字，最后它会给你一串 botToken。这串就是凭证。

第二步，写进配置：

{
  "channels": {
    "telegram": {
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing"
    }
  }
}

dmPolicy: "pairing" 表示私聊要先配对。这是安全习惯——不是谁都能拿你的机器人下指令。

第三步，做配对。 机器人会回你一个配对码。在终端批准它：

# 看有哪些待批准的配对
openclaw pairing list telegram

# 用机器人给的码批准
openclaw pairing approve telegram <配对码>

群组里的要点。 Telegram 群里，建议设”必须 @ 才响应”，避免机器人对每句话都抢答：

{
  "channels": {
    "telegram": {
      "groups": {
        "*": { "requireMention": true }
      }
    }
  }
}

Telegram 默认用长轮询收消息，一般不用额外配 webhook。

例子二：Discord

Discord 适合开发者和社群，常驻在服务器频道里。

第一步，开发者门户建应用和机器人。 到 Discord 开发者平台创建应用，在”Bot”里加一个机器人，复制它的 token。

第二步，开启特权 Intent。 这是 Discord 的坑点。机器人要收消息，得在开发者门户打开几个开关：

• MESSAGE CONTENT INTENT：让机器人看得到消息内容。
• SERVER MEMBERS INTENT：让机器人认得成员。
• PRESENCE INTENT：在线状态（按需）。

不开这些，机器人要么收不到消息，要么认不出人。

第三步，邀请机器人进服务器。 生成邀请链接时，scope 选 bot，权限勾上”发消息、读消息历史”等。把链接发给自己的服务器管理员身份打开即可。

第四步，写进配置。 Discord 的 token 建议用 SecretRef（密钥引用）而非明文：

{
  "channels": {
    "discord": {
      "token": "${DISCORD_BOT_TOKEN}"
    }
  }
}

取 ID 的小技巧。 想按服务器、按频道做路由，得拿到它们的 ID。Discord 设置里打开”开发者模式”，右键服务器或频道就能”复制 ID”。

配对机制是通用的

“先配对再说话”这套，不只在 Telegram。凡涉及私聊授权，思路都一样：pairing list 看待批，pairing approve 放行。这是 OpenClaw 防陌生人滥用的一道闸。

接完怎么验收

openclaw channels status
openclaw gateway status

对应渠道显示 connected，去聊天窗口发一句测试，AI 回你了，就通了。