前言¶

做 DSH 智能體時，經常需要把 Agent 接到日常使用的聊天入口。微信是常見入口之一，但個人微信接入如果走逆向協議、Hook 客戶端或網頁自動化，既可能帶來合規風險，也可能影響賬號安全。對於不想維護公網回調服務、希望以官方通道接入的開發者，dsh-plugin-wechat-official 提供了一個微信 ClawBot 渠道插件：通過騰訊官方開放的微信 ClawBot 插件功能（iLink 協議），讓用戶在個人微信中與 DSH Agent 對話。

這是什麼¶

dsh-plugin-wechat-official 是 DeepSeek Harness（DSH）的微信 ClawBot 渠道插件，由 echo-lgtm 維護，許可證爲 MIT。

它解決的核心問題是：把個人微信中的消息橋接到 DSH Agent。用戶在微信裏發消息，插件將消息交給 DSH Agent；Agent 回覆後，插件再將回復發回微信。插件基於騰訊官方 ClawBot 接口實現，不使用個人微信逆向協議、網頁自動化或 Hook 客戶端，也不需要公網 IP、域名或端口映射。

核心功能¶

下面介紹已覈實的幾項能力：

1、通過騰訊官方微信 ClawBot 插件功能（iLink 協議）接入個人微信。

2、支持掃碼登錄、長輪詢接收消息、通過 sendmessage 回覆消息。

3、每個微信用戶擁有獨立的 DSH Agent 會話，並支持歷史持久化恢復。

4、支持通過 sendtyping 顯示“正在輸入”狀態。

5、支持 iLink 連接約 24 小時有效期、到期提醒、自動強制重連。

6、支持訪問控制：open、allowlist、disabled。

7、支持語音轉寫、圖片/文件/視頻佔位描述轉發。

8、支持 Markdown 轉微信友好純文本。

9、無需公網 IP、域名或端口映射。

安裝與啓用¶

前置條件¶

在開始安裝前，先確認以下條件：

1、一個開通了“微信 ClawBot 插件功能”的微信個人賬號。

2、DeepSeek Harness 的 dsh CLI 與 web profile 可正常運行。

3、運行環境滿足：

Node.js >= 22

安裝¶

倉庫給出的安裝步驟如下：

git clone https://github.com/echo-lgtm/dsh-plugin-wechat-official.git
cd dsh-plugin-wechat-official
dsh plugin --profile web add file:$(pwd)

這一步先把插件倉庫克隆到本地，再安裝到 DSH 的 web profile 中。

掛載插件配置¶

安裝後，需要把插件掛載到 web profile 中。編輯下面這個配置文件：

~/.dsh/profiles/web/cordis.patch.yml

追加 wechat-clawbot 插件配置。如果只配置訪問控制，可以寫成：

- insert:
    - id: wechat-clawbot
      name: 'dsh-plugin-wechat-official'
      config:
        dmPolicy: 'open'
        allowFrom: []

其中：

• dmPolicy 可配置爲 open、allowlist 或 disabled。
• allowFrom 用於在 allowlist 模式下列出允許對話的用戶。

啓動¶

運行：

dsh web

首次啓動後，在日誌中查看二維碼鏈接，並在手機微信中打開該鏈接完成連接。

典型用法¶

在微信中對話¶

連接成功後，可以在微信中向機器人發送不同類型的消息：

1、發送文字：消息會交給 DSH Agent 處理，Agent 回覆後再發回微信。

2、發送語音：插件支持語音轉寫，將轉寫文本交給 DSH Agent。

3、發送圖片、文件或視頻：插件以佔位描述轉發給 DSH Agent，由 Agent 決定如何回應。

內置指令¶

插件支持以下內置指令：

• /help：查看指令列表。
• /time：查詢當前連接剩餘時間。
• /status：查看 Bot 運行狀態。
• /重新連接：觸發重新連接。

連接續期¶

iLink 連接約 24 小時有效。插件支持到期提醒和自動強制重連。

連接到期前，可以：

• 回覆 Y：立即重連。
• 回覆 N：稍後提醒。

訪問控制¶

訪問控制由 dmPolicy 和 allowFrom 配置：

• open：允許對話。
• allowlist：僅允許 allowFrom 中列出的用戶對話。
• disabled：關閉對話能力。

如果只希望少數用戶可以使用，可以先用 open 模式確認來訪用戶，再改成 allowlist 並填寫允許的用戶列表。

注意事項與風險¶

使用這個插件時，需要特別注意以下幾點：

1、插件作爲 DSH 宿主插件運行，運行權限取決於當前 dsh 進程。安裝前應檢查源碼與許可證。

2、需要遵守微信 ClawBot 功能使用條款與微信個人賬號使用規範。

3、騰訊僅作爲消息管道，不存儲輸入輸出內容；接入的 DSH Agent 輸出責任自負。

4、騰訊可對第三方 AI 服務進行識別、限流甚至阻斷，不建議核心業務完全依賴該通道。

5、需要妥善保管下面這個憑證文件，其中包含 bot token：

storageDir/session.json

6、插件依賴 DSH web profile 正常運行，並且要求 Node.js 版本不低於 22。

鏈接¶

• GitHub：

https://github.com/echo-lgtm/dsh-plugin-wechat-official

• 目錄頁線索（來自插件線索，未在已抓取資料中確認）：

https://www.skillhub.cn/plugins/echo-lgtm/dsh-plugin-wechat-official