前言¶
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。
