> 先说结论：OpenClaw 支持 10+ 主流消息渠道，本文手把手教你配置微信、QQ、钉钉、飞书、Telegram，让你的 AI 助手无处不在。

—

01 为什么要折腾这个？

说几个真实场景：

场景一：家庭群

爸妈在微信群里问”这个保健品能不能买”，你正在开会没法回。AI 助手自动回复：”根据 XX 资料，这款产品…”

场景二：工作群

钉钉群里同事问”上周的数据报表在哪”，AI 助手秒回：”已找到，链接如下…”

场景三：个人习惯

你习惯用 Telegram，但客户都在微信。AI 助手帮你跨平台同步消息，一个入口管所有。

一句话总结：人在哪，AI 就在哪。

—

02 5分钟看懂 OpenClaw 渠道架构

2.1 原生支持 vs 扩展 Skill

OpenClaw 把渠道分成两类：

| 类型 | 渠道 | 安装方式 |
|—–|——|———|
| 原生内置 | Telegram、企业微信、公众号 | 开箱即用 |
| 扩展 Skill | QQ、钉钉、飞书、Slack、Discord | 装个插件 |

> 💡 Skill 是什么？ 可以理解为”插件”。OpenClaw 保持核心轻量，需要啥装啥。

2.2 配置前准备

查看当前配置

openclaw gateway config.get

配置文件位置

~/.openclaw/gateway/config.yaml

—

03 Telegram（5分钟搞定）

最简单的，新手建议从这里开始。

步骤 1：找 @BotFather 创建 Bot

1. Telegram 搜索 @BotFather
2. 发送 /newbot
3. 按提示输入名称和用户名
4. 保存返回的 Token（格式：123456789:ABCdefGHI...）

步骤 2：改配置

providers:
  telegram:
    enabled: true
    botToken: "你的BotToken"

步骤 3：重启

openclaw gateway restart

✅ 验证：给 Bot 发消息，秒回就是成功了。

—

04 企业微信（15分钟）

适合办公场景，功能最全。

步骤 1：获取凭证

1. 登录 [企业微信管理后台](https://work.weixin.qq.com/)
2. 「应用管理」→「自建」→「创建应用」
3. 记录三个关键信息：
  – 企业 ID（我的企业 → 企业 ID）
  – Agent ID（应用详情页）
  – Secret（应用详情页）

步骤 2：配置接收消息

1. 应用详情 →「接收消息」→「设置 API」
2. URL 填：http://你的域名/wecom/callback
3. 生成 Token 和 EncodingAESKey

步骤 3：写配置

providers:
  wecom:
    enabled: true
    corpId: "企业ID"
    agentId: "AgentID"
    secret: "Secret"
    token: "Token"
    encodingAESKey: "EncodingAESKey"
    callbackHost: "你的域名"

—

05 QQ Bot（10分钟）

> 📦 先装 Skill：openclaw skills add qqbot

步骤 1：申请 Bot

1. 访问 [QQ 开放平台](https://bot.q.qq.com/)
2. 创建 Bot，获取：
  – App ID
  – App Secret
  – Token

步骤 2：配 Webhook

开发设置 →「回调地址」→ 填 https://你的域名/qqbot/callback

步骤 3：写配置

providers:
  qqbot:
    enabled: true
    appId: "AppID"
    appSecret: "AppSecret"
    token: "Token"
    callbackHost: "你的域名"

—

06 钉钉（10分钟）

> 📦 先装 Skill：openclaw skills add dingtalk

步骤 1：创建应用

1. [钉钉开放平台](https://open.dingtalk.com/) → 应用开发 → 企业内部应用
2. 记录 AppKey 和 AppSecret

步骤 2：添加机器人

应用详情 →「机器人」→「添加机器人」→ 开启「接收消息」

步骤 3：群聊接入

1. 进入群 →「群设置」→「智能群助手」
2. 添加机器人 → 选择你的应用

步骤 4：写配置

providers:
  dingtalk:
    enabled: true
    appKey: "AppKey"
    appSecret: "AppSecret"
    callbackHost: "你的域名"

—

07 飞书（10分钟）

> 📦 先装 Skill：openclaw skills add feishu

步骤 1：创建应用

1. [飞书开放平台](https://open.feishu.cn/) → 创建企业自建应用
2. 记录：
  – App ID
  – App Secret
  – Verification Token
  – Encrypt Key

步骤 2：配置事件订阅

「事件订阅」→ 请求 URL 填 https://你的域名/feishu/callback

步骤 3：写配置

providers:
  feishu:
    enabled: true
    appId: "AppID"
    appSecret: "AppSecret"
    verificationToken: "VerificationToken"
    encryptKey: "EncryptKey"
    callbackHost: "你的域名"

—

08 关键问题：公网地址怎么弄？

所有渠道都需要公网回调地址，三种方案：

| 方案 | 成本 | 难度 | 推荐度 |
|—–|——|——|——–|
| 云服务器 | ￥50-100/月 | ⭐⭐ | ⭐⭐⭐⭐⭐ |
| Cloudflare Tunnel | 免费 | ⭐⭐⭐ | ⭐⭐⭐⭐ |
| 花生壳/Frp | 免费-￥10/月 | ⭐⭐⭐⭐ | ⭐⭐⭐ |

Cloudflare Tunnel 快速配置

安装

brew install cloudflared  # macOS

登录

cloudflared tunnel login

创建隧道

cloudflared tunnel create openclaw

运行

cloudflared tunnel run openclaw

—

09 完整配置模板（复制即用）

server:
 port: 8080
 host: “0.0.0.0”

providers:
 telegram:
   enabled: true
   botToken: “${TELEGRAM_BOT_TOKEN}”

 wecom:
   enabled: true
   corpId: “${WECOM_CORP_ID}”
   agentId: “${WECOM_AGENT_ID}”
   secret: “${WECOM_SECRET}”
   token: “${WECOM_TOKEN}”
   encodingAESKey: “${WECOM_AES_KEY}”
   callbackHost: “your-domain.com”

 qqbot:
   enabled: true
   appId: “${QQBOT_APP_ID}”
   appSecret: “${QQBOT_APP_SECRET}”
   token: “${QQBOT_TOKEN}”
   callbackHost: “your-domain.com”

 dingtalk:
   enabled: true
   appKey: “${DINGTALK_APP_KEY}”
   appSecret: “${DINGTALK_APP_SECRET}”
   callbackHost: “your-domain.com”

 feishu:
   enabled: true
   appId: “${FEISHU_APP_ID}”
   appSecret: “${FEISHU_APP_SECRET}”
   verificationToken: “${FEISHU_VERIFICATION_TOKEN}”
   encryptKey: “${FEISHU_ENCRYPT_KEY}”
   callbackHost: “your-domain.com”

> 💡 用环境变量更安全，避免密钥泄露。

—

10 常见问题速查

Q1：收不到消息？

按这个顺序排查：

1. 公网能访问吗？curl 你的域名
2. 防火墙放行了？sudo ufw status
3. 回调 URL 填对了吗？检查平台配置
4. OpenClaw 重启了吗？openclaw gateway restart

Q2：怎么看日志？

实时日志

openclaw gateway logs -f

或看文件

tail -f ~/.openclaw/gateway/logs/gateway.log

Q3：只想用部分渠道？

providers:
  telegram:
    enabled: false  # 禁用

Q4：Skill 装不上？

手动安装：

cd ~/.openclaw/skills
git clone https://github.com/openclaw/ext-qqbot.git qqbot

—

11 还能玩什么？

11.1 渠道专属指令

agents:
  main:
    channelConfig:
      telegram:
        triggerWords: ["/ai", "/ask"]
      wecom:
        triggerWords: ["@AI助手"]

11.2 群聊 vs 私聊区分

if (message.chatType === 'group') {
  // 群聊：简洁回复
} else {
  // 私聊：详细回复
}

11.3 消息格式适配

不同渠道支持不同格式：

| 渠道 | 支持格式 |
|—–|———|
| Telegram | Markdown、HTML、按钮 |
| 微信 | 纯文本、图文卡片 |
| 钉钉 | Markdown、ActionCard |
| 飞书 | 富文本、交互卡片 |

—

后记

配置完这 5 个渠道后，你的 AI 助手就能：

✅ 在 Telegram 陪你闲聊

✅ 在微信群里帮爸妈查资料

✅ 在钉钉群里回答同事问题

✅ 在飞书里同步团队信息

✅ 在 QQ 群里活跃气氛

一句话：人在哪，AI 就在哪。

—

相关资源

– 📚 官方文档：https://docs.openclaw.ai
– 🛠️ Skill 市场：https://clawhub.com
– 💬 社区讨论：https://discord.com/invite/clawd

—

> 💡 新手建议：先用 Telegram 练手，熟练后再搞国内渠道。别贪多，一个一个来。

—

*本文基于 OpenClaw v1.x 编写，配置可能随版本更新变化。*