通道配置

OpenClaw 支持多种聊天通道，你可以配置一个或多个通道同时使用。

支持的通道

通道	状态	说明
飞书	✅ 稳定	适合国内用户，企业微信风格，功能完整
Telegram	✅ 稳定	需要 Telegram Bot Token
Discord	✅ 稳定	需要 Discord Bot Token
WhatsApp	✅ 稳定	基于 whatsapp-web.js，需要扫码配对
Signal	✅ 稳定	需要注册号码
iMessage	⚠️ 实验性	需要 macOS 设备
Mattermost	社区支持	通过扩展插件安装

通用配置

所有通道都支持基本的访问控制配置：

{
  "channels": {
    "通道名称": {
      "enabled": true,
      "allowFrom": ["用户ID列表"],
      "groups": {
        "*": {
          "requireMention": true
        }
      }
    }
  }
}

配置说明：

• enabled - 是否启用该通道，默认为 true
• allowFrom - 允许哪些用户使用，留空表示允许所有
• groups."*".requireMention - 在群组中是否需要 @ 机器人才能触发

飞书配置

飞书是国内用户推荐的通道，配置步骤：

1. 创建飞书应用

1. 登录 飞书开发者后台
2. 点击「创建自定义应用」，填写应用名称
3. 创建完成后，在「凭证与基础信息」获取：
   • App ID (即 Client ID)
   • App Secret (即 Client Secret)

2. 开通机器人能力

在「能力」-「机器人」中开启机器人。

3. 配置事件订阅

1. 在「事件订阅」中，配置请求地址：

   https://你的域名:18789/v1/webhook/feishu

   如果你没有域名，可以直接使用 IP：

   https://<你的服务器IP>:18789/v1/webhook/feishu

2. 订阅以下事件：

   • im.message.receive_v1 - 接收消息

4. 发布版本

1. 在「版本管理与发布」中创建一个新版本
2. 提交发布，等待企业管理员审核通过

5. 在 OpenClaw 中配置

使用命令登录：

openclaw channels login feishu

按照提示输入 App ID 和 App Secret 完成配置。

查看已配置通道

openclaw channels list

会显示所有已配置的通道和状态。

下一步

配置完成后，就可以启动网关开始使用了。