caspian-connect-telegram
Connect Caspian Telegram for OpenCode, enable telegram in caspian.json channels, and tell the user to restart. Use when linking a Telegram bot or running /caspian:connect-telegram.
Source facts
- Repository
- TryCaspian/caspian-sdk
- Last source activity
- July 25, 2026 at 12:40
- Detected SKILL.md language
- English
- Stars
- 973
- Forks
- 137
Install options
The review-first prompt is selected by default. You can switch to a direct command or download a local copy.
Review the source files
Read SKILL.md and any companion files shown by SkillsMP before deciding whether to install.
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview- name
- caspian-connect-telegram
- description
- Connect Caspian Telegram for OpenCode, enable telegram in caspian.json channels, and tell the user to restart. Use when linking a Telegram bot or running /caspian:connect-telegram.
- license
- Apache-2.0
- compatibility
- opencode
- metadata
- {"alias":"caspian:ConnectTelegram","channel":"caspian"}
# Caspian connect Telegram
Connect a Telegram bot to Caspian and enable `telegram` in the plugin admit
list (`channels` in `~/.config/opencode/caspian.json`). Without `telegram` in
`channels`, Telegram events are rejected at admit (blast-radius wall).
## When to use
- User asks to connect Telegram / BotFather / Telegram bot
- User runs `/caspian:connect-telegram` or `/caspian-connect-telegram`
## Prerequisites (token)
Bot token must exist in **one** of (prefer file over chat):
1. `TELEGRAM_BOT_TOKEN` in the environment
2. Project `.env` → `TELEGRAM_BOT_TOKEN=...`
3. `~/.config/opencode/caspian.env` → `TELEGRAM_BOT_TOKEN=...`
Do **not** store the token in `caspian.json`. Prefer not pasting the token into chat.
## How
1. Call **`caspian_connections`** to see if Telegram is already linked and whether
`telegram` is already in plugin channels.
2. Call **`caspian_connect_telegram`**.
3. If the tool asks for a token, instruct the user to create a bot with
@BotFather, write `TELEGRAM_BOT_TOKEN=...` into `.env` or `caspian.env`, then
re-run the command. Do not invent a token.
4. On success, present connection id / channels. If **RESTART REQUIRED**, say:
> Restart OpenCode (quit and relaunch) so admit loads
> `"channels": ["email", "telegram"]` (or your updated list). Until then,
> Telegram messages are still rejected.
5. After restart, Telegram inbound should flow into OpenCode like email.
View on GitHub