Connect DeepSeek Harness to Telegram: dsh-im tutorial

Quick start

If DSH is already installed, start at step 1. The end result is a message entering local DSH, a completed DSH task, and a reply returning to the same platform.

1. Install dsh-im.
2. Restart dsh web and open Settings → IM Bot.
3. Choose Telegram and complete QR or credential binding.
4. Send /status, then send a read-only task.

Step 1 — install dsh-im

Run this on the same computer where DSH is installed. The author recommends the published npm release.

dsh plugin --profile web add -w @xmanrui/dsh-im

After it finishes, restart the Web Profile:

dsh web

If the terminal cannot find dsh, prefix the command with npx @deepseek-ai/dsh. Do not use the GitHub-source install by default; use it only for unreleased code:

npx -y github:xmanrui/dsh-im install

Refresh the browser and open Settings → IM Bot. Full instructions: dsh-im README.

Step 2 — connect Telegram

Create the Bot in Telegram first, then enter the Token returned by BotFather in the DSH Telegram card.

1. Open @BotFather, send /newbot, and choose the display name and username.
2. Copy the Token from BotFather and paste it only into local DSH settings.
3. Choose an access mode on the DSH Telegram page. private-allowlist is the safest first choice.

Platform reference: BotFather.

Step 3 — send the first task

In the Telegram DM with the Bot, send these three messages in order. The first checks the connection, the second clears the old session, and the third runs a read-only task.

/status
/new
只读任务：列出当前工作区根目录的文件名，不要修改任何文件。

1. `/status` should return the connection status between the Bot and DSH.
2. The third message should receive a final reply and create a new Session in DSH Web.
3. Repeat once with an unauthorized account and confirm that it does not trigger a task.

Telegram troubleshooting

Security

• Tokens, App Secrets, QR sessions and the WhatsApp auth directory are credentials. Never commit or publish them.
• Start with a workspace that has no production secrets and keep access minimal. An IM message can trigger local files, commands and tools.
• dsh-im is a community plugin. Re-read its README and changelog before upgrades; it is not an official platform integration.