Skip to main content

How to use telegram

Bridge to the Telegram Bot API: long polling, per-chat sessions, HTML formatting.

This article is auto-derived from indexed fields (wiki / faq / compatibility_json), not freshly AI-generated.

This article is derived from the plugin's already-indexed fields (wiki / faq / compatibility_json / readme), not freshly generated by AI. Source field is noted at the end of each section.

Quick start

Bridge to the Telegram Bot API: long polling, per-chat sessions, HTML formatting.

— source: plugins.ai_summary

Install & verify

dsh plugin --profile web add github:LoserFox/telegram

Run the command above in your DSH Web Profile. Then enable the plugin in the plugin list.

— source: plugins.install

Key points

  • 插入行 id：telegram（cordis.patch.yml）；不声明模型面工具或技能——它是把 Telegram 聊天桥接到 agent 会话的后台服务插件。
  • 加载即需要 token：缺少 bot token（配置 token 或环境变量 DSH_TELEGRAM_TOKEN）时 apply 直接报错；没有 token 不会惰性启动。
  • 宿主前置条件：dsh 组合必须挂载 agents 服务（@deepseek-ai/dsh-agent）；LLM 适配器、会话与工具来自外围 cordis.yml（见 telegram-agent 示例）。
  • 卸载：dsh plugin --profile web remove telegram。
  • 安装后需重启目标 profile 的 DSH 进程（组合层变更不参与 HMR 热更新）。

— source: plugin_wiki.readme_en (fallback readme_raw)

Pitfalls

Review the upstream repo before installing. This guide is auto-derived from indexed fields and may lag the latest release. If anything contradicts the official docs, treat the upstream source as authoritative.

— source: general rule