Skip to content

Channel 总览

OpenClaw 通过 Channel 连接通讯平台。你在 Telegram 发消息,Agent 在 Telegram 回复。可以同时开多个 Channel。

选择 Channel

推荐新手

Channel接入方式耗时推荐理由
TelegramBot Token2 min最快,配置最简单
DiscordBot Token5 min功能丰富,社区场景好
WhatsAppQR 配对5 min用户量大,但需手机在线

企业场景

Channel接入方式说明
SlackBolt SDK App工作区应用
飞书WebSocket Bot (插件)需安装 Feishu 插件
MS TeamsBot Framework (插件)企业级
Google ChatHTTP Webhook功能较基础

自托管

Channel协议说明
Signalsignal-cli隐私优先,需本地安装 CLI
MatrixMatrix 协议 (插件)去中心化
MattermostBot API (插件)开源 Slack 替代

其他

IRC · iMessage (BlueBubbles) · LINE · Zalo · Nostr · Twitch · Nextcloud Talk · Synology Chat · Tlon

查看所有 Channel

接入方式对比

Bot 接入(Telegram / Discord / Slack)

  • 长连接,实时双向通信
  • 支持完整交互:按钮、反应、富文本、嵌入
  • 通过平台官方 Bot API 认证
  • 最稳定,推荐优先使用

Webhook 接入(Google Chat / Synology / Nextcloud)

  • HTTP 回调,请求-响应模式
  • 功能受限:通常只有文本,无反应/按钮
  • 需要配置回调 URL(可能需要公网地址或内网穿透)

QR 配对(WhatsApp / Zalo Personal)

  • 模拟客户端行为
  • 功能最全(和真人用的一样)
  • 稳定性依赖第三方库(WhatsApp 用 Baileys)
  • 手机端需保持在线

CLI 桥接(Signal / iMessage legacy)

  • 通过本地命令行工具通信
  • 需要在同一台机器上安装 CLI
  • 隐私性好,但配置步骤多

通用配置模式

所有 Channel 共享 DM 策略配置:

json5
{
  channels: {
    "<channel>": {
      enabled: true,
      dmPolicy: "pairing",     // pairing | allowlist | open | disabled
      allowFrom: ["id:xxx"],   // allowlist 模式的白名单
    }
  }
}
策略行为
pairing (默认)陌生人发消息时需确认配对码
allowlist只允许白名单中的用户
open允许所有人(需设 allowFrom: ["*"]
disabled忽略所有 DM

WARNING

生产环境不要用 open,除非你清楚风险。推荐用 pairingallowlist

多 Channel 并行

OpenClaw 原生支持多 Channel 同时运行:

json5
{
  channels: {
    telegram: { enabled: true, botToken: "xxx" },
    discord: { enabled: true, botToken: "yyy" },
    whatsapp: { enabled: true },
  }
}

消息路由是自动的:从哪个 Channel 来,就从哪个 Channel 回。

基于 OpenClaw 开源项目