Skip to content

zhuiyueya/dsh-im-gateway

161Last commit Aug 16, 2026

dsh-im-gateway DSH plugin

dsh-im-gateway is a DSH plugin that connects your preferred chat applications to DeepSeek Harness agents. It supports 24+ channels, unified sessions, remote approval, and media transfer, all configured via a Web GUI or YAML file.

How to install the dsh-im-gateway DSH plugin

dsh plugin --profile web add /tmp/dsh-im-gateway

Copying does not run this command. Review the repository and version before installing the dsh-im-gateway DSH plugin.

dsh-im-gateway DSH plugin data source

dsh-im-gateway DSH plugin snapshot date: Aug 16, 2026

discovered

What the dsh-im-gateway DSH plugin can do

  • Supports 24+ IM channels including WeChat, Telegram, Discord, Feishu, QQ, Slack, LINE, WhatsApp, iMessage, and more.
  • Per-chat session management: each chat gets its own agent session; /new and /bind commands for session control.
  • Remote approval bridge: tool approval requests are pushed to IM, and users can approve or reject directly in chat.
  • Multi-segment input merge for mobile: `..` indicates more to come, `!!` submits immediately, with a 5-second merge window.
  • Intelligent long reply splitting: splits at line breaks or sentence endings, with `(i/n)` numbering and truncation.
  • White-list security: unknown users are rejected by default; approval replies are validated against session ownership.
  • QR code login and persistent authentication: WeChat/WhatsApp login tokens are saved; restarts automatically reconnect without re-scanning.
  • Media send/receive: WeChat channel supports images, voice (transcribed to text), files, and video (CDN AES-128-ECB encrypted); agent can use im_send_file tool to send workspace files.
  • One-command installation and visual connection: standard dsh.bundle plugin; Web GUI setting panel for channel selection, scanning, or credential entry.
  • User-friendly: WeChat/WhatsApp one-click QR code scan; other channels have guided forms and real-time status display.

Where the dsh-im-gateway DSH plugin fits

  • Drive a DeepSeek Harness agent from your daily chat app (e.g., Telegram, WeChat) without opening the Web GUI.
  • Approve tool requests (e.g., file write, command execution) remotely via your phone while away from the computer.
  • Receive agent-generated reports, screenshots, or files directly in your chat conversation.
  • Manage multiple agent sessions from different chats, each with its own context and history.
  • Quickly onboard new users by letting them scan a QR code to connect their WeChat or WhatsApp account.

Who the dsh-im-gateway DSH plugin is for

  • DeepSeek Harness users who want to interact with their agents from mobile or desktop chat apps.
  • Developers and power users who need remote approval and session management while on the go.
  • Teams or individuals who prefer using chat interfaces (e.g., Slack, Discord) for agent collaboration.

dsh-im-gateway DSH plugin limitations

  • WeChat channel requires a dedicated secondary account and uses the official iLink protocol (subject to WeChat's terms).
  • Experimental channels (Teams, Google Chat, Tlon, Yuanyuan, Voice) require public internet access or dedicated infrastructure; use at own risk.
  • Some channels have dynamic dependencies (e.g., WhatsApp requires `npm i @whiskeysockets/baileys`; Nostr requires `npm i @noble/curves`) that need to be installed separately.
  • Default security: all unknown users are rejected; first-time users must be authorized via the Web GUI before they can chat.
  • Only supports the DSH plugin system; not a standalone application.

dsh-im-gateway DSH plugin: from the repository README

Quoted from the zhuiyueya/dsh-im-gateway README, the upstream source of the dsh-im-gateway DSH plugin. Copyright remains with the original authors.

> 任选一种方式,把下面整段提示词发给你的 dsh(Web GUI 聊天框 / `dsh --profile headless "…"` / 已接入的 IM 聊天),agent 会**自动完成下载、构建、安装**——不用手动敲命令。 <details open> <summary><b>方式 A · GitHub 克隆安装(最稳妥,推荐)</b></summary> ```text 请帮我安装 dsh-im-gateway 插件(DeepSeek Harness 的聚合 IM 网关): 1. 执行 git clone --depth 1 https://github.com/zhuiyueya/dsh-im-gateway.git /tmp/dsh-im-gateway 2. 执行 cd /tmp/dsh-im-gateway && npm install && npm run build 3. 执行 dsh plugin --profile web add /tmp/dsh-im-gateway 4. 汇报结果;如果提示需要重启,提醒我重启 dsh web。 ``` </details> <details> <summary><b>方式 B · 远程仓库直装(无需 clone,已实测可用)</b></summary> ```text 请安装 dsh-im-gateway 插件:dsh plugin --profile web add https://github.com/zhuiyueya/dsh-im-gateway.git 装完提醒我重启 dsh web(首次安装依赖约 1-2 分钟)。 ``` </details> <details> <summary><b>方式 C · 本机已有项目目录</b></summary> ```text 请把本机项目 dsh-im-gateway 安装为 dsh 插件: 1. 进入项目目录执行 npm install && npm run build 2. 执行 dsh plugin --profile web add <项目绝对路径> 3. 提醒我重启 dsh web。 ``` </details> 装好后:**打开 dsh Web GUI → 设置 ⚙️ → 🐋 IM 网关 → 点选渠道连接**(微信/WhatsApp 扫码即连,其余填凭据即可)。 --- ## ✨ Highlights - 🌐 **24+ 渠道全覆盖** — 对齐 OpenClaw 的渠道面:微信、飞书、Telegram、Discord、Slack、QQ、WhatsApp、Signal、Teams、LINE、Matrix、Mattermost、IRC、Twitch、Nostr、Zalo、iMessage、内置 WebChat

Read the full READMERepository license: MIT

dsh-im-gateway DSH plugin questions

How do I install dsh-im-gateway plugin?

You can install it by sending the installation prompt to your DSH agent (e.g., via Web GUI or CLI). The prompt will run `git clone`, `npm install && npm build`, and `dsh plugin add`. Alternatively, you can use the remote install command: `dsh plugin --profile web add https://github.com/zhuiyueya/dsh-im-gateway.git`. After installation, restart DSH web.

How do I connect WeChat or WhatsApp to the gateway?

Open DSH Web GUI, go to Settings → IM Gateway. Click 'Connect (Scan QR Code)' for WeChat or WhatsApp. A QR code will appear on the screen; scan it with your phone. The login token is persisted, so restarts do not require re-scanning.

Why does my first message get rejected?

By default, the plugin rejects all unknown users for security. Your first message will trigger a 'not authorized' response. Go to DSH Web GUI → Settings → IM Gateway. You'll see a banner 'User request access'. Click 'Allow' to authorize that user. After that, you can chat normally.

Can I use the plugin with multiple chat apps at the same time?

Yes, you can connect multiple channels simultaneously. Each channel operates independently. You can manage sessions per chat. For example, you can chat with your agent via Telegram on your phone and via Discord on your desktop.

How do I temporarily disconnect a channel without losing its configuration?

In the IM Gateway settings, each connected channel card has two buttons: 'Disconnect' and 'Delete Configuration'. Click 'Disconnect' to temporarily stop the channel; it will automatically reconnect after restarting DSH. If you click 'Delete Configuration', the credentials are removed and you'll need to reconfigure.