OpenCode Telegram Bot CLI
Телеграм-бот для OpenCode: ставит задачи агенту, следит за ходом работы и переключает модели с телефона, пока OpenCode работает на вашем компьютере
- 1 296 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Через чат Телеграма отправляются промпты агенту, который правит файлы и запускает команды на вашем компьютере
- Токен бота и идентификатор пользователя лежат в файле .env, а локальные JSON-команды исполняются в оболочке с правами бота
- Файлы проекта можно скачивать из чата командой /ls, а вложения уходят в агент и в сервис расшифровки голоса
Установка
- Работает в
- Сервисы
В терминале, через SkillFoxx CLI
npx skillfoxx add cli/opencode-telegram-botОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Через чат Телеграма отправляются промпты агенту, который правит файлы и запускает команды на вашем компьютере
- Токен бота и идентификатор пользователя лежат в файле .env, а локальные JSON-команды исполняются в оболочке с правами бота
- Файлы проекта можно скачивать из чата командой /ls, а вложения уходят в агент и в сервис расшифровки голоса
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Бот подключается к локальному серверу OpenCode и показывает его возможности в чате Телеграма. Запускается он командой npx @grinev/opencode-telegram-bot@latest. Если настроек нет, мастер спросит язык, токен бота от @BotFather, ваш числовой идентификатор пользователя, версию OpenCode и адрес его API. Открытых портов и внешних API у бота нет: он общается только с локальным сервером OpenCode и Bot API Телеграма. В чате вы отправляете запрос и получаете результат, а код приходит файлами. Команды /new, /sessions, /recent и /messages управляют сессиями, в том числе откатом и ответвлением от прошлого сообщения. Закрепленное сообщение показывает проект, модель, расход контекста и список измененных файлов. Бот переключает режимы Plan и Build, модели из избранного, запускает пользовательские команды и навыки OpenCode и принимает ответы на вопросы агента и разрешения кнопками. Еще бот принимает голосовые сообщения через совместимый с Whisper API, картинки, PDF и текстовые файлы, листает файлы проекта командой /ls и запускает задачи по расписанию с интервалом от 5 минут. Работает с классическим OpenCode V1 и новым V2.
Для кого. Для тех, кто работает с OpenCode на своем компьютере и хочет ставить ему задачи и отвечать на его вопросы с телефона через Телеграм.
Подходит, если
- Длинная задача идет на домашнем компьютере, а вы вышли из дома и хотите видеть прогресс и ответить на запрос разрешения
- Нужно запланировать повторяющийся промпт, например проверку проекта каждый час, и получать итог в чат
- Вы диктуете задачу голосом, а бот расшифровывает ее через Whisper-совместимый API
- Надо переключить модель или режим Plan и Build в уже идущей сессии, не подходя к терминалу
- Нужно следить за сессией, которую вы начали в консольном OpenCode, и продолжить ее из чата
Не подходит, если
- Ваш агент — Claude Code или Codex: бот управляет только сервером OpenCode
- Компьютер с OpenCode выключен или засыпает: бот работает на той же машине и без нее ничего не сделает
- Нельзя хранить токен Телеграм-бота и идентификатор пользователя на рабочей машине
- Нужен доступ для нескольких людей: бот пускает только одного пользователя из белого списка
Пример запроса к агенту
Запусти тесты в проекте, а если они упадут, исправь причину и пришли мне список измененных файловОграничения
- Нужны Node.js 22.14 или новее и установленный OpenCode с запущенным сервером, обычно командой opencode serve.
- Версию сервера задают переменной OPENCODE_SERVER_VERSION, бот ее не определяет сам. Сессии V1 и V2 не переносятся друг в друга.
- Для V2 обязателен пароль сервера, для V1 он необязателен.
- Токен бота и идентификатор пользователя хранятся в файле .env на вашей машине.
- Локальные JSON-команды из папки local-commands выполняются в оболочке с правами бота, их файлам нужно доверять как коду.
- В описании проекта отмечено, что страница следует за веткой main и может описывать еще не выпущенные возможности.
Как отключить. Остановите бота командой opencode-telegram stop, если запускали его в фоне, или завершите процесс. Удалить пакет можно командой npm uninstall -g @grinev/opencode-telegram-bot. Токен бота отзовите у @BotFather, а файл .env с настройками удалите вручную.
Частые вопросы
Как поставить Telegram-бота для OpenCode?
Создайте бота у @BotFather и скопируйте токен, узнайте свой числовой идентификатор у @userinfobot, запустите opencode serve и выполните npx @grinev/opencode-telegram-bot@latest. Мастер спросит недостающие значения.
Работает ли бот с OpenCode V2?
Да. Укажите OPENCODE_SERVER_VERSION=v2, по умолчанию стоит v1. У V2 адрес по умолчанию http://127.0.0.1:49374, и пароль сервера обязателен: его выдает opencode service get password.
Как продолжить из Телеграма сессию, начатую в терминале?
Бот отслеживает выбранную сессию. С V2 это работает сразу, с V1 консольный OpenCode нужно запустить на том же порту, например opencode --port 4096, и выбрать ту же сессию в боте.
Кто еще сможет писать моему боту?
Никто. Доступ идет по белому списку: бот отвечает только пользователю с идентификатором из TELEGRAM_ALLOWED_USER_ID, даже если другой человек найдет бота.
Можно ли запускать задачи по расписанию?
Да, командой /task. Минимальный интервал повтора 5 минут, по умолчанию доступно до 10 задач и ожидание одного запуска до 120 минут. Лимиты меняют переменные TASK_LIMIT и SCHEDULED_TASK_EXECUTION_TIMEOUT_MINUTES.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
Telegram — все инструментыПодключает Claude Code, Cursor, Codex или OpenCode к Telegram, Slack и Discord: коллеги пишут боту, отвечает кодовый агент
Claude-to-IM
claude-to-im
Мост между Claude Code или Codex и мессенджерами: общайтесь с агентом из Telegram, Discord, Feishu, QQ или WeChat
Самостоятельный сервис для наблюдения за Claude Code и Codex и одобрения их действий из Telegram, Feishu или веб-терминала
Telegram API MCP
telegram-api-mcp
MCP-сервер для Telegram Bot API: сообщения, каналы, форумы, платежи и длинные посты от имени бота с учетом лимитов Telegram
Контент-завод для пяти площадок
Content Factory
Скилл OpenCode с четырьмя субагентами: из темы урока собирает пост для Telegram, VK, Дзена, блога и LinkedIn с обложкой, публикует пока только в Telegram
Скилл и CLI для экспорта и нечеткого поиска по истории Telegram: локальная база, векторный поиск, только чтение
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
Коротко о README
Страница проекта представляет бота как безопасный клиент OpenCode в Телеграме, который работает на вашей машине без открытых портов. Дальше идут список возможностей, требования, три шага запуска: создать бота, поднять сервер OpenCode, выполнить npx. Затем расписаны установка глобально, фоновый режим, таблица команд, откат и ответвление сессий, задачи по расписанию, отслеживание живой сессии, разница между OpenCode V1 и V2 и таблица переменных окружения. Бот переведен на 12 языков, включая русский.