# opencode-telegram-bot

> OpenCode mobile client via Telegram: run and monitor AI coding tasks from your phone while everything runs locally on your machine. Scheduled tasks support. Can be used as lightweight OpenClaw alterna

- **URL**: https://www.freshcrate.ai/projects/opencode-telegram-bot
- **Author**: grinev
- **Category**: AI Agents
- **Latest version**: `v0.21.1` (2026-06-04)
- **License**: MIT
- **Source**: https://github.com/grinev/opencode-telegram-bot
- **Language**: TypeScript
- **GitHub**: 499 stars, 90 forks
- **Registry**: github
- **Tags**: `ai-agent`, `autonomous-agent`, `coding-agent`, `developer-tools`, `grammy`, `nodejs`, `openclaw`, `openclaw-alternative`, `typescript`

## Description

OpenCode mobile client via Telegram: run and monitor AI coding tasks from your phone while everything runs locally on your machine. Scheduled tasks support. Can be used as lightweight OpenClaw alternative.

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `v0.21.1` | 2026-06-04 | High | ## Release v0.21.1  ### Changes - Add sendMessageDraft streaming mode. ([@yaffalhakim1](https://github.com/yaffalhakim1)) - Add arabic localization. ([hbx12](https://github.com/hbx12))  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.21.0...v0.21.1 |
| `v0.21.0` | 2026-05-30 | High | ## Release v0.21.0  ### Changes - Add model search button. - Add /messages command and support for fork and revert for each message.  ### Fixes - Display minutes and hours in footer message. - Prevent message loss during rate limit retry. - Set default message update interval to 1000ms to prevent rate limit errors.  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.20.6...v0.21.0 |
| `v0.20.6` | 2026-05-19 | High | ## Release v0.20.6  ### Changes - Add multiple file attachments support.  ### Fixes - Forward permission requests from subagent sessions. ([@MysticCoss](https://github.com/MysticCoss)) - Recognize images in attached files.  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.20.5...v0.20.6 |
| `v0.20.5` | 2026-05-16 | High | ## Release v0.20.5  ### Fixes - Prevent stale busy state after interruption. - Scheduled task falsely reports empty assistant response due to race condition in executor polling.  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.20.4...v0.20.5 |
| `v0.20.3` | 2026-05-10 | High | ## Release v0.20.3  ### Changes - TELEGRAM_API_ROOT + TELEGRAM_PROXY_SECRET for reverse-proxy setups. ([@avfirsov](https://github.com/avfirsov))  ### Fixes - Allow forcing IPv4 for direct requests.  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.20.2...v0.20.3 |
| `v0.20.1` | 2026-05-07 | High | ## Release v0.20.1  ### Fixes - Prevent stuck busy state after reconnect.  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.20.0...v0.20.1 |
| `v0.19.1` | 2026-05-01 | High | ## Release v0.19.1  ### Changes - Display model in scheduled task details. - Add footer to scheduled tasks response.  ### Fixes - Ignore unrelated callbacks before busy check. - Auto-prune stale session directories on full sync. ([@georgernstgraf](https://github.com/georgernstgraf)) - Fix logs rotation. - Display error when scheduled task requires user approve action.  ### Technical - Use promptAsync to avoid false OpenCode send failures. ([@doer-ee](https://github.com/doer-ee)) - |
| `v0.19.0` | 2026-04-26 | High | ## Release v0.19.0  ### Changes - Add Google Cloud TTS provider and markdown stripping. ([@georgernstgraf](https://github.com/georgernstgraf)) - Add /mcps command to display and manage mcp servers. - Add optional opencode server monitoring and auto-restart.  ### Fixes - Remove the duplicate message about the subagent completion. - Fix subagent tool calls display. - Don't pin existing status message on bot startup. - Use custom markdown formatter and remove telegram-markdown-v2 depende |
| `v0.18.0` | 2026-04-22 | High | ## Release v0.18.0  ### Changes - Add support following a live OpenCode CLI session  ### Technical - Refresh lockfile for security fixes. ([@takaok5](https://github.com/takaok5))  ### Documentation - Add link to Telegram Community to README.md.  Full changelog: https://github.com/grinev/opencode-telegram-bot/compare/v0.17.0...v0.18.0 |
| `v0.17.0` | 2026-04-17 | High | ## Release v0.17.0  ### Changes - Add /worktree command to switch worktrees for project. - Add /skills command. - Add configurable STT note for transcriptions.  ### Fixes - Manage local server without stored pid. - Make config wizard preserve .env template structure. - Fix scheduled tasks timeout after 5 minutes.  ### Documentation - Add note that main branch may contain unreleased changes. - Add Karpathy-Inspired rules to AGENTS.md.  Full changelog: https://github.com/grinev/ope |

## Citation

- HTML: https://www.freshcrate.ai/projects/opencode-telegram-bot
- Markdown: https://www.freshcrate.ai/projects/opencode-telegram-bot.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/opencode-telegram-bot/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._