<style>.toc-chapters{max-height:none!important}.copy-btn,#sidebar-toggle,#fullscreen-toggle{display:none!important}@media(max-width:768px){.tutorial-app{display:flex;height:auto;overflow:visible;flex-direction:column}.tutorial-main{order:0;overflow:visible}.tutorial-content{overflow:visible}.tutorial-sidebar{order:1;position:static!important;width:100%!important;min-width:0!important;max-height:none!important;display:flex!important;transform:none!important}.sidebar-toc{overflow:visible}}</style>

第 16 章:其他通道 🌐

适合人群:想解锁更多聊天平台的你 本章目标:了解飞书、iMessage、Signal、Slack、Google Chat、Matrix 的配置方法,学会多 Bot 多 Agent 配置


前几章我们详细讲了 Telegram、WhatsApp、Discord 这三个最流行的通道。但 OpenClaw 的能力远不止于此——它支持的通道覆盖了几乎所有主流的聊天平台。

💡 这些通道的配置思路和 Telegram/Discord 非常相似:拿到 Token/凭证 → 配置到 OpenClaw → 重启 Gateway → 配对 → 开始聊天。只是每个平台获取凭证的方式不同。


16.1 飞书(Feishu / Lark)

飞书是字节跳动出品的企业协作平台,在国内(飞书)和海外(Lark)都有大量用户。OpenClaw 对飞书有内置的原生支持

配置步骤

第一步:创建飞书应用

登录 飞书开放平台,创建一个企业自建应用

[截图:飞书开放平台「创建应用」页面]

第二步:添加 Bot 能力

在应用详情页 → 「应用功能」「机器人」,开启 Bot 能力。这时你会拿到:

  • App ID:应用唯一标识
  • App Secret:应用密钥(相当于密码,勿泄露)

第三步:配置权限

「权限管理」 中添加 Bot 需要的权限:

  • im:message —— 收发消息
  • im:resource —— 下载图片/文件
  • contact:user.base —— 读取用户基本信息

可以用开放平台提供的批量导入功能一键添加。

第四步:配置 OpenClaw

{
  channels: {
    feishu: {
      appId: "cli_xxxxxxxxxxxxxx",
      appSecret: "xxxxxxxxxxxxxxxxxxxxxxxx",
      agent: "default",
    },
  },
}

或者用命令行:

openclaw config set channels.feishu.appId "cli_xxxxxxxxxxxxxx"
openclaw config set channels.feishu.appSecret "xxxxxxxxxxxxxxxxxxxxxxxx"

第五步:配置事件订阅

在飞书开放平台 → 「事件与回调」,添加事件订阅:

  • im.message.receive_v1 —— 接收消息事件

连接方式选择 WebSocket(WebSocket 不需要公网 IP,由 Gateway 主动连飞书服务器),或者在 「机器人」 设置中一键订阅。

⚠️ 顺序很重要! 必须先启动 Gateway,再在飞书后台开启事件订阅。否则飞书验证 WebSocket 连接时会失败。

第六步:审批和发布

在「版本管理与发布」中创建版本,提交审核,然后发布上线

使用

在企业飞书里搜索你的 Bot 名称,打开对话,开始聊天!

飞书 Bot 支持:

  • 私聊:首次对话需要配对:openclaw pairing approve feishu <代码>
  • 群组:@Bot 可唤醒,支持文字、图片、文件
  • 文档处理:飞书文档链接 Bot 可以直接读取内容(需要额外配置)

[截图:飞书中跟 Bot 聊天]

💡 两个版本:OpenClaw 内置的飞书插件与 Lark 官方插件功能不同。内置插件专注于 Bot 身份,Lark 官方插件使用 OAuth 用户身份(可创建文档、管理日历)。两者不能同时运行,按需选择。


16.2 iMessage 🍎

iMessage 是 Apple 生态的聊天工具。由于 Apple 没有提供公开的 Bot API,所以 iMessage 通道需要一些"特殊技巧"。

前提条件

  • 一台 Mac(必须是物理 Mac,黑苹果可能也行,但虚拟机不行)
  • iCloud 账号已登录,且 iMessage 已激活
  • Node.js 已安装

方案一:imsg 桥接

OpenClaw 通过一个叫 imsg 的桥接工具,在 Mac 上监听并回复 iMessage 消息。

# 安装 imsg 桥接
clawhub install imsg-bridge

# 启动桥接
openclaw channel connect imsg

配置 OpenClaw:

{
  channels: {
    imsg: {
      enabled: true,
      // iMessage 的号码(可选,用于多卡情况)
      phoneNumber: "+86-138****1234",
    },
  },
}

方案二:Claw Messenger

如果不想折腾 Mac 桥接,可以用第三方服务 Claw Messenger,它会帮你托管 iMessage Bot。

openclaw config set channels.imessage.apiKey "你的-Claw-Messenger-API-Key"
openclaw config set channels.imessage.enabled true
openclaw gateway restart

使用

在 iMessage 中给你的 Mac 本机号码发消息,Agent 会自动回复。不支持群组(Apple 的群组 iMessage 协议对 Bot 不友好)。

⚠️ 注意:iMessage 方案本质上是"你的 Mac 在回复消息"。所以:

  • Mac 必须一直开机并联网
  • 收到的回复会显示在你的 iMessage 对话里(和你正常的聊天混在一起)
  • 建议用 Apple ID 的小号,或接受"跟自己的对话"里出现 AI 回复

16.3 Signal 🔒

Signal 以端到端加密和隐私保护闻名。OpenClaw 通过 signal-cli 这个开源工具支持 Signal 通道。

安装 signal-cli

# macOS
brew install signal-cli

# Linux
# 去 https://github.com/AsamK/signal-cli 参考安装

注册 Signal 号码

# 注册(会发送验证码)
signal-cli -u +8613812341234 register

# 验证注册
signal-cli -u +8613812341234 verify 123456

配置 OpenClaw

{
  channels: {
    signal: {
      phoneNumber: "+8613812341234",
      signalCliPath: "/usr/local/bin/signal-cli",  // signal-cli 路径
      agent: "default",
    },
  },
}

注意事项

  • ⚠️ Signal 不鼓励 Bot 行为,可能封号
  • signal-cli 需要一直跑在后台
  • 不支持官方 Bot API(Signal 官方没做)
  • 适合小范围使用,不推荐大规模部署

16.4 Slack 💼

Slack 是"打工人的工作聊天软件"。OpenClaw 的 Slack 集成用 Socket Mode(推荐)或 HTTP Events API。

创建 Slack App

  1. 访问 api.slack.comCreate New App
  2. 选择 From Manifest,可以用 OpenClaw 社区提供的 manifest 模板
  3. 或选择 From Scratch

启用 Socket Mode

在 App 配置页 → Socket Mode → 开启。

Socket Mode 的好处是不需要公网 HTTP 端点,OpenClaw 直接通过 WebSocket 连 Slack,安全且简单。

配置 Bot Token Scopes

OAuth & PermissionsScopes 添加:

Scope 作用
app_mentions:read 读取 @Bot 的消息
chat:write 发送消息
channels:history 读取公开频道历史
groups:history 读取私密频道历史
im:history 读取私信历史
im:write 回复私信

安装到工作空间

Install App to Workspace → 授权。

你会拿到两个 Token:

  • Bot Tokenxoxb-...
  • App-Level Tokenxapp-...,Socket Mode 用)

配置 OpenClaw

{
  channels: {
    slack: {
      botToken: "xoxb-xxxxxxxxxxxx",
      appToken: "xapp-xxxxxxxxxxxx",
      agent: "default",
    },
  },
}
openclaw gateway restart

使用

在 Slack 中 @Bot 就能跟它聊天。

[截图:Slack 中 @Bot 对话]

Slack 的 channelPolicy 同样支持 openallowlistdisabled 三种模式。


16.5 Google Chat ☁️

Google Chat 是 Google Workspace 的一部分。OpenClaw 通过 Google Cloud 项目 + 服务账号集成。

前置条件

  • 一个 Google Cloud 项目
  • Google Chat API 已启用
  • 一个公开可达的 HTTPS 端点(可用 Cloudflare Tunnel 或 Nginx 反代)

创建 Google Chat 应用

  1. 在 Google Cloud Console → APIs & ServicesEnabled APIs & services
  2. 启用 Google Chat API
  3. 在 Chat API 配置页面,创建 App

创建服务账号

  1. IAM & AdminService Accounts → 创建服务账号(如 openclaw-chat
  2. 下载 JSON 密钥文件

配置 OpenClaw

{
  channels: {
    googlechat: {
      serviceAccountKeyPath: "/path/to/service-account-key.json",
      webhookPath: "/googlechat",            // Webhook URL 路径
      webhookPassword: "你的密码",            // 防止未授权请求
      agent: "default",
    },
  },
}

使用

在 Google Chat 中搜索你的 Bot 名称,开始对话。首次需要配对。

Google Chat 通道的优点:

  • Google Workspace 用户天然可使用
  • 企业级安全性
  • 支持私聊和群组 @

16.6 Matrix 🧩

Matrix 是一个开源的去中心化即时通信协议。如果你是开源爱好者或在乎数据主权,Matrix 是最合适的选择。

安装 Matrix 插件

clawhub install matrix

配置 OpenClaw

{
  channels: {
    matrix: {
      homeserverUrl: "https://matrix.org",      // 你的 Matrix 服务器
      userId: "@mybot:matrix.org",               // Bot 账号
      accessToken: "syt_xxxxx",                  // Matrix Access Token
      agent: "default",
    },
  },
}

使用

配置完成后,Bot 会自动加入你邀请它的房间,支持:

  • 私聊(DM)
  • 公开房间(Public Rooms)
  • 私密房间(Private Rooms)
  • 线程(Threads)
  • 端到端加密(E2EE)
  • 多媒体消息

[截图:Matrix 客户端中跟 Bot 对话]

Matrix 的去中心化特性意味着你可以运行自己的 Matrix 服务器,数据完全由你控制,不用担心被某个平台限制。


16.7 多 Bot 多 Agent 配置

现在你已经知道了 OpenClaw 支持多少个通道。但更酷的是——你可以同时跑多个通道,一个 Bot 绑一个 Agent,互相独立。

同时启用多个通道

openclaw.json 中配置多个通道:

{
  channels: {
    telegram: {
      botToken: "xxx",
      agent: "assistant-a",     // 绑定到 Agent A
    },
    discord: {
      botToken: "yyy",
      agent: "coder-bot",       // 绑定到 Agent B
    },
    whatsapp: {
      enabled: true,
      agent: "default",         // 绑定到默认 Agent
    },
    slack: {
      botToken: "xoxb-zzz",
      agent: "assistant-a",     // 也可绑定到 Agent A
    },
  },
}

[截图:终端中 openclaw gateway status 显示多个通道都在线]

多 Bot 同通道

有些通道支持多个 Bot 实例

{
  channels: {
    telegram: [
      {
        botToken: "xxx",
        agent: "agent-alpha",
      },
      {
        botToken: "yyy",
        agent: "agent-beta",
      },
    ],
  },
}

这样你在 Telegram 里就有两个 Bot 了:

  • @alpha_bot → Agent Alpha(负责日常工作)
  • @beta_bot → Agent Beta(负责写代码)

一个 Bot 多个 Agent?

目前不行。 每条消息只能路由到一个 Agent。如果你想实现"根据内容分配不同 Agent"的效果,可以:

  1. 建一个"调度 Agent",让它收到消息后调用其他 Agent(通过 run_agent 工具)
  2. 或者使用多个 Bot,每个 Bot 绑不同的 Agent

推荐配置

当当老师自己的配置供参考:

通道 Agent 用途
Telegram(私聊) Default 日常助理、查天气、问问题
Discord(群组) Coder-Bot 团队开发群里写代码、查文档
Slack(公司) Work-Bot 查日历、管任务、邮件
WhatsApp(家人群) Family-Bot 帮家人查信息、设置提醒

通道对比总表

通道 Bot API 离线消息 群组 媒体 文件 远程 Bot 推荐场景
Telegram ✅ 官方 首选、通用
WhatsApp ❌ 无官方 家庭、海外
Discord ✅ 官方 社区、开发
飞书 ✅ 官方 国内企业
iMessage ❌ 无 Apple 用户
Signal ❌ 无 隐私优先
Slack ✅ 官方 企业工作
Google Chat ✅ 官方 GWS 用户
Matrix ✅ 官方 开源、自托管

标记说明:✅ = 原生支持 / ❌ = 不支持或需额外工作


通道选择建议

  • 个人首选 → Telegram(免费、开放、功能最全)
  • 国内企业 → 飞书(字节生态、文档能力强)
  • 海外家庭 → WhatsApp(装微信的外国亲戚也能用!)
  • 技术社区 → Discord(频道管理、富文本)
  • 工作团队 → Slack(企业协作标准)
  • 隐私控 → Matrix 或 Signal
  • Apple 生态 → iMessage(全家桶体验)
  • Google 全家桶 → Google Chat

本章小结

每个通道的配置流程大同小异:

  1. 获取凭证——Token、App ID、密钥等在对应平台创建应用
  2. 配置权限——开启消息读取、发送等必要权限
  3. 填入配置——写入 openclaw.json
  4. 重启 Gateway——openclaw gateway restart
  5. 配对——首个用户或群组需要批准
  6. 开始聊——在你的聊天软件中 @Bot 或私信

看到这里,你已经掌握了 OpenClaw 所有主流通道的配置方法。你可以:

  • 在手机(Telegram/WhatsApp)上随时随地召唤 AI
  • 在群组(Discord/Slack)中跟同事共享一个 AI 助手
  • 在企业(飞书/Google Chat)中用 AI 处理工作流
  • 甚至同时在多个平台拥有多个不同角色的 AI 助手

下一章,我们将进入第四部分「高级玩法」,从 WebChat 控制面板开始,解锁 OpenClaw 的更高级能力!


系统教程,帮你把工具用好,再回到任务中。 浏览任务方案 →