dsh-telegram-bot
Telegram 会话、主题、模型控制和审批，用于 DeepSeek Harness。
插件会安装到这里；不确定时保持 web。
npx -y @deepseek-ai/dsh plugin --profile web add dsh-telegram-bot@0.1.9
Telegram Bot 以 dsh-telegram-bot 发布，当前版本为 0.1.9。Plugin Hub 会校验它的 manifest，并保存精确安装来源，便于复现安装结果。
Telegram client for DeepSeek Harness. It connects a DSH profile to a Telegram bot and keeps the same DSH sessions available in both interfaces.
First setup: https://youtu.be/QEeVucfBsWk
Installation, bot token, the allowlist, /start, /sessions and a test prompt.
BotFather: Bot Settings → Threaded mode → Enable
BotFather: Bot Settings → Threaded mode → Enable.
/sessions lists workspaces and existing sessions, and can create a new session in a selected workspace.ask_user_question support: options, multi-select, custom answers and plan review./last, /rename, /fork, /stop, /restart, /status and /menu./fork [name] creates a DSH session fork in a new Telegram topic; without a name it uses the previous title plus the branch number.(N).0.2.1-rc.2 or newer, Node.js 22+.From this repository:
npx @deepseek-ai/dsh plugin --profile web add .
From npm:
npx @deepseek-ai/dsh plugin --profile web add dsh-telegram-bot@latest
Restart dsh web after installing or updating the plugin. Then open Settings → Telegram.
| Field | Meaning |
|---|---|
| Bot token | Token from @BotFather; stored in the credential store |
tokenRef | Credential/env name for the token; default TELEGRAM_BOT_TOKEN |
cwd | Working directory for Telegram-created sessions |
agentPreset | Preset mounted for Telegram sessions; default standard |
| Allowed users | Telegram user ids or @usernames |
| Allowed chats | Telegram chat ids or @channelnames |
| Show model thinking | Show reasoning in a temporary message |
| Show tool calls | Show tool calls in a temporary message |
| Bot language | en (default) or ru |
| Enable bot | Start or pause Telegram polling |
The token field only reports whether a token is configured. A token supplied through the environment cannot be overwritten from the page.
/start in All. With an empty allowlist the bot replies with your user and chat ids./sessions in All, choose a workspace and open or create a session.An ordinary message in All creates a new session topic in the default workspace. Commands such as /sessions, /fork and /last still work in All.
The plugin page is informational. It points to Settings → Telegram and lists the manual configuration files. Use the bundle switch there to enable or disable the plugin; Enable bot is a soft pause that keeps the plugin loaded but stops polling.
The bot can run without the Web UI:
mkdir -p ~/.dsh/profiles/tg
cd ~/.dsh/profiles/tg
package.json:
{
"name": "dsh-profile-tg",
"private": true,
"dependencies": { "dsh-telegram-bot": "latest" },
"dsh": {
"profile": {
"bundles": ["@deepseek-ai/dsh-base", "dsh-telegram-bot"]
}
}
}
cordis.patch.yml:
- id: telegram-bot
name: dsh-telegram-bot
config:
enabled: true
allowedUsers: ["<user-id>"]
allowedChats: ["<chat-id>"]
Install and run:
npm install
printf 'TELEGRAM_BOT_TOKEN=%s\n' '<token>' >> ~/.dsh/.env
chmod 600 ~/.dsh/.env
npx @deepseek-ai/dsh --profile tg
Do not put the token in cordis.patch.yml.
409 Conflict.No build step is needed.
npm install
node --check index.js
node --check client.js
npm test
index.js is the Host half: Telegram polling, topic routing and the session bridge. client.js registers the Settings page and the Plugins-page note. The plugin adds no model-facing tools or system-prompt text; it connects Telegram to the existing DSH agent.
MIT
Markdown to Telegram formatting uses telegramify-markdown (MIT).