@blue/dsh-telegram-bot
English · 简体中文
A minimal single-purpose DeepSeek Harness (dsh) plugin: connect a Telegram bot to your dsh agent via long polling — no public endpoint needed.
Inspired by dsh-im-hub, but reduced to Telegram only: one adapter, no web settings card, no HTTP webhook surface.
- One agent per chat (
telegram:<chatId>), multi-turn context retained.
- Agent-preset mounting: set
agent.preset and the bot's sessions mount that preset, getting the same tools (bash, fs, ssh, ...) as a Web GUI session.
- Whitelist access control (
allowedUserIds).
- Slack-style commands:
/help /reset /status /model.
- Long replies split at Telegram's 4096-char limit.
- Idle chats disposed after
agent.idleTimeoutMs.
Install
dsh plugin --profile web add @blue/dsh-telegram-bot
The row is disabled by default. Enable it from the profile's cordis.patch.yml:
- id: dsh-telegram-bot
disabled: false
config:
telegram:
token: '123456:ABC-DEF...' # from @BotFather
allowedUserIds: [6354114195] # your numeric Telegram user id
agent:
preset: standard # mount the standard preset for full tools
Then restart the profile (dsh web).
Configuration
| Key | Default | Description |
|---|
enabled | true | Master switch. |
telegram.token | '' | Bot token from @BotFather. |
telegram.allowedUserIds | [] | Numeric user ids allowed to talk to the bot; empty = everyone. Set it in production. |
telegram.timeoutSeconds | 50 | getUpdates long-poll timeout. |
telegram.pollIntervalMs | 500 | Gap after a poll timeout/error. |
agent.cwd | '' | Working directory for agent sessions (defaults to dsh's cwd). |
agent.provider / agent.model | '' | Override model; empty = deployment default. |
agent.preset | '' | Agent preset id to mount for bot sessions ('' = deployment default). |
agent.maxMessageLength | 4000 | Max chars per outbound message. |
agent.idleTimeoutMs | 1800000 | Idle time before a chat's agent is disposed (0 = never). |
agent.instructionPrefix | '' | Prefix prepended to every user message. |
Commands
| Command | Effect |
|---|
/help | Show command help. |
/reset | Clear this chat's context (fresh agent). |
/status | Show active chats / agents. |
/model | Show the current model selection. |
Security
- Force a whitelist. An empty
allowedUserIds means anyone with the token can drive your agent — which can execute tools on the host.
- The token lives in the profile's
cordis.patch.yml; keep that file private (or reference an environment variable via !!js process.env.TG_BOT_TOKEN).
License
MIT
