一、全平台能力一览：25 + 渠道无缝打通
OpenClaw 原生支持25 余款主流聊天应用，单网关可同时挂载多个渠道并行运行，各平台消息相互隔离、互不干扰，一站式搭建跨平台智能机器人。
全渠道分类速览
表格
| 分类 | 支持平台 |
|---|---|
| 国际主流社交 | WhatsApp、Telegram、Discord、Slack、Signal、iMessage |
| 国内常用工具 | 微信、QQ、飞书 |
| 企业办公协作 | Google Chat、Microsoft Teams、Matrix |
| 亚太地区平台 | LINE、KakaoTalk |
| 小众 / 自研渠道 | IRC、XMPP、Nostr、WebChat（浏览器端） |
快速查询完整渠道列表：
bash
运行
openclaw channels list
二、新手首选：5 分钟快速搭建 Telegram 机器人
Telegram 配置最简单，仅需一枚 Bot Token，零基础也能快速上手，推荐作为入门第一个渠道。
步骤 1：创建 Telegram 机器人并获取 Token
- 打开 Telegram，搜索官方账号
@BotFather发起对话 - 发送指令
/newbot，按照提示填写机器人名称、账号 - 创建完成后，BotFather 会返回格式如
123456789:ABCdefGHIjklMNOpqrsTUVwxyz的 Bot Token，完整复制保存
步骤 2：两种方式配置 Token
方式 1：临时环境变量（重启失效，适合测试）
bash
运行
export TELEGRAM_BOT_TOKEN="你的Bot Token"
方式 2：写入配置文件（永久生效，推荐）
编辑全局配置 ~/.openclaw/openclaw.json：
json
{
"channels": {
"telegram": {
"botToken": "你的Bot Token"
}
}
}
步骤 3：启动网关并测试
bash
运行
openclaw gateway run
启动后搜索你的机器人账号，发送消息即可收到智能体回复。
三、WhatsApp 扫码直连：仿网页版登录
WhatsApp 采用二维码扫码配对，逻辑和 WhatsApp Web 一致，无需复杂密钥。
1. 发起连接
执行命令，终端自动生成登录二维码：
bash
运行
openclaw channels login --channel whatsapp
使用手机 WhatsApp 扫描二维码，即可完成绑定。
2. 白名单管控：限制指定联系人对话
默认所有联系人都可触发回复，可配置号码白名单，仅允许指定手机号交互：
json
{
"channels": {
"whatsapp": {
"allowFrom": [
"+8613800138000",
"+8613900139000"
]
}
}
}
重要提醒：绑定后手机需保持在线，长时间离线会导致连接断开，需重新扫码。
四、Discord 社群机器人搭建
适合海外社群、兴趣群组使用，需在开发者平台创建应用并配置权限。
步骤 1：创建 Discord Bot
- 访问 Discord 开发者后台，点击
New Application创建应用 - 切换至
Bot栏目，点击Add Bot创建机器人，复制生成的 Bot Token - 进入
OAuth2 > URL Generator，勾选bot权限，生成邀请链接 - 打开邀请链接，将机器人添加至你的服务器
步骤 2：接入 OpenClaw
修改配置文件，填入 Token、服务器 ID、频道 ID：
json
{
"channels": {
"discord": {
"botToken": "你的Discord Bot Token",
"guild": "服务器ID",
"channel": "频道ID"
}
}
}
步骤 3：重启网关测试
bash
运行
openclaw gateway restart
在频道内 @机器人名称 + 内容 即可发起对话。
五、微信接入：实现私聊智能回复
依托 iLink Bot 插件实现微信对接，目前仅支持一对一私聊，暂不兼容群聊。
连接流程
- 提前安装 iLink Bot 依赖插件
- 启动网关，终端自动弹出微信登录二维码
bash
运行
openclaw gateway run
- 手机微信扫码完成登录，即可正常接收、回复私聊消息
风控注意事项
- 登录状态存在有效期，掉线后需重新扫码
- 请勿高频批量自动回复，极易触发微信风控，建议合理控制回复频次
六、QQ 机器人：兼容私聊 + 群聊双模式
对接 QQ 官方开放平台，同时支持个人私聊、QQ 群聊场景。
步骤 1：申请官方机器人
前往 QQ 开放平台 注册账号，创建机器人应用，获取 AppID 和 Token。
步骤 2：基础配置（仅私聊）
json
{
"channels": {
"qq": {
"appId": "你的AppID",
"token": "你的Token"
}
}
}
步骤 3：群聊白名单配置
如需在指定群聊启用机器人，添加群号白名单：
json
{
"channels": {
"qq": {
"appId": "你的AppID",
"token": "你的Token",
"allowGroups": ["群号1", "群号2"]
}
}
}
步骤 4：生效配置
bash
运行
openclaw gateway restart
七、飞书机器人：企业内部办公首选
基于 WebSocket 协议接入，适配企业飞书环境，支持私聊、企业群聊。
步骤 1：创建飞书自建应用
- 登录 飞书开放平台，创建企业自建应用
- 开启机器人能力，获取
App ID、App Secret - 事件订阅选择 WebSocket 模式
步骤 2：写入配置文件
json
{
"channels": {
"feishu": {
"appId": "你的App ID",
"appSecret": "你的App Secret"
}
}
}
步骤 3：重启网关
bash
运行
openclaw gateway restart
使用规则：群聊中需要
@机器人才会触发回复。
八、群组通用规则：群聊场景专属配置
Discord、QQ、飞书、Telegram 等群组场景，统一遵循以下规则，避免全局刷屏。
1. 触发规则（默认仅 @回复）
- Discord / QQ / 飞书：
@机器人 问题内容 - Telegram 群聊：发送
/start或@机器人账号 内容
2. 群组白名单
限制机器人仅在指定群组生效，示例（以 Discord 为例）：
json
{
"channels": {
"discord": {
"allowGroups": ["频道ID1", "频道ID2"]
}
}
}
3. 群聊上下文说明
- 同一个群组内，所有成员共享一套对话上下文
- 机器人可读取群内全部消息，但只响应被 @的内容
- 群聊消息迭代快，建议提前配置对话压缩，避免 Token 溢出
九、高阶玩法：多渠道同时在线
单网关支持多渠道并行运行，一套配置打通微信、QQ、Telegram、Discord 等多个平台。
1. 多渠道合并配置示例
json
{
"channels": {
"telegram": {
"botToken": "Telegram Token"
},
"whatsapp": {},
"discord": {
"botToken": "Discord Token"
},
"qq": {
"appId": "QQ AppID",
"token": "QQ Token"
}
}
}
2. 消息隔离逻辑
- 各渠道会话相互独立：Telegram 对话不会串到 WhatsApp
- 会话（Session）按「渠道 + 联系人 / 群组」隔离
- 长期记忆（Memory）全局共享，跨平台可保留用户偏好、关键信息
十、渠道状态运维：排查与重连
1. 查看全渠道状态（延迟、在线、活跃度）
bash
运行
openclaw channels status --probe
2. 单渠道重新登录
渠道掉线、异常时，单独重连：
bash
运行
openclaw channels login --channel 渠道名
3. 全局重启网关
所有渠道异常时，一键重启：
bash
运行
openclaw gateway restart
十一、常见问题一站式解答
Q：渠道频繁断开连接怎么办？
A：先执行 openclaw channels status --probe 定位异常渠道，再使用重连指令恢复。
Q：最多可以同时运行多少个渠道？
A：无硬性数量限制，常规服务器稳定运行 5~10 个渠道毫无压力。
Q：海外渠道（Telegram/WhatsApp）消息延迟高？
A：检查网络环境，海外平台需配置合规代理，再查看渠道延迟数据。
Q：微信、QQ 频繁触发风控？
A：降低自动回复频率，限制单条消息长度，避免短时间批量应答。