前提条件
在安装 ClawBot 之前，请确认以下条件：
- iOS 微信版本 8.0.70 及以上 -- 在微信「我 -> 设置 -> 关于微信」中查看版本号
- 已安装本地 OpenClaw 实例（或已开通腾讯云 Lighthouse 云端服务）
- Node.js 运行环境 -- 建议 Node.js 18 或更高版本，用于执行 CLI 安装命令
- 处于灰度放量区间 -- ClawBot 目前非全量开放，部分用户可能暂时无法看到插件入口
如果你尚未安装 OpenClaw，请先前往 OpenClaw 官方文档完成基础环境搭建。如果你不确定是否在灰度范围内，可以直接进入微信设置页面查看 -- 如果插件列表中没有出现 ClawBot，说明该账号暂未被纳入灰度。
官方安装步骤
以下是完整的官方安装流程，按顺序操作即可完成 ClawBot 的配置与启用。
- 打开微信，进入「我 -> 设置 -> 插件」页面。在设置菜单的底部区域可以找到「插件」入口。
- 在插件列表中找到 ClawBot。若未显示，说明尚未灰度到该用户，请参考下方社区替代方案。
- 点击 ClawBot，查看终端安装指令。插件详情页会展示一条 CLI 安装命令。
- 在已安装 OpenClaw 的设备终端执行安装命令：
npx -y @tencent-weixin/openclaw-weixin-cli@latest install
- 等待插件安装完成，OpenClaw 自动重启。CLI 工具会自动下载组件、配置环境并重启服务。
- 在微信 ClawBot 插件页面点击「启用」，触发扫码界面。
- 用微信扫码授权，完成绑定。使用微信「扫一扫」扫描终端中生成的二维码。
- 绑定成功后，微信联系人列表出现 ClawBot 入口，即可开始使用。
了解底层技术实现，请参阅技术架构详解。
CLI 命令详解
CLI 安装命令会执行以下操作：
- 检测本地 OpenClaw 实例的运行状态 -- 确认环境就绪
- 下载并安装微信通道插件 -- 从 npm 仓库拉取官方组件
- 自动配置消息转发规则 -- 无需手动编辑配置文件
- 生成扫码授权所需的凭证 -- 用于微信身份验证
- 重启 OpenClaw 实例使配置生效 -- 自动完成，无需手动操作
安装遇到问题？如果命令执行失败，请检查 Node.js 版本是否为 18 或以上，以及网络是否能正常访问 npm 仓库。国内用户可考虑使用 npm 镜像源。
扫码授权与绑定
扫码授权过程确保了只有微信账号持有人本人才能绑定 ClawBot。每次扫码会生成一个唯一的设备令牌，绑定后其他设备无法重复使用。
授权机制
授权成功后，微信账号与 OpenClaw 实例之间建立起一对一的绑定关系。这意味着你发送的消息只会被路由到你自己的 OpenClaw 实例，不会经过任何第三方服务器。如果需要更换设备或重新绑定，可以在微信插件设置中解除授权，然后重新扫码。
了解更多关于安全机制的设计，请参阅安全隐私与合规。
社区替代方案
对于尚未进入官方灰度放量的用户，社区提供了三种主流替代方案。但需注意，这些方案存在稳定性和合规性风险。
方案一：企业微信机器人
通过企业微信的 Webhook 机器人接口，将 AI 回复推送至企业微信群。接入简单、无需逆向工程，但仅限企业微信环境，无法在个人微信中使用。
方案二：协议模拟框架
使用 wcferry、gewechat 等开源框架模拟微信通信协议。功能较完整，但存在严重的稳定性和合规风险 -- 微信版本更新后可能随时失效，且违反微信服务条款，有封号风险。
方案三：微信公众号 / 小程序
通过微信公众号或小程序的官方 API 搭建 AI 对话界面。合规且稳定，但用户体验与原生聊天窗口差异较大，且需要额外的开发与运营成本。
以上方案各有优缺，但从长期来看，ClawBot 的官方插件方案在稳定性、安全性和功能完整性上具有不可替代的优势。
常见问题与注意事项
- 仅支持个人微信：ClawBot 当前仅支持个人微信，不支持企业微信环境下直接使用。
- 内容合规：自动化任务建议在私密频道运行，注意内容合规，发送违规内容可能导致消息被拦截或账号受限。
- 安装影响：安装插件会导致 OpenClaw 自动重启，需注意正在运行的任务，提前保存进度以避免数据丢失。
- Android 支持：Android 版本支持时间线暂未公布，建议关注微信官方动态。了解更多平台支持展望，请参阅挑战与未来展望。
如果你是第一次接触 ClawBot，建议先阅读什么是微信 ClawBot？了解产品全貌与功能限制。