dsh-clawbot：微信 AI 代理指揮中心

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