前言¶

做 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