Foreword

In daily development of DeepSeek Harness (DSH), web sessions typically run locally within dsh web. When away from the computer, it becomes inconvenient to continue viewing context or add instructions. dsh-telegram-channel is a Telegram mobile remote control designed for DSH: it attaches to the currently running local web session, enabling the mobile phone to maintain the same session trajectory and bidirectional visibility with the computer’s web interface.

What It Is

dsh-telegram-channel is maintained by hi-wenw under the MIT license. It connects a Telegram Bot to the current session of the local dsh web, allowing users to view sessions, continue context, and switch the model of the bound session from their mobile phone.

Core Features

The verified capabilities are listed below:

  • Telegram mobile remote control that attaches to the currently running local web session.
  • Maintains the same session trajectory and bidirectional visibility between mobile and computer web.
  • Supports /sessions for listing and attaching sessions by workspace.
  • Supports /last to view the last Q&A of the bound session.
  • Supports /model to switch the current bound session’s model, effective from the next turn.
  • Supports Bot commands like /status, /unbind, /help, etc.
  • Supports configuration options such as token, allowedUserIds, allowAllUsers, maxMessageLength, pollingTimeoutSec, and rendering.
  • Supports one-click installation scripts for Windows PowerShell, CMD, and macOS/Linux.
  • Supports accessing the Telegram API via HTTP(S)_PROXY.

Prerequisites

The following are required:

  • DeepSeek Harness (DSH) with a functioning dsh web on your local machine.
  • Node.js, preferably >=22.
  • A Telegram Bot Token.
  • A numeric User ID.
  • Optional: HTTP(S)_PROXY.

Python is not required.

Installation and Activation

You can use the plugin installation command directly:

dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel

This command adds dsh-telegram-channel to the web profile.

To use a Bot Token and whitelist, first set the environment variables:

export DSH_TELEGRAM_TOKEN='...'
export DSH_TELEGRAM_ALLOWED_USER_IDS='123456789'

Then execute:

dsh plugin --profile web add github:hi-wenw/dsh-telegram-channel

DSH_TELEGRAM_ALLOWED_USER_IDS serves as the whitelist; if the whitelist is empty, no one can use it. Setting allowAllUsers to true is only for debugging purposes.

One-Click Installation Scripts

Windows PowerShell:

irm https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.ps1 | iex

macOS / Linux:

curl -fsSL https://raw.githubusercontent.com/hi-wenw/dsh-telegram-channel/master/scripts/install.sh | bash

These scripts are for installation on the respective platforms. Manual installation is also possible: after setting DSH_TELEGRAM_TOKEN and DSH_TELEGRAM_ALLOWED_USER_IDS, run the plugin installation command mentioned above.

Typical Usage

  1. Run on your computer:
dsh web

  1. On your phone, execute /sessions in the Telegram Bot, select a workspace and session, then attach.

  2. Once attached, your phone and web follow the same session trajectory; you can use /last to view the last Q&A of the bound session.

  3. To switch models, use /model with the Bot, effective from the next turn.

  4. /unbind only disconnects the phone without closing the computer session.

Use Cases and Notes

This is suitable for DSH users who need to run dsh web on their computer while using Telegram on their mobile to view sessions, continue context, or switch the bound session’s model.

Before use, note the following:

  • /model requires dsh web (apiProxy) and must first be bound via /sessions.
  • Do not share the Token in public groups; if leaked, revoke it through BotFather with /revoke.
  • If allowedUserIds is empty, no one can use the service.
  • allowAllUsers set to true is only for debugging.
  • User patches should not insert duplicate IDs; they should overwrite by ID.
  • The plugin runs with the permissions of the current dsh process; inspect the source code and license before installation.

Conclusion

The value of dsh-telegram-channel lies in turning your mobile Telegram into a remote control for your local DSH web session, rather than initiating a separate session. The repository is available at:

https://github.com/hi-wenw/dsh-telegram-channel