前言¶
DeepSeek Harness（DSH）的架构采用插件化设计，使得扩展功能变得灵活。在实际开发或使用中，智能体往往需要将执行状态同步到个人终端，或者接收移动端的指令反馈。现有的第三方中转方案存在隐私泄露风险或稳定性隐患。dsh-clawbot 插件直接对接腾讯官方 ilink 机器人网关，为 DSH 提供了官方认证的微信接入能力，无需自建中转服务。
插件简介¶
这是一个在 DeepSeek Harness 中接入微信官方 ilink 机器人网关的工具插件。由用户 cryjkd 维护，采用 MIT 许可证。它允许 AI 主动给自己发微信通知，并支持微信消息监听与自动处理。
安装与启用¶
使用官方提供的命令行工具安装：
dsh plugin --profile web add github:cryjkd/dsh-clawbot
安装完成后，必须重启 dsh web 才能使设置界面生效。刷新页面后，在设置中会出现「ClawBot」分区。
使用流程¶
- 打开 DSH 设置页，进入「ClawBot」分区。
- 点击「绑定微信 / 刷新二维码」，使用手机微信扫描面板显示的二维码并确认。
- 绑定成功后，状态卡显示「已绑定」，但状态文本为「微信连接断线」。
- 在微信中找到新出现的 bot 联系人，发送任意一条消息。这一步用于解锁发送凭证
context_token。 - 刷新 DSH 面板，状态变为「微信在线」，即可在面板「发送」（支持 markdown），或让 AI 调用
notify_wechat接口。
核心功能¶
1. AI 主动通知¶
插件提供了 notify_wechat 接口。AI 在执行长任务或需要用户拍板时，可调用此接口发送通知，支持 Markdown 格式。
2. 自动通知¶
在设置界面有三个自动通知开关，默认均开启：
* 任务完成后：每次回复后自动推送任务摘要、结果和耗时。
* 任务被阻断时：当目标（goal）被阻断时推送通知。
* 等待批准/回答时：当 AI 需要用户批准操作或选择回答时，主动微信提醒。
3. 监听功能¶
在设置中开启「监听微信消息并自动处理」开关：
* 插件会在后台轮询微信网关（约 1.5 秒一次），只收集绑定账号本人发来的消息。
* 收到消息后，插件会创建一个独立的监听会话（会话 ID 格式为 clawbot-listen-*）进行处理，不影响当前主会话。
* 图片、文件、视频等媒体内容会下载到本地 ~/.dsh/clawbot/media/ 目录。
接口说明¶
插件在 Host 半侧挂载了以下工具/接口：
notify_wechat：AI 主动发送微信通知。wechat_bind：绑定微信，返回二维码链接。wechat_status：查询绑定状态、连接状态及开关设置。
注意事项与限制¶
- 主动发送限流：微信官方 ilink 网关对主动发送有限流，数量较少。此插件仅适合作为通知或拍板渠道，不适合作为高频聊天工具。
- 转发限制：Bot 无法接收被转发到微信的文章和文件。用户需发送原始链接或文件本身。
- 凭证机制：
context_token仅在绑定者先向 Bot 发送一条消息后才会下发。过期后需在微信里再发一条消息恢复。 - 权限与重启：插件以当前 DSH 进程权限运行。若需修改插件图标，需替换
icon.png文件并重启dsh web。
