DSH Telegram Bridge (todayer)
Telegram bridge (bot) for DeepSeek Harness (dsh): manage local sessions, topics and media right from Telegram. Based on hi-wenw/dsh-telegram-channel and extended with mechanisms from the Telegram gateway of the Hermes agent.
> Quick start: dsh plugin --profile web add github:todayer/todayer-dsh-telegram-bridge
Features
- 🧵 Per-chat/topic sessions — each topic (forum / DM topic) is its own session; bot replies land in the same thread.
- 📌 Topics —
message_thread_id, correct handling of the General topic (1),createForumTopic/editForumTopic/deleteForumTopic; auto-renames the topic to the session title. - 💬 DM Topics (Bot API 9.4) — topics right in a 1-on-1 chat, each an isolated session; root-DM lobby mode. (
DSH_TELEGRAM_DM_TOPICS) - 👥 Group gating —
require_mention,allowed_chats,allowed_topics,free_response_chats/topics,guest_mode,ignored_threads. - 🖼 Media in/out — accept photos/videos/voices/files/stickers; send files natively via
MEDIA:/pathtags. - ⌨️ Commands —
/new /reset /stop /sessions /last /model /status /unbind /help. - ✅ Status indicator Online/Offline (
setMyShortDescription). - 🛡 Tool-call filter — `` never leak into Telegram.
- 🔥 Polling resilience (409 conflict + exponential backoff).
- 🔘 Choice/clarify —
ask_user_question→ inline buttons (whenuserQuestionsis available). - 🌐 Bilingual — Russian and English (set
DSH_TELEGRAM_LANG=ru|en).
Install
> Requires: Node ≥ 22, dsh web with a model, and a bot from @BotFather.
# locally (from this machine)
dsh plugin --profile web add ./dsh-telegram-channel-local
# from the repository
dsh plugin --profile web add github:todayer/todayer-dsh-telegram-bridge
# or from tarball
dsh plugin --profile web add ./dsh-telegram-channel-0.3.5.tgz
Configuration (~/.dsh/telegram.env)
# required
DSH_TELEGRAM_TOKEN=123456789:AA... # from @BotFather
DSH_TELEGRAM_ALLOWED_USER_IDS=123456789 # your user id (from @userinfobot)
# optional — topics/groups
DSH_TELEGRAM_LANG=ru # ru | en
DSH_TELEGRAM_REQUIRE_MENTION=false
DSH_TELEGRAM_ALLOWED_CHATS=
DSH_TELEGRAM_ALLOWED_TOPICS=
DSH_TELEGRAM_FREE_RESPONSE_CHATS=
DSH_TELEGRAM_FREE_RESPONSE_TOPICS=
DSH_TELEGRAM_GUEST_MODE=false
DSH_TELEGRAM_IGNORED_THREADS=
# DM topics (JSON)
DSH_TELEGRAM_DM_TOPICS=[{"chatId":1212123,"topics":[{"name":"General"}]}]
# status indicator
DSH_TELEGRAM_STATUS_INDICATOR=1
DSH_TELEGRAM_STATUS_ONLINE=🟢 Online
DSH_TELEGRAM_STATUS_OFFLINE=🔴 Offline
Put these in the EnvironmentFile of the dsh.service and restart:
sudo systemctl restart dsh.service
Bot commands
| Command | Purpose |
|---|---|
/start |
Welcome / help |
/sessions |
List sessions by workspace + attach |
/new |
Create a new session (force-new) |
/reset |
Alias for /new |
/last |
Last turn of the bound session |
/model |
Switch model |
/status |
Current binding |
/stop |
Stop and detach |
/unbind |
Detach (without deleting) |
/help |
Full command list |
Structure
lib/
bridge.js — core logic (message handling, topics, sessions, commands)
client.js — Telegram Bot API client (polling, files, topics)
catalog.js — sessions/workspaces catalog
commands.js — commands and messages (bilingual)
format.js — formatting/cleanup (incl. stripToolCalls)
history.js — "last turn"
index.js — plugin registration (Config/inject)
...
License
MIT
Origin
Based on hi-wenw/dsh-telegram-channel. Mechanics extended following the Telegram gateway of Hermes Agent.
Русский: README.ru.md
