dsh-im-gateway: An Aggregated IM Gateway Plugin for DeepSeek Harness

dsh-im-gateway is an aggregated IM gateway plugin (DSH plugin) for DeepSeek Harness (DSH), maintained by zhuiyueya, licensed under MIT, and written in TypeScript. It solves the problem of connecting DSH agents to 24+ chat platforms like WeChat, Feishu, Telegram, Discord, and QQ, allowing you to drive agents directly from your favorite chat apps without opening the Web GUI. Core capabilities include per-chat agent sessions, a remote approval bridge, multi-part input merging, smart long-reply splitting, whitelist security by default, QR-code login with recovery, media send/receive, and one-command installation with visual connection. The plugin was created in August 2026 and is actively updated, currently with 17 stars. It is an official dsh.bundle composite plugin.

What chat channels and core features does the dsh-im-gateway DSH plugin support?

The plugin aligns with OpenClaw's channel coverage, supporting 24+ platforms: WeChat, Feishu, Telegram, Discord, Slack, QQ, WhatsApp, Signal, Teams, LINE, Matrix, Mattermost, IRC, Twitch, Nostr, Zalo, iMessage, plus a built-in WebChat (zero-account). Each chat gets its own agent session; chatting in a group drives the agent, with replies pushed back in real time. /new starts a new session, /bind binds an existing one. The remote approval bridge pushes tool-approval requests to IM; replying "approve/deny" in chat works, with timeout fallback to local approval. Multi-part mobile input uses .. for continuation and !! for immediate submit, with a 5-second merge window. Long replies are split per channel limits, preferring line breaks or periods, with (i/n) numbering. Security defaults to rejecting unknown users, and approval responses are validated against session ownership. WeChat/WhatsApp QR login links are saved to disk, and login state (bot_token + polling cursor) persists, so restarts auto-reconnect without re-scanning. The WeChat channel fully supports images, voice (server-side transcription), files, and videos (CDN AES-128-ECB encrypted); agents can use the im_send_file tool to send workspace files.

How do I install dsh-im-gateway and connect channels?

The installation command is as follows, supporting direct addition via the dsh CLI:

dsh plugin --profile web add github:zhuiyueya/dsh-im-gateway

After installation, open the dsh Web GUI → Settings ⚙️ → 🐋 IM Gateway → select a channel to connect. WeChat/WhatsApp connect via QR scan; others require credentials. The plugin also supports installation via GitHub clone or local directory, and agents can automate download, build, and install.

What is the architecture and event flow of dsh-im-gateway?

The plugin uses ChannelAdapters to normalize inbound messages; each channel has an adapter that receives via polling/WebSocket/webhook and converts to ImMessage. The ImGateway core handles session routing (per-chat), whitelist and IM commands, the approval bridge (approval/request waterfall), and splitting/merging/formatting. User messages flow: channel adapter → gateway (whitelist → merge → session routing) → agent.followup(); agent replies flow back via session/event events, and the gateway splits per channel before sending. Tool approvals go through approval/request to chat, and after approval, allowed-once.

Which DeepSeek Harness versions and platforms does dsh-im-gateway support?

The plugin depends on official @deepseek-ai/dsh-* packages (dsh-agent, dsh-session, dsh-tools, dsh-user-approval, etc.), is a standard dsh.bundle composite plugin, and is compatible with DeepSeek Harness's Web GUI and headless modes. A restart of dsh web is required after installation for the plugin to take effect. The project is MIT-licensed and welcomes PRs.

View more DSH plugins at dsh-plugin.org