# ClawBot（微信）使用

把 CCGUI 与微信打通：扫码绑定后，桌面可把通知 / 额度告警推到你的微信，你也能在微信里发消息遥控正在跑的会话。对接的是微信 iLink Bot 服务（`ilinkai.weixin.qq.com`），CCGUI 只做客户端，**无需自建服务**。

> `bot_token` 是能向本机 Claude Code 写指令的遥控密钥，单独落盘 `%APPDATA%/ccgui/wechat.json`，删文件（或在设置页「解绑」）即失效。它与只读的 Claude OAuth 凭据刻意分开存放，便于权限管控。

## 启用与绑定

1. 桌面 CCGUI → 设置 → 找到「微信 ClawBot」区块，开启。
2. 点「扫码登录」，页面显示二维码。
3. 用微信扫码并确认。确认后 CCGUI 自动保存凭据并开始后台长轮询收消息；设置页显示绑定的微信昵称、状态变为「已绑定」。
4. **激活「操作人」**：你首次给该 bot 发一条消息后，CCGUI 记下你为操作人，之后的出站通知 / 告警都发给你。

## 开关项

设置页可分别控制：
- **微信启用**：总开关。
- **允许遥控输入**（`wechat_remote_input`）：开启后，你在微信发的文本 / 图片会被路由进终端（作为会话输入）；关闭则只收通知、不接受遥控。
- **额度告警**（`wechat_push_quota`）：开启后每 5 分钟查一次账号额度，某窗口利用率越过 90% 时推送告警（跌回 80% 以下自动复位，不重复刷屏）。

## 能做什么

- **通知**：由桌面把要说的事组织成文案后推给你（如任务完成、需要确认等，取决于前端触发点）。
- **额度告警**：5 小时 / 7 天 / 7 天 Opus / 7 天 Sonnet 各窗口用量越阈值时主动提醒。
- **遥控**：微信发文字即写入当前会话；发图片则自动下载、解密、落盘到本机临时目录，并把图片路径插入输入行（Claude Code 随后可读图）。
- 遥控写入同样**不绕过** Claude Code 的权限确认。

## 解绑

设置页「解绑」：停止后台线程、删除凭据文件、清空状态。旧 token 立即失效。

## 说明

iLink Bot 协议为社区梳理、非官方公开文档，字段 / 版本可能随微信更新变动。若失效，协议细节集中在 `src-tauri/src/wechat/api.rs`，便于单点适配。更完整的设计背景见 [docs/design/微信ClawBot对接方案.md](design/微信ClawBot对接方案.md)。
