ClawBot怎么注册和开启首次对话？

需先确认微信版本≥8.0.70并启用ClawBot插件，再执行npx安装命令扫码绑定，最后在微信搜索“微信ClawBot”发起消息完成首次对话。

如果您已完成 ClawBot 插件安装但尚未注册并启动首次对话，则可能是由于未完成身份绑定或网关服务未就绪。以下是完成注册与首次对话的步骤：

一、确认微信版本与插件启用

ClawBot 插件需依赖微信底层协议支持，低版本微信无法加载授权界面或生成有效二维码。必须确保客户端满足最低兼容要求。

1、iOS 用户检查微信是否为 8.0.70 及以上版本，前往 App Store 点击“更新”；

2、Android 用户进入手机应用商店，搜索“微信”，点击“更新”并等待安装完成；

3、重启微信应用，避免缓存导致插件列表未刷新；

4、依次点击【我】→【设置】→【插件】，在列表中找到“ClawBot”并点击启用。

二、执行终端安装命令并扫码绑定

该步骤将启动本地网关服务，并通过二维码建立微信客户端与 OpenClaw 实例之间的双向通信通道。命令会自动检测运行环境并注入必要配置。

1、在部署 OpenClaw 的设备上打开终端（Linux/macOS）或 PowerShell（Windows WSL）；

2、输入并执行：npx -y @tencent-weixin/openclaw-weixin-cli@latest install；

3、等待命令输出二维码，若长时间无响应，可手动执行 openclaw channels login --channel openclaw-weixin 重新触发；

4、使用同一台手机的微信“扫一扫”，对准终端中显示的二维码完成授权；

5、授权成功后，终端将显示 Gateway restarted，表示通道已激活。

三、查找并发起首次对话

绑定完成后，ClawBot 会以独立联系人身份接入微信通讯录，但默认不自动置顶且不显示在最近聊天顶部，需主动检索才能定位。

1、返回微信主界面，在顶部搜索框中输入 微信ClawBot 或 ClawBot；

2、在搜索结果中点击匹配的联系人头像，进入聊天窗口；

3、发送任意文本消息，例如“你好”或“测试”，无需附加指令或格式；

4、等待数秒，若看到回复（如“收到”、“正在初始化记忆…”等），即表示首次对话成功建立。

四、验证配对与消息回传路径

首次对话实质是双向链路连通性测试，需确认消息能从微信发出、经网关转发至本地模型、再原路返回，任一环节中断都将导致无响应。

1、保持终端窗口开启，观察日志中是否持续出现 [weixin] received message 和 [weixin] sent reply 字样；

2、若仅见接收日志而无发送日志，说明模型未就绪，需检查 openclaw onboard 是否已完成；

3、若日志完全静默，执行 ps aux | grep clawdbot 确认核心进程仍在运行；

4、进程缺失时，执行 openclaw start 手动拉起服务。

五、处理常见注册失败状态

部分用户在扫码后仍无法在微信中查到联系人，此现象多由微信端缓存延迟或插件状态不同步引发，非服务端故障。

1、退出微信账号并重新登录，强制刷新插件注册表；

2、在【设置】→【插件】中长按 ClawBot 卡片，选择“卸载”，再重复启用流程；

3、若终端报错 ERR_CONNECTION_REFUSED，说明网关监听端口被占用，执行 lsof -i :3000（默认端口）查杀冲突进程；

4、确认 /root/.clawdbot/config.yaml 中 channels.wechat.enabled: true 已设为 true。