微信 ClawBot 通道 zhuweiyou/dsh-plugin-clawbot

dsh-plugin-clawbot

DSH（DeepSeek Harness）的微信 ClawBot 通道插件 —— 与微信 ClawBot （@tencent-weixin/openclaw-weixin 协议）双向通信，并支持扫码登录 / 重新绑定账号。
管理面板已集成进 DSH Web 设置界面的左侧菜单（「微信 ClawBot」）。

- 支持文字、图片、带微信转写的语音，并支持在微信里用 /model 查看、切换当前会话模型
- 收到微信消息 → 写入对应 DSH 会话 → 等待智能体回复 → 回发微信
- 微信凭据自动从 ClawBot 账号库（~/.openclaw/openclaw-weixin）发现，与 OpenClaw 通道共用账号，互不覆盖游标
- 管理面板位于 DSH 设置 → 「微信 ClawBot」：查看状态、扫码绑定、重新登录、解绑账号、运行日志
- token 过期（errcode=-14）时通道自动暂停，在面板重新扫码即可
- 面板样式跟随 DSH 主题（浅色 / 深色自适应）

安装（DSH 插件方式）

插件已发布到 npm，直接安装包名即可：

dsh plugin --profile web add dsh-plugin-clawbot

安装后即可用（插件自带的 cordis.patch.yml 作为 bundle 层会自动激活 clawbot 行）。

然后重启：

dsh web

重启后：

- 打开 DSH Web 设置界面 → 左侧菜单出现 「微信 ClawBot」
- 首次使用：点开面板 → 「扫码绑定 / 重新登录」→ 手机微信扫码 → 自动生效
- 已绑定账号时重启自动复用，无需重新扫码
- 微信 token 过期后通道暂停，在面板重新扫码即可

运行截图

管理面板位于 DSH 设置 → 「微信 ClawBot」，浅色 / 深色主题自适应：

消息命令

- /new、/reset — 为当前联系人开启全新会话
- /help — 帮助
- 文字、图片（可附文字）、带微信转写的语音 → 发送给 DSH 智能体
- 附图的 /new、/reset、/help、/model 视为普通提问，不会执行命令
- 每个微信联系人 / 群聊对应一个独立 DSH 会话，模型按会话切换

支持的消息类型

微信侧发来的内容会按原顺序合成一次 DSH 提示，由 DSH 自己入库并写入会话记录：

| 类型 | 支持情况 |
| 文字 | ✅ 直接作为提示词发送 |
| 图片 | ✅ 含图文混发、多图；需要所选模型支持视觉输入 |
| 语音 | ⚠️ 仅使用微信自带转写（voice_item.text） |
| 文件 / 视频 | ❌ 回复暂不支持 |

图片：插件从微信 CDN 下载并按协议解密（image_item.aeskey 优先，其次 media.aes_key，无密钥走明文路径），校验通过后交给 DSH 作为图片附件持久化。只接受 HTTPS 且属于微信 CDN 主机的地址、不跟随跳转，并受 DSH 自身的张数与字节上限约束；按真实文件头识别 PNG / JPEG / WebP / GIF。下载、解密、格式或大小校验失败时会明确回复错误，不会退化成只发送附图文字。

语音：只使用微信消息里已附带的转写文字，转写存在时按普通文字提问。插件不下载、不转码、不做语音识别，因此语音是否可用取决于微信是否给出转写；没有转写时会提示改用文字。

切换模型（/model）

在微信里直接发命令即可，模型清单来自 DSH 实时目录，插件不自行维护：

/model # 列出可用模型与当前会话选型 /model 4 # 按清单序号切换 /model q/q-model # 按 provider/model-id 切换 /model q-model # 模型 ID 唯一时可直接写

- 无参数时显示：当前会话模型（尚未创建会话时显示部署默认模型）、带序号的 provider/model 清单、获取失败的 provider，以及用法提示；内容过长会自动分成多条消息。
- 同一模型 ID 存在于多个 provider 时必须写完整的 provider/model-id；序号越界、ID 不存在或重名时只回复候选项，不会改变当前选择。
- 命令不会被转发给智能体，也不会启动一次模型回合。
- 切换成功后回显规范化后的 provider/model（含 reasoning effort），新模型从下一次模型请求开始生效，正在进行的请求不会被打断。
- ⚠️ 与 DSH Web 端的模型选择语义一致：切换当前会话模型也会异步更新部署默认模型，可能影响此后创建的其他会话。
- 该命令需要当前 DSH 提供 sessionController 的 modelCatalog / selectModel / projections 接口；缺失时会明确回复不支持，而不是静默失败。

结构

src/ TypeScript 源码（Host 半侧） index.ts 插件入口 manager.ts 通道生命周期 / 轮询 / 消息处理 / 登录状态机 weixin.ts ClawBot API 客户端（getupdates / sendmessage / 扫码） media.ts 微信 CDN 图片下载、解密与格式校验 models.ts 模型清单解读、/model 参数解析与消息分段 dsh.ts DSH API 客户端 config.ts 配置解析 + 账号库 state.ts 状态持久化 ui.ts / qr.ts 保留的旧 HTML 渲染（非入口） src/client/ React 客户端半侧（浏览器） index.tsx 注册「微信 ClawBot」设置菜单项 ClawbotSection.tsx 面板组件（状态 / 扫码 / 解绑 / 日志） api.ts 面板调用 /clawbot/api/* 的客户端 locales.ts 中英文案 lib/ 构建产物（由 src/ 编译，勿手改） client/ 客户端 bundle 构建产物 scripts/ 构建脚本 test/ 测试

构建

运行时所需的 lib/ 与 client/ 都是构建产物，已加入 .gitignore：

npm install # 安装 devDependencies
npm run build # esbuild 编译 Host + tsdown 打包客户端
npm test # 构建并运行离线测试

从 GitHub 克隆下来的源码不含构建产物（lib/、client/ 已忽略），构建后才能作为插件加载。

后端 HTTP 接口（面板数据源，/clawbot/api/*）

仅供面板及同机调用，仅接受回环 Host（与 DSH /api 信任围栏一致，防 DNS rebinding）：

- GET /clawbot/api/status — 状态 JSON（含日志尾部）
- POST /clawbot/api/login/start {force?} — 获取登录二维码
- POST /clawbot/api/login/poll {verifyCode?} — 长轮询扫码状态（wait/scaned/confirmed/expired/need_verifycode/...；confirmed 即绑定并热切换）
- POST /clawbot/api/login/cancel — 取消登录
- POST /clawbot/api/unbind — 解绑当前账号
- POST /clawbot/api/resume — 手动恢复通道

注意事项

- 不要与 OpenClaw 微信通道同时运行（共享 getupdates 游标）。
- 重新扫码绑定后，旧账号文件会被清理（同一微信用户只保留最新账号），会话映射与上下文 token 保留，聊天连续性不受影响。
- 媒体限制见上文「支持的消息类型」：图片需要模型支持视觉输入，且只处理当前消息（不回溯引用消息里的历史图片）；语音依赖微信给出的转写。
- 切模型会同步更新部署默认模型，并依赖当前 DSH 的模型接口，详见上文「切换模型（/model）」。

License

MIT