In DeepSeek Harness (DSH) usage scenarios, beyond the command line or Web UI, interacting directly with agents via instant messaging software provides a more flexible remote operations experience. dsh-messenger-gateway is a plugin created to solve this problem, acting as a bridge between DSH and platforms such as Telegram.

Plugin Positioning

A client plugin maintained by GooDAnDReaREADY, providing an enterprise-grade multi-transport protocol messaging gateway. It connects DSH agents to Telegram and supports interactive buttons, forum topics, voice notes, and other features.

Core Features

  • Transport Protocol Support: Supports Telegram bots using long polling or Webhook mode, and also provides Discord and Slack adapters.
  • Session Isolation and Management: Supports session isolation by user or by chat, and supports using forum topics as independent sessions; provides session export, replay, and branching.
  • Interaction Capabilities: Provides reply keyboards for quick actions, multi-select interactive forms (Checkbox), and rendering of Artifacts and Mermaid diagrams.
  • Agent Assistance: Supports switching agent roles and personas, tool and skill checks, and provides an agent tool messenger_ask to obtain user feedback.
  • Files and Notifications: Provides a workspace file manager, admin alert channel, scheduled reminders, and an inbound Webhook event scheduler.
  • Voice Features: Supports speech-to-text and text-to-speech (TTS), and supports sending voice notes (requires an ffmpeg dependency).

Installation and Enablement

Install the plugin via the command line:

dsh plugin --profile web add @goodandready/dsh-messenger-gateway

After installation, go to “Settings → Plugins → Messenger gateway” in the DeepSeek Harness web interface to configure it:

  1. Enable the Telegram adapter.
  2. Enter the Bot Token obtained from BotFather (this field is write/read-only to preserve the current token).
  3. Set an allow list or use a pairing code for authorization.

If Discord or Slack features are required, install the corresponding helper plugins.

Typical Usage

Operate in Telegram using the following commands:

  • /new - Start a new session
  • /role coder - Switch the agent persona to coder
  • /files - Open workspace file management
  • /remind 15m Call client - Set a reminder for 15 minutes later
  • Configure Discord/Slack adapters - Enable the corresponding service in the settings panel and enter the Webhook or Bot Token

Applicable Scenarios and Notes

This plugin is suitable for developers or operations personnel who need to remotely manage and interact with DeepSeek Harness agents through Telegram, Discord, or Slack.

Notes:

  • Voice Note Dependency: The voice note feature depends on ffmpeg; otherwise, the system will send it as a regular audio file.
  • Security Practices: The Bot Token is a DeepSeek Harness secret field and must not be committed to version control.
  • Helper Plugins: The Discord and Slack adapters require the corresponding helper plugins to work properly.
  • Runtime Environment: It requires the DeepSeek Harness web configuration environment.

This plugin connects mainstream instant messaging tools to DeepSeek Harness through a gateway model, making it suitable for development scenarios that require remote control or multi-client collaboration.