微信接入 OpenClaw 有两条路：一是腾讯官方 ClawBot 插件（推荐，最简单），二是 agent-wechat 自托管方案（适合进阶用户）。大多数人用官方插件就够了。
一、两种方案对比
| 官方 ClawBot 插件 | agent-wechat 自托管 | |
|---|---|---|
| 难度 | 简单 | 较复杂 |
| 微信版本要求 | iOS ≥ 8.0.70 | 无特定版本要求 |
| 是否需要 Docker | 否 | 是（或使用托管服务） |
| 稳定性 | 官方支持 | 依赖第三方维护 |
| 推荐场景 | 个人日常使用 | 需要高度定制或企业场景 |
二、方式一：腾讯官方 ClawBot 插件（推荐）
前置条件
- 已完成 OpenClaw 安装（参见第1篇）
- 微信 iOS 版本 ≥ 8.0.70（在 App Store 更新到最新版即可）
- 电脑保持联网和开机（Gateway 需要持续运行）
Step 1 - 运行插件安装器
确保 OpenClaw 已安装并更新到最新版：
npm install -g openclaw@latest然后运行腾讯官方 ClawBot 插件安装器：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install这条命令会自动下载插件安装程序并启动。
Step 2 - 扫码完成配对
安装器运行后，屏幕上会弹出一个二维码。
拿起你的 iPhone，打开微信，按以下路径操作：
- 进入设置
- 找到插件（Plugins）
- 找到 ClawBot
- 点击确认连接，扫描屏幕上的二维码
扫码成功后，终端会显示连接成功的提示。
Step 3 - 启动 Gateway
openclaw gatewayStep 4 - 验证
在微信里给你自己（或者任意联系人）发一条测试消息，ClawBot 应该会接收并通过 OpenClaw 处理回复。
三、方式二：agent-wechat 自托管（进阶）
这个方案适合想要更高控制权的用户。核心原理是用一个微信账号充当机器人账号，通过 agent-wechat 服务桥接到 OpenClaw。
前置条件
- 一个专用微信账号（推荐单独注册一个，不要用主账号）
- Docker 环境（或者直接用托管服务绕过 Docker）
- 手机（用于微信扫码登录）
配置流程（Docker 方案）
Step 1 - 安装 Docker（已有可跳过）
Step 2 - 通过 OpenClaw CLI 启动 agent-wechat 服务并安装插件：
参考 agent-wechat 官方文档 获取最新命令。
Step 3 - 登录微信
服务启动后，会生成一个二维码。用手机微信扫码，完成登录。
Step 4 - 在 OpenClaw 里添加 WeChat Channel
按提示填入服务地址和认证 token，OpenClaw 会连接到 agent-wechat 服务。
重要限制
使用 agent-wechat 方案需要注意：
- 手机微信必须保持登录：如果手机上的微信退出登录，Bot 账号也会断开连接
- 不支持多端同时登录：微信的限制导致这个账号不能同时在多台电脑或微信网页版登录
- 账号风险：使用第三方工具操作微信存在账号被限制的风险，推荐用专用小号
四、常见问题
官方插件：扫码后没有响应
- 确认微信 iOS 版本 ≥ 8.0.70
- 在微信设置里确认 ClawBot 插件已启用
- 检查 Gateway 是否在运行：
openclaw gateway status - 查看日志：
openclaw logs --follow
Bot 掉线后如何重连
ClawBot 插件方案：重新运行插件安装器扫码即可：
npx -y @tencent-weixin/openclaw-weixin-cli@latest installagent-wechat 方案：在服务管理界面重新扫码登录。
确认 Channel 连接状态
openclaw channels status --probe