三、消息渠道配置

3.1 渠道概览

OpenClaw 可以在你已经使用的任意聊天应用中与你交流。每个渠道都通过 Gateway 网关连接。

所有渠道都支持文本；媒体和 reactions 支持则因渠道而异。

渠道可以同时运行

你可以配置多个渠道，OpenClaw 会按聊天进行路由。

最快上手渠道

3.2 支持的渠道完整列表

内置渠道

内置插件渠道

可选单独安装渠道插件

3.3 WhatsApp 配置（最流行）

基本配置

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+15555550123"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

配对流程

1. 启动 Gateway 后，WhatsApp 渠道会显示二维码
2. 用手机 WhatsApp 扫描二维码
3. 配对成功后即可收发消息

群组管理

• 群组行为因渠道而异
• 通过 requireMention 控制是否需要 @提及
• 配置 mentionPatterns 设置触发关键词

3.4 Telegram 配置（最简单）

创建 Bot

1. 在 Telegram 中找 @BotFather
2. 发送 /newbot 创建新 Bot
3. 获取 Bot Token

配置

{
  "channels": {
    "telegram": {
      "token": "YOUR_BOT_TOKEN"
    }
  }
}

群组支持

Telegram 天然支持群组，将 Bot 添加到群组即可。

3.5 Feishu（飞书）配置

创建应用

1. 在飞书开放平台创建应用
2. 获取 App ID 和 App Secret
3. 配置事件订阅

配置

{
  "channels": {
    "feishu": {
      "appId": "YOUR_APP_ID",
      "appSecret": "YOUR_APP_SECRET"
    }
  }
}

3.6 Discord 配置

创建 Bot 应用

1. 访问 https://discord.com/developers/applications (opens in a new tab)
2. 创建新应用
3. 创建 Bot 并获取 Token
4. 邀请 Bot 到服务器

配置

{
  "channels": {
    "discord": {
      "token": "YOUR_DISCORD_BOT_TOKEN"
    }
  }
}

3.7 群组消息配置

全局群组配置

{
  "messages": {
    "groupChat": {
      "mentionPatterns": ["@openclaw"]
    }
  }
}

渠道路由

• 渠道可以同时运行
• OpenClaw 会按聊天进行路由
• 群组彼此隔离，私聊可合并

3.8 渠道故障排除

常见问题

诊断命令

# 检查所有渠道状态
openclaw channels status --probe
 
# 查看 Gateway 日志
openclaw logs --follow
 
# 运行 Doctor 检查
openclaw doctor