DeepSeek Harness 微信插件

English

基于腾讯官方 iLink/ClawBot 协议和扫码授权，为 DeepSeek Harness 提供独立的微信私聊通道。

这是 DeepSeek Harness 原生插件，不依赖 OpenClaw。iLink 协议、扫码流程、AES 媒体处理和消息字段参考了腾讯以 MIT 许可证开源的 Tencent/openclaw-weixin 2.4.6 实现。

功能

• 微信官方二维码登录，不需要 AppID、AppSecret 或手工申请的 key。
• 登录令牌由 Harness 凭据服务保存，不进入插件配置。
• 长轮询游标原子持久化，重启后继续消费。
• 每个微信用户对应一个持久 Harness 会话。
• 完整接入 Harness Agent preset 生命周期、结构化工具执行和 Web live session 复用。
• 接收文字、语音转写、引用上下文和 AES 加密图片。
• 发送文字，并通过微信 CDN 加密上传图片。
• 出站文字支持与腾讯插件一致的部分 Markdown 渲染。
• 当前模型不支持视觉时，自动保存图片并降级为附件说明。
• 支持允许名单、禁用策略、有界并发、去重、重试和完整清理。
• 内置 /bot-ping、/bot-help、/bot-status、/bot-image-test、/bot-cancel。
• 按需扫码不阻塞 Harness Web；可从 Linux 终端主动生成或重显二维码。
• 工具请求审批时，可在同一微信会话用 /approve 或 /reject 决定。
• /new、/reset 创建新的持久 session；其他 Harness 斜杠命令直接进入命令运行时。

腾讯当前的 ClawBot/iLink 接入仅支持私聊。

前置条件：ClawBot 权限

这个通道不使用 API key。你的微信账号必须已经出现官方 ClawBot 插件入口：

微信 → 我 → 设置 → 插件 → ClawBot

腾讯仍在逐步开放该功能。如果没有这个入口，不是缺少 key，也没有单独的 key 申请页面；需要等待账号获得资格，或先使用其他通道。

安装

直接从 GitHub 安装到 web profile：

pnpm dsh plugin --profile web add github:sliverp/DeepSeek-harness-weixin

安装只会更新 profile。服务尚未运行时用下面的命令启动；已经运行则重启：

pnpm dsh web

启动 pnpm dsh web 时，插件只会恢复已有凭据；没有凭据时保持离线，不会自动创建二维码，也不会阻塞或关闭 Harness Web。

需要扫码登录或更换当前微信账号时，另开一个 Linux 终端运行：

pnpm dsh plugin --profile web exec dsh-weixin login

这个命令即使微信已经连接也会强制发起重新登录，不再返回“微信已经连接，无需扫码”。扫码确认前旧连接继续工作；确认成功后，插件会覆盖 WEIXIN_ILINK_CREDENTIAL 并热切换到新连接。命令通过仅当前用户可访问的本机 Unix Socket 联系运行中的插件，并把新二维码或当前扫码流程的最新二维码显示在执行命令的终端。它不会重启 Web、不会等待扫码完成，也不会把备用链接写入 session。扫码流程最终超时后，再次执行即可开始全新流程。

只需要二维码 URL（例如交给其他脚本）时使用：

pnpm --silent dsh plugin --profile web exec dsh-weixin login --url