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