乐于分享
好东西不私藏

OpenClaw 多平台接入指南:QQ、飞书、微信全覆盖

OpenClaw 多平台接入指南:QQ、飞书、微信全覆盖

OpenClaw 多平台接入指南:QQ、飞书、微信全覆盖

安装完成后,你的 AI 助手只能在控制台里对话?本文教你把它接到 QQ、飞书、微信公众号,随时随地都能用。2026年更新,微信接入采用全新扫码登录方式,比旧版更简单。


你能学到什么?

  • ✅ 把 AI 接到 QQ 机器人
  • ✅ 把 AI 接入飞书
  • ✅ 把 AI 接入微信(扫码登录,最新版方案)
  • ✅ 三个平台同时在线,互不干扰

平台接入对比

平台 难度 适合场景 需要准备
QQ ⭐ 简单 私聊 + 群聊,插件功能最全 QQ 开放平台开发者账号
飞书 ⭐⭐ 中等 企业内部,知识库场景 飞书企业账号
微信 ⭐ 简单 个人 / 粉丝互动 个人微信号(需扫码)

重要更新: 微信接入现在采用扫码授权方式,不再需要复杂的后端配置。个人微信号直接扫码就能登录使用。


第一步:接 QQ(最简单,推荐先做)

1.1 创建 QQ 机器人

  1. 打开 QQ 开放平台[1],用手机 QQ 扫码登录
  2. 点击「创建机器人」→「企业自建机器人」
  3. 填写名称后提交,机器人就创建好了
  4. 在机器人页面找到 AppID 和 AppSecret,复制保存

⚠️ AppSecret 关闭页面后会重置,一定要当场复制保存

1.2 一键安装配置

在服务器运行这一行命令,自动完成安装+配置+启动:

curl -fsSL https://raw.githubusercontent.com/tencent-connect/openclaw-qqbot/main/scripts/upgrade-via-npm.sh \
  | bash -s -- --appid 你的AppID --secret 你的AppSecret

1.3 重启网关

openclaw gateway restart

1.4 测试

打开 QQ,找到你的机器人,发一条消息:

你好

AI 回复了即成功。


第二步:接飞书

2.1 创建飞书应用

  1. 打开 飞书开放平台[2],登录
  2. 点击「创建企业自建应用」
  3. 填写名称和描述,创建完成
  4. 在「凭证与基础信息」页面复制 App ID 和 App Secret

2.2 配置应用权限

在「权限管理」页面,点击「批量导入」,粘贴以下内容:

imate:chat
imate:message
imate:message:send_as_bot
imate:resource

保存。

2.3 开启机器人能力

在「应用能力」→「机器人」页面,开启机器人功能。

2.4 配置事件订阅

在「事件订阅」页面:

  • 选择「使用长连接接收事件」(WebSocket 模式)
  • 添加事件:im.message.receive_v1

2.5 配置 OpenClaw

运行命令,按提示输入 App ID 和 App Secret:

openclaw channels install --channel feishu

2.6 重启网关

openclaw gateway restart

2.7 测试

在飞书里给机器人发一条消息,AI 回复即成功。


第三步:接微信(新版扫码方式)

这是2026年最新版方案,相比旧版不需要配置后端服务器,直接扫码授权即可。

3.1 安装微信插件

openclaw plugins install "@tencent-weixin/openclaw-weixin"

3.2 启用插件

openclaw config set plugins.entries.openclaw-weixin.enabled true

3.3 扫码登录(关键步骤)

openclaw channels login --channel openclaw-weixin

运行后会弹出一个二维码,用手机微信扫码并在手机上确认授权。

操作步骤:

  1. 打开手机微信
  2. 扫码后,微信会弹出授权确认页面
  3. 点击「确认授权」
  4. 授权成功,终端会显示登录完成

💡 如果二维码显示乱码或看不清:确保终端支持 UTF-8 编码,字体设置正确。如果终端环境有问题,可以尝试用 --legacy 参数或查看官方文档[3]。

3.4 重启网关

openclaw gateway restart

3.5 测试

在微信里给 AI 发一条消息:

你好

AI 回复了即接入成功。


多账号与上下文隔离

添加多个微信账号

微信插件支持多个微信号同时在线:

# 再扫一次码即可添加第二个账号
openclaw channels login --channel openclaw-weixin

账号上下文隔离

默认所有渠道共享 AI 上下文。如果希望每个微信账号的对话独立:

openclaw config set agents.mode per-channel-per-peer

这样每个「微信号 + 用户」组合都有独立记忆,账号之间不会串台。


常见问题

Q: 扫码后提示「环境异常」怎么办?

微信会检测登录环境,新注册的小号或异常账号可能被拦截。试着用一个日常使用正常的微信号扫码。

Q: AI 回复很慢或没反应?

  1. 检查网关是否正常运行:openclaw gateway status
  2. 检查模型配置是否生效
  3. 查看日志:openclaw logs

Q: 飞书机器人收不到消息?

确认已在「事件订阅」中添加了 im.message.receive_v1 事件,且选择了「长连接」模式而非 Webhook。

Q: 微信提示「该公众号无法提供服务」?

确保 OpenClaw 网关已启动且网络可达。微信需要能访问到你的网关地址。

Q: 如何同时使用多个平台?

三个平台可以同时运行,互不干扰。只要各自的插件和配置正确,网关启动后全部自动在线。


总结

平台 核心步骤
QQ 创建机器人 → 一键安装 → 重启 → 测试
飞书 创建应用 → 配置权限 → 安装插件 → 扫码授权 → 重启
微信 安装插件 → 扫码登录 → 重启 → 测试

推荐接入顺序:QQ → 飞书 → 微信。按这个顺序来,每步都是独立的,成功一个打一个勾。

接入后你的 AI 助手就不局限在网页端了,无论在 QQ、飞书还是微信里都能随时调用。快去试试吧!


有问题欢迎在评论区留言,或者去 OpenClaw 社区[4] 寻求帮助。

引用链接

[1]QQ 开放平台: https://q.qq.com/

[2]飞书开放平台: https://open.feishu.cn/app

[3]官方文档: https://docs.openclaw.ai/channels/weixin

[4]OpenClaw 社区: https://discord.com/invite/clawd

回首页,搜索你想要的文档

在首页搜索框输入关键词,快速定位资料

文库首页搜索指引 立即搜索

相关学习资料