第4章：Channel 接入（真实代码版）

本章聚焦 6 个高频渠道：飞书、微信、企业微信、Telegram、QQ、钉钉。目标不是“看懂”，而是“接上”。

4.1 为什么 Channel 是 OpenClaw 真正“活起来”的关键

前面三章解决的是：系统、模型、能力。但没有接入 Channel，OpenClaw 仍然只是“后台系统”。

👉 Channel = 用户与 OpenClaw 的“入口”

员工通过它发指令（写日报、查数据）
客户通过它对话（客服自动回复）
管理层通过它接收结果（汇总、提醒）

一句话：不接 Channel，AI 只能“存在”；接了 Channel，AI 才能“工作”。

4.2 Channel 接入整体架构

用户（微信/飞书/Telegram）
        ↓
Channel 适配层（Webhook / Bot）
        ↓
OpenClaw Gateway
        ↓
模型 + Skills
        ↓
返回结果（消息/文件/卡片）

关键点：

Channel 负责“接收和发送消息”
OpenClaw 负责“理解并执行任务”

4.3 企业最常用 Channel 选择建议

渠道	适合场景	推荐程度
飞书	企业内部办公	⭐⭐⭐⭐⭐
企业微信	企业 + 客户沟通	⭐⭐⭐⭐⭐
微信（个人）	小团队 / 测试	⭐⭐⭐
Telegram	开发 / 跨境团队	⭐⭐⭐⭐
钉钉	部分企业内部	⭐⭐⭐

4.4 Telegram（新手友好）

优点：部署快、用 long-polling，不需要公网回调。

步骤

在 Telegram 搜索 @BotFather；
发送 /newbot；
拿到 Bot Token；
可用 @userinfobot 获取自己的 Telegram 用户 ID；
写入配置并重启。

// ~/.openclaw/openclaw.json
{
  channels: {
    telegram: {
      enabled: true,
      botToken: "7234567890:AAGhQUxxxxxxxxxxxxxxx",
      dmPolicy: "pairing",
      allowFrom: ["tg:你的用户ID"]
    }
  }
}

openclaw gateway restart

注意：国内访问 Telegram 通常需要代理，但只要运行 Gateway 的机器能访问 api.telegram.org 即可。

4.5 飞书（企业首推）

优点：适合中国企业团队协作，OpenClaw 已有原生支持。

步骤

进入飞书开放平台 open.feishu.cn；
创建企业自建应用，类型选择机器人；
记录 App ID 与 App Secret；
为应用添加权限：im:message、im:message.group_at_msg、contact:user.id:readonly；
运行 OpenClaw 向导完成绑定。

openclaw onboard
# 选择 Feishu channel
# 粘贴 App ID 和 App Secret

openclaw gateway restart

测试方法：在飞书中私聊 Bot，观察是否返回配对码或欢迎信息。

4.6 QQ（国内最省事）

优点：QQ Bot 接入门槛低，适合培训演示与群运营。

步骤

用手机 QQ 完成开发者注册与实名；
在 QQ 开放平台创建 Bot；
获取 App ID 与 Token；
把配置写入 OpenClaw。

// ~/.openclaw/openclaw.json
{
  channels: {
    qq: {
      enabled: true,
      appId: "你的AppID",
      token: "你的Token"
    }
  }
}

openclaw gateway restart

4.7 钉钉（企业场景很常见）

优点：可走 Stream 模式，不需要公网回调地址。

步骤

进入钉钉开放平台创建应用；
为应用添加机器人能力；
把消息接收方式设置为 Stream 模式；
安装社区插件或连接器；
配置并重启 Gateway。

openclaw plugins install @soimy/dingtalk
# 或
npm install -g dingtalk-openclaw-connector

如果你希望一个包同时支持多个国内 IM，可考虑：

git clone https://github.com/BytePioneer-AI/openclaw-china.git
cd openclaw-china
pnpm install && pnpm build
openclaw china setup
openclaw gateway restart

4.8 企业微信（两条路线）

模式	说明	适合谁
Agent 模式	传统 XML 回调 / 自建应用	已有企业微信管理权限的企业
Bot 模式	JSON 回调 / 智能机器人	想快速接入的团队

常见做法是通过社区插件接入：

# 示例：统一国内渠道方案
openclaw plugins install @openclaw-china/channels
openclaw china setup
openclaw gateway restart

4.9 微信

重要：个人微信最新推出了官方 ClawBot插件。也可以很方便的接入。

4.10 课堂练习：飞书接入后自动回一条欢迎语

操作目标：让学员完成一次“真实接入”。

创建飞书应用并拿到 App ID / Secret；
运行 openclaw onboard 完成绑定；
在飞书中给 Bot 发“你好”；
确认 Bot 已在线；
再结合第 5 章 Skills 做“欢迎语 + 日报模板”练习。

4.11 本章小结

Telegram：最适合入门教学。
飞书：适合企业。
QQ：最适合国内低门槛体验。
钉钉 / 企业微信：更偏正式企业落地。
微信个人号：最新开放。