Introduction

The typical way to use DSH is to open the Web or Desktop Host on a computer, then issue tasks in the workspace, observe outputs, and switch models and permissions. If you wish to handle long tasks while away from the computer, you need a channel that does not rely on the computer interface.

zp-home/dsh-weixin-clawbot provides an independent DeepSeek Harness (DSH) Host Bundle: it integrates Tencent’s official WeChat ClawBot/iLink channel into DSH, allowing mobile WeChat to remotely control DSH via text commands to execute computer tasks.

It does not modify the DSH core and does not rely on Desktop WeChat or WxHook. The original Web and Desktop DSH can still be opened and reuse the same DSH Session.

What is This

  • Project: zp-home/dsh-weixin-clawbot
  • Positioning: Independent DSH Host Bundle, bridging WeChat ClawBot/iLink channel to DSH Agent
  • Maintainer: zp-home
  • License: MIT
  • Supported Platforms: Windows, macOS, Linux
  • Runtime Environment: Node.js 22.19.0 or higher
  • Verified DSH Versions: 0.1.0-rc.8, 0.1.1-rc.2
  • Project Boundaries: Community independent adaptation project, not an official project of Tencent, WeChat, DeepSeek, or DeepSeek Harness

Core Capabilities

Messages and Tasks

  • Receives WeChat text tasks and replies with DSH execution results in text form; long replies are automatically segmented.
  • Receives official transcribed text from WeChat voice messages and processes them as normal text tasks.
  • Currently only handles text and WeChat-side voice transcribed text; receiving WeChat images, files, videos, or other media content is not supported.
  • Sending images, files, audio, or video to WeChat is not supported; DSH’s results are currently only replied to in text.

Session Management

  • Maintains independent persistent DSH Sessions for authorized WeChat users.
  • Supports creating, switching, renaming, archiving, searching, and recovering across Host restarts.
  • Allows reusing the same DSH Session opened on Web or Desktop to avoid duplicate Agent creation.

Runtime Control

  • Supports /cancel to cancel during long task execution.
  • Supports /steer for appending corrections.
  • Supports /task, /queue, /doctor to view tasks, queues, and channel diagnostics.
  • Supports viewing or switching models, Presets, working directories, and session permissions.
  • Forwards DSH native commands not handled by the plugin (e.g., /plan, /goal, /compact) to the DSH command system.

Permissions and Approval

  • Defaults to workspace-write.
  • Switching to danger-full-access requires sending an explicit confirmation command: /permission danger-full-access confirm.
  • The main user can manage authorized users via /users, /invite, /revoke, and /audit.
  • DSH approvals for workspace-write can be handled in WeChat in one go via /approve and /reject.

Reliability

  • Replies are first written to a persistent Outbox.
  • Temporary send failures will result in exponential backoff.
  • Retry continues after Host restarts.

Installation and Activation

The following is the quick installation method for the DSH Web Profile. First, execute the installation command, then follow the repository instructions to complete the WeChat ClawBot/iLink QR code pairing. Once paired, WeChat messages will enter DSH through this channel.

The Web Profile quick installation command is as follows:

dsh plugin --profile web add github:zp-home/dsh-weixin-clawbot

If the actual launch is the Desktop DSH Host, you need to replace web in the command with the Profile actually launched by the desktop build; specific instructions depend on the local DSH launch method, as fixed Desktop Profile commands are not provided in the documentation.

The following conditions must be met before activation:

  • The Host must run persistently; iLink long polling cannot be maintained if a one-off headless process exits.
  • Node.js version must be 22.19.0 or higher.
  • Verified DSH versions are 0.1.0-rc.8 and 0.1.1-rc.2.
  • Supports Windows, macOS, Linux.

Note: By design, this project does not provide Windows startup, scheduled tasks, or system service installation.

Typical Usage

After completing the above installation and pairing steps, you can first send in WeChat:

/status

This command is used to view session, tasks, workspace, Preset, permissions, and models.

If a task is running and needs to be stopped immediately, you can send:

/cancel

If you wish to append corrections at the nearest DSH step boundary, you can send:

/steer <content>

To view or switch the current session model, you can send:

/model [provider/model]

If the current session indeed requires full machine access, you must send an explicit confirmation command:

/permission danger-full-access confirm

By default, workspace-write should still be used as a priority.

Use Cases and Notes

Suitable for the following scenarios:

  • Need to view DSH task status, queues, and channel diagnostics on a phone.
  • Need to remotely cancel long tasks or append corrections at step boundaries.
  • Wish to share the same Session between mobile WeChat and the desktop DSH without creating duplicate Agents.
  • Need to handle one-time workspace-write approvals in WeChat.

Notes before use:

  • The plugin runs with the permissions of the current DSH Host process; check the source code and MIT license before installing.
  • State files save iLink cursors, allowed user IDs, and Session mappings; treat them as private files.
  • Do not commit $DSH_HOME/.credentials.yaml, state.json, pairing QR codes, or un-redacted logs.
  • Current media capabilities are limited: neither receiving nor sending images, files, audio, or video is supported.
  • It relies on a persistent Host; if the Host is closed or a one-off headless process is used, WeChat messages cannot be received continuously.

Links

  • GitHub: https://github.com/zp-home/dsh-weixin-clawbot
  • Directory page given in Plugin Clues: https://www.skillhub.cn/plugins/zp-home/dsh-weixin-clawbot
    This URL comes from the Plugin Clues and has not been directly confirmed in the already scraped materials.