DeepSeek Harness (DSH) 允许开发者构建本地运行的 AI 代理。若要在微信中与之交互,通常需要部署网关或使用插件。dsh-clawbot 是一个社区增强版插件,通过腾讯官方的 ClawBot (iLink) 协议,将微信直接接入本地 DSH 进程。
是什么¶
该插件由 tangwenhao616-netizen 维护,遵循 MIT 许可证。它解决了早期微信插件在并发处理和会话管理上的不足,将微信从单纯的通讯工具变为本地代理的指挥中心。
核心能力¶
- 多会话管理:一个微信用户可以拥有多个独立会话,通过斜杠命令进行创建、切换和删除。
- 斜杠命令:支持
/new、/list、/use、/model、/rename、/del、/tag、/help等命令,无需 Web 界面即可管理。 - 每会话模型:每个会话独立配置模型,支持在对话中在线切换。
- 并发安全:修复了原版单线程阻塞的问题,采用按用户排队机制,确保消息处理无阻塞。
- 富媒体支持:支持文本、语音(自动转文本)及图片(支持视觉模型感知)。
- 主动推送:支持通过 HTTP 接口和工具调用主动向微信推送消息。
- 安全存储:凭证文件存储权限为 0600,采用原子写入方式。
安装与启用¶
-
安装插件
在终端中执行以下命令:
dsh plugin --profile web add github:tangwenhao616-netizen/dsh-clawbot
-
启动 Web 服务
启动 DeepSeek Harness 的 Web 服务器:
dsh web --port 3080
-
扫码登录
浏览器访问
http://127.0.0.1:3080/weixin,点击“扫码登录”,使用微信扫描即可。
使用示例¶
- 创建并切换会话
在微信中发送:
/new work
系统将新建并切换到名为「work」的会话。
- 指定会话对话
在微信中发送:
#work 帮我写周报
- 切换模型
在当前会话中发送:
/model 3
- HTTP 主动推送
通过 HTTP 接口主动向指定用户发送消息:
curl -X POST http://127.0.0.1:3080/weixin/send \
-H 'content-type: application/json' \
-d '{"to":"user@im.wechat","text":"hello"}'
配置与注意事项¶
配置项¶
可通过 cordis.patch.yml 覆盖默认配置:
- insert:
- id: weixin
name: dsh-clawbot
config:
replyMode: last # full | last
maxChunk: 1200
sendIntervalMs: 2000
安全与运行环境¶
- 无认证面板:
/weixin面板无认证机制,仅建议在受信任的内网或本地运行dsh web。 - 微信版本要求:需要微信 ≥ 8.0.70,并在设置中开启 ClawBot 插件。
- 依赖:图片处理依赖视觉模型,否则会跳过图片内容以避免污染历史记录。
总结¶
dsh-clawbot 提供了一套完整的方案,让本地运行的 AI 代理能通过微信进行多会话、并发且安全的交互。对于需要高频使用微信进行代理调试或办公的开发者,它是一个实用的工具。
项目地址:https://github.com/tangwenhao616-netizen/dsh-clawbot