Introduction

When building DSH agents, it is often necessary to connect the Agent to a chat entry used in daily life. WeChat is one of the common entry points. However, connecting a personal WeChat via reverse protocols, Hooking the client, or web automation may bring compliance risks and affect account security. For developers who do not wish to maintain a public network callback service and want to access via official channels, dsh-plugin-wechat-official provides a WeChat ClawBot channel plugin: allowing users to chat with a DSH Agent in personal WeChat through the Tencent official WeChat ClawBot plugin function (iLink protocol).

What is this

dsh-plugin-wechat-official is a WeChat ClawBot channel plugin for DeepSeek Harness (DSH), maintained by echo-lgtm, licensed under MIT.

The core problem it solves is: bridging messages from personal WeChat to a DSH Agent. Users send messages in WeChat, and the plugin hands the message to the DSH Agent; after the Agent replies, the plugin sends the reply back to WeChat. The plugin is implemented based on the Tencent official ClawBot interface, does not use personal WeChat reverse protocols, web automation, or client Hooking, and does not require a public IP, domain, or port mapping.

Core Features

Below are a few verified capabilities:

  1. Access personal WeChat via Tencent’s official WeChat ClawBot plugin function (iLink protocol).

  2. Supports scanning code login, long-polling to receive messages, and replying messages via sendmessage.

  3. Each WeChat user owns an independent DSH Agent session and supports historical persistence and recovery.

  4. Supports displaying “Typing…” status via sendtyping.

  5. Supports iLink connection validity of about 24 hours, expiry reminders, and automatic forced reconnection.

  6. Supports access control: open, allowlist, disabled.

  7. Supports speech transcription, and forwarding of image/file/video placeholders.

  8. Supports converting Markdown to WeChat-friendly plain text.

  9. No need for public IP, domain, or port mapping.

Installation and Enablement

Prerequisites

Before starting the installation, confirm the following conditions:

  1. A WeChat personal account that has activated the “WeChat ClawBot plugin function”.

  2. The DeepSeek Harness dsh CLI and web profile can run normally.

  3. The runtime environment meets:

Node.js >= 22

Installation

The installation steps provided by the repository are as follows:

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

This step first clones the plugin repository locally, then installs it into DSH’s web profile.

Mounting Plugin Configuration

After installation, the plugin needs to be mounted to the web profile. Edit the following configuration file:

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

Append the wechat-clawbot plugin configuration. If only configuring access control, you can write:

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

Where:

  • dmPolicy can be configured as open, allowlist, or disabled.
  • allowFrom is used to list users allowed to converse in allowlist mode.

Startup

Run:

dsh web

After the first startup, view the QR code link in the logs and open the link in the mobile WeChat app to complete the connection.

Typical Usage

Chatting in WeChat

After successful connection, you can send different types of messages to the bot in WeChat:

  1. Send text: The message is handed over to the DSH Agent for processing, and the reply is sent back to WeChat after the Agent replies.

  2. Send voice: The plugin supports voice transcription, handing the transcribed text to the DSH Agent.

  3. Send images, files, or videos: The plugin forwards them as placeholder descriptions to the DSH Agent, and the Agent decides how to respond.

Built-in Commands

The plugin supports the following built-in commands:

  • /help: View the list of commands.
  • /time: Query the remaining time for the current connection.
  • /status: View the Bot running status.
  • /重新连接: Trigger reconnection.

Connection Renewal

The iLink connection is valid for about 24 hours. The plugin supports expiry reminders and automatic forced reconnection.

Before the connection expires, you can:

  • Reply Y: Reconnect immediately.
  • Reply N: Remind later.

Access Control

Access control is configured by dmPolicy and allowFrom:

  • open: Allow conversation.
  • allowlist: Only allow users listed in allowFrom to converse.
  • disabled: Disable conversation capability.

If you only want a few users to use it, you can first use open mode to confirm visiting users, then change to allowlist and fill in the list of allowed users.

Notes and Risks

When using this plugin, you need to pay special attention to the following points:

  1. The plugin runs as a DSH host plugin, and runtime permissions depend on the current dsh process. You should check the source code and license before installing.

  2. You need to comply with the WeChat ClawBot function usage terms and WeChat personal account usage norms.

  3. Tencent only acts as a message pipe and does not store input/output content; the liability for the DSH Agent output is your own.

  4. Tencent may identify, rate-limit, or even block third-party AI services; it is not recommended to rely entirely on this channel for core business.

  5. You need to properly keep the credential file below, which contains the bot token:

storageDir/session.json
  1. The plugin depends on the DSH web profile running normally and requires the Node.js version to be no less than 22.

Links

  • GitHub:
https://github.com/echo-lgtm/dsh-plugin-wechat-official
  • Directory page clue (from plugin clue, not confirmed in collected materials):
https://www.skillhub.cn/plugins/echo-lgtm/dsh-plugin-wechat-official