Channel 总览
OpenClaw 通过 Channel 连接通讯平台。你在 Telegram 发消息,Agent 在 Telegram 回复。可以同时开多个 Channel。
选择 Channel
推荐新手
| Channel | 接入方式 | 耗时 | 推荐理由 |
|---|---|---|---|
| Telegram | Bot Token | 2 min | 最快,配置最简单 |
| Discord | Bot Token | 5 min | 功能丰富,社区场景好 |
| QR 配对 | 5 min | 用户量大,但需手机在线 |
企业场景
| Channel | 接入方式 | 说明 |
|---|---|---|
| Slack | Bolt SDK App | 工作区应用 |
| 飞书 | WebSocket Bot (插件) | 需安装 Feishu 插件 |
| MS Teams | Bot Framework (插件) | 企业级 |
| Google Chat | HTTP Webhook | 功能较基础 |
自托管
| Channel | 协议 | 说明 |
|---|---|---|
| Signal | signal-cli | 隐私优先,需本地安装 CLI |
| Matrix | Matrix 协议 (插件) | 去中心化 |
| Mattermost | Bot API (插件) | 开源 Slack 替代 |
其他
IRC · iMessage (BlueBubbles) · LINE · Zalo · Nostr · Twitch · Nextcloud Talk · Synology Chat · Tlon
接入方式对比
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,除非你清楚风险。推荐用 pairing 或 allowlist。
多 Channel 并行
OpenClaw 原生支持多 Channel 同时运行:
json5
{
channels: {
telegram: { enabled: true, botToken: "xxx" },
discord: { enabled: true, botToken: "yyy" },
whatsapp: { enabled: true },
}
}消息路由是自动的:从哪个 Channel 来,就从哪个 Channel 回。