dsh-connect-telegram
English | 中文
Telegram channel adapter for dsh-connect: brings DeepSeek Harness agents into Telegram with the same capabilities as the Feishu adapter — bidirectional conversation, streaming typewriter-style replies, interactive choice prompts, image/file intake, and completion cards.
- Transport: official Telegram Bot API via
getUpdates long polling (no webhook / no public IP needed).
- Bidirectional: private chats and groups; group replies require @-mention (configurable).
- Streaming replies: long answers are edited in place on one message (typewriter feel).
- Interactive choices:
ask_user_question / menu prompts render as inline-keyboard buttons; tapping answers the question.
- Media: photos, documents, voice, video and audio are downloaded and staged into the workdir automatically.
- Zero runtime HTTP dependency: built on the global
fetch (Node ≥ 18 / ≥ 20).
Install
dsh plugin --profile web add dsh-connect dsh-connect-telegram
Configure
Create a bot with @BotFather and copy the token. Append to the profile's cordis.patch.yml. The plugin registers itself via its bundle manifest, so only override its config — do not insert it again (duplicate ids crash dsh at boot):
- id: connect-telegram
name: dsh-connect-telegram
config:
botToken: "123456:ABC-YourBotToken"
requireMention: true # groups must @-mention the bot (default true)
language: zh # zh | en
The token may also come from the TELEGRAM_BOT_TOKEN environment variable.
How it works
Telegram user ──getUpdates(long poll)──► dsh-connect-telegram ──InboundMessage──► dsh-connect (agent)
Telegram user ◄──sendMessage / editMessageText ◄────── dsh-connect (replies)
All user-facing strings are localized (zh/en) through the core's i18n layer; per-chat language, notification levels, /menu, /progress watchdog and every other core feature work the same as Feishu.
Configuration reference
| Key | Default | Description |
|---|
botToken | env TELEGRAM_BOT_TOKEN | BotFather token |
requireMention | true | Groups: require @-mention or a reply to the bot |
language | zh | User-facing message language |
pollingTimeoutSeconds | 50 | getUpdates long-poll timeout |
baseUrl | — | Bot API base URL override (local Bot API server) |
