v-clawbot

在微信 ClawBot 中与 AI 对话的插件。

注：开发者请阅读 开发者指南

安装

npm install -g v-clawbot --registry https://registry.npmjs.org/

使用

1. 安装插件

v-clawbot init

将 v-clawbot 插件安装到 ~/.config/opencode/plugins/，仅需一次，所有项目共享。

2. 使用微信扫码登录

v-clawbot login

1. 终端显示 QR 码
2. 使用微信扫一扫扫码确认登录
3. 凭据保存到 ~/.config/v-clawbot/credentials.json，全局生效

3. 启动 OpenCode

opencode web

插件会自动启动，开始接收微信消息。

常见问题

为什么必须先给机器人发一条消息才能收到 AI 回复？

这是微信 iLink 协议的硬性限制：Bot 不能主动向用户推送消息，只能回复用户发来的消息。第一次使用时，你需要先给机器人发任意消息，之后 bot 才能回复你。

为什么有时收不到 AI 回复了？

可能的原因和处理方法：

1. context_token 过期：微信服务端下发的对话令牌有过期时间，过期后 bot 无法再向你发送消息。解决方法：再给机器人发一条消息，系统会自动刷新令牌并恢复回复。

2. bot 进程断开：检查 opencode 是否正在运行（opencode web），以及终端是否有 poll 进程的错误日志。重启 opencode 即可恢复。

3. 凭证过期：长时间未使用后，登录凭据可能过期。重新运行 v-clawbot login 扫码登录。

需要每隔多久发一次消息才能保持连接？

不需要定时发送。 长轮询连接（getUpdates）由系统自动维护，每 35 秒超时后自动重连，消息游标不会丢失。只有 context_token 过期（通常数小时~24 小时不等，由微信服务端控制）时才需要重新发消息刷新。

如何查看日志和状态？

# 查看状态文件（用户绑定、context_token）
cat ~/.config/v-clawbot/state.json

# 查看凭证文件
cat ~/.config/v-clawbot/credentials.json

# opencode 启动后，插件日志会输出到终端

许可证

MIT