第 5 章 · 免费

💬 消息渠道配置

OpenClaw 支持多种聊天渠道,一个 Gateway 可以同时连接多个渠道。

Telegram 机器人接入(详细步骤)🌟

Telegram 是最推荐的渠道,配置简单且功能完整。

第一步:创建 Telegram Bot

  1. 打开 Telegram,搜索 @BotFather(注意验证蓝色勾)
  2. 发送 /newbot
  3. 按提示输入机器人名称(如 My OpenClaw Bot
  4. 输入用户名(必须以 bot 结尾,如 my_openclaw_bot
  5. 复制 Bot Token(形如 123456789:ABCdefGHIjklMNO
💡 提示: 可选设置(在 @BotFather 中):
- /setprivacy → Disable(让 Bot 能看到群聊所有消息)
- /setjoingroups → Enable(允许添加到群组)

第二步:配置 OpenClaw

// ~/.openclaw/openclaw.json
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "123456789:ABCdefGHIjklMNO",
      dmPolicy: "pairing",  // 首次聊天需要配对码
      groups: {
        "*": { requireMention: true },  // 群组中需要 @机器人
      },
    },
  },
}

或者用环境变量:

echo "TELEGRAM_BOT_TOKEN=123456789:ABCdefGHIjklMNO" >> ~/.openclaw/.env

第三步:重启 Gateway 并配对

openclaw gateway restart

然后在 Telegram 中给你的 Bot 发消息,会收到一个配对码。用命令批准:

# 查看待配对列表
openclaw pairing list telegram

# 批准配对
openclaw pairing approve telegram <配对码>

⚠️ Telegram 常见问题

问题解决方案
Bot 不回复检查 Token 是否正确,Gateway 是否运行
群里不回复需要 @机器人 或关闭 Privacy Mode
国内连不上配置代理 proxy: "socks5://127.0.0.1:7890"
IPv6 问题在配置中加 network: { autoSelectFamily: false }

Telegram 进阶配置

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "xxx",
      dmPolicy: "pairing",
      allowFrom: ["tg:你的用户ID"],   // 指定允许的用户
      groups: {
        "*": { requireMention: true },
        "-1001234567890": {             // 特定群组配置
          requireMention: false,         // 不需要@就回复
          allowFrom: ["@admin"],
        },
      },
      streamMode: "partial",            // 流式输出(打字效果)
      proxy: "socks5://127.0.0.1:7890", // 代理(国内需要)
      replyToMode: "first",             // 回复模式
    },
  },
}
💡 提示: 获取你的 Telegram 用户 ID:给 Bot 发消息后运行 openclaw logs --follow,在日志中找 from.id

飞书机器人接入

第一步:创建飞书应用

  1. 登录 飞书开放平台
  2. 创建企业自建应用
  3. 添加「机器人」能力
  4. 配置权限:im:messageim:message.group_at_msgim:chat
  5. 发布应用

第二步:配置事件订阅

⚠️ 这一步很容易遗漏!

  1. 在应用管理中找到「事件订阅」
  2. 设置请求地址:http://你的服务器IP:18789/feishu
  3. 添加事件:im.message.receive_v1

第三步:配置 OpenClaw

{
  channels: {
    feishu: {
      enabled: true,
      appId: "cli_xxxx",
      appSecret: "xxxx",
      verificationToken: "xxxx",    // 事件订阅验证token
      encryptKey: "xxxx",           // 加密密钥(可选)
    },
  },
}
📖 参考: 详细教程参考:保姆级飞书对接教程

钉钉接入

配置步骤

  1. 登录 钉钉开放平台
  2. 创建应用,添加机器人
  3. 配置事件回调地址

阿里云用户可直接使用预置镜像,内置钉钉对接功能。

Discord 接入

第一步:创建 Discord Bot

  1. 登录 Discord Developer Portal
  2. New Application → 创建应用
  3. Bot → Add Bot → 复制 Token
  4. 开启 MESSAGE CONTENT INTENT
  5. 生成邀请链接,将 Bot 添加到服务器

第二步:配置

{
  channels: {
    discord: {
      enabled: true,
      token: "你的Discord Bot Token",
      dm: {
        enabled: true,
        policy: "pairing",
      },
      guilds: {
        "服务器ID": {
          channels: {
            general: { allow: true },
          },
        },
      },
    },
  },
}

WhatsApp 接入

WhatsApp 使用扫码方式连接:

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+86你的手机号"],
    },
  },
}

启动后会在终端显示二维码,用 WhatsApp 扫码绑定。

⚠️ WhatsApp 注意事项:

  • 需要一个独立手机号(不建议用主号)
  • 国内使用需要代理
  • 存在封号风险,谨慎使用

微信

⚠️ OpenClaw 不直接支持微信。微信对第三方 Bot 有严格限制,强行接入有封号风险。

社区方案:通过 WeCom(企业微信)或第三方桥接工具间接接入,但不推荐

多渠道同时使用

OpenClaw 的强大之处在于一个 Gateway 可以同时连接多个渠道:

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "xxx",
    },
    discord: {
      enabled: true,
      token: "xxx",
    },
    whatsapp: {
      allowFrom: ["+86xxx"],
    },
  },
}

所有渠道共享同一个 Agent 和记忆系统,在 Telegram 上聊的内容,Agent 在 Discord 上也记得 ✨

下一步 → 模型配置进阶

💡 学完这章想实战?加入社群获得 $50 算力额度 + 实时答疑

加入社群 ¥49

加入 Claw101 社区

解锁第 7-13 章、持续更新资源和实战交流,扫码即可加入社区。

Claw101 社区二维码

长按识别二维码,支付后自动弹出群二维码