Telegram Bot
Connect a Telegram bot and talk to your OpenCode server from anywhere — your phone, another computer, away from your desk.
- Create a bot with @BotFather on Telegram and copy the token.
- In the app, go to Settings → Integrations → Telegram and paste the token.
- Start chatting with your bot — it talks to your OpenCode server.
What it supports
Section titled “What it supports”- Background execution — every request that triggers the model runs as a background task. A long-running command never blocks the bot.
- Parallel or queued — if a new message arrives while a task is running, the bot asks whether to run in parallel (separate session) or wait in queue (same conversation).
- Approvals in chat — permission requests and skill questions (e.g.
/grill-me) are approved with buttons right in the chat. - Media — send photos and audio/voice messages.
- Stuck-turn protection — if a turn gets stuck (e.g. an unanswered question), it cancels itself after 10 minutes and tells you in the chat.
Bot commands
Section titled “Bot commands”| Command | Action |
|---|---|
/new |
Start a new session |
/cancel |
Cancel the running task immediately |
/repo |
Switch the repository the bot works on |
/model |
Switch the chat model |
/model-subagent |
Choose a different model for background tasks |
Custom skills work too — the bot is a full client of your OpenCode server.