微信连接
2026 年 3 月 22 日，腾讯正式推出微信 ClawBot 插件，支持将 OpenClaw 接入个人微信。同时企业微信也支持通过长连接方式对接。
📱 方式一：个人微信 ClawBot 插件
前提条件
| 要求 | 说明 |
|---|---|
| 微信版本 | iOS 8.0.70+ / Android 最新版 |
| OpenClaw | 已安装并运行 |
| 网络 | 服务器可访问外网 |
TIP
ClawBot 插件正在逐步放量中，如果在「设置 → 插件」中看不到，说明尚未灰度到你。
安装步骤
第一步：安装微信插件
bash
npx -y @tencent-weixin/openclaw-weixin-cli@latest install安装后 OpenClaw 会自动重启（正常现象）。
第二步：扫码绑定
- 安装完成后终端会显示一个二维码
- 用手机微信扫一扫
- 确认授权绑定
第三步：开始对话
- 微信中会出现「微信 ClawBot」对话
- 直接发消息即可与你的 OpenClaw 对话
- 支持文字、图片、文件收发
工作原理
个人微信 → 微信/iLink 上游服务 → openclaw-weixin 插件 → OpenClaw Agent
↑ ↓
└──────────────── 回复消息 ←─────────────────────────────────┘插件信息
| 项目 | 说明 |
|---|---|
| 包名 | @tencent-weixin/openclaw-weixin |
| CLI | @tencent-weixin/openclaw-weixin-cli |
| 连接方式 | 长轮询（long-poll） |
| 消息持久化 | 本地缓存，重启不丢消息 |
💼 方式二：企业微信
前提条件
| 要求 | 说明 |
|---|---|
| 企业微信管理员权限 | 需能创建自建应用 |
| OpenClaw v2026.2.26+ | 低版本不兼容 |
| 公网域名 + HTTPS | 企业微信回调必须 HTTPS |
安装步骤
第一步：安装企微插件
bash
openclaw plugins install @wecom/wecom-openclaw-plugin第二步：重启 Gateway
bash
openclaw gateway restart第三步：添加渠道
bash
openclaw channels add按引导操作：
- 选择「Yes」
- 选择 channel 为「企业微信」
- 输入企业微信机器人 Bot ID、Secret
- 选择「Finish」
第四步：配对
- 选择「Pairing」配对方式
- 在企业微信中保存机器人
- 发送一条消息，会收到配对密钥
- 将密钥输入终端
- 配对成功
企业微信配置要点
| 项目 | 说明 |
|---|---|
| CorpID | 企业微信管理后台获取 |
| Secret | 自建应用的 Secret |
| 回调 URL | https://your-domain.com/webhook/wecom |
| Token | 自定义验证 Token |
| EncodingAESKey | 自定义加密密钥 |
🔄 两种方式对比
| 对比项 | 个人微信 ClawBot | 企业微信 |
|---|---|---|
| 接入难度 | ⭐ 极简（一行命令） | ⭐⭐⭐ 需配置 |
| 需要域名 | ❌ 不需要 | ✅ 需要 HTTPS |
| 需要管理员 | ❌ 个人即可 | ✅ 需企业管理员 |
| 消息类型 | 文字/图片/文件 | 文字/图片/文件/卡片 |
| 群聊支持 | ⚠️ 有限 | ✅ 完整 |
| 适合场景 | 个人使用 | 企业/团队 |
🐛 故障排查
Q: 安装后微信看不到 ClawBot？
A: ClawBot 插件正在灰度放量中，需要：
- 微信更新到 iOS 8.0.70+
- 在「设置 → 插件」中查看是否可用
- 如果没有，需等待灰度到你
Q: 扫码后无法绑定？
A: 检查：
bash
# 确认 OpenClaw 运行中
openclaw status
# 检查插件是否安装
openclaw plugins list | grep weixinQ: 消息延迟很高？
A: 个人微信走长轮询，正常延迟 1-3 秒。如果更高：
- 检查服务器网络
- 检查 OpenClaw Gateway 状态
- 尝试重启 Gateway
Q: 企业微信回调失败？
A: 检查：
- 域名是否配置了 HTTPS
- 防火墙是否开放 443 端口
- 回调 URL 是否正确
- Token 和 EncodingAESKey 是否匹配
📚 相关资源
| 资源 | 说明 |
|---|---|
| 微信 ClawBot 官方公告 | 腾讯官方发布 |
| 企业微信官方教程 | 企微帮助中心 |
| Telegram 连接 | 另一种连接方式 |
| Discord 连接 | 另一种连接方式 |
推荐：个人用户首选「个人微信 ClawBot」，一行命令即可接入；企业用户选择「企业微信」获得完整功能。