opencode-telegram-bot

手机遥控本地 AI 编程，随时监控任务进度

开源 🏷️完全免费 🔧 仅开源项目，无在线服务，需自行部署智能体 🍴 复刻 251 🐛 待处理 33 👀 关注 10

GitHub ↗

GitHub 星标 ★ 1344

维护状态活跃

是否开源开源

定价模式 🏷️完全免费开源项目，MIT 许可证，本地运行，完全免费。

项目预览

opencode-telegram-bot 项目界面预览图 — 图片来源：GitHub 官方仓库名片

项目数据

分类智能体

开发团队grinev

GitHubhttps://github.com/grinev/opencode-telegram-bot

定价模式🏷️完全免费

价格说明开源项目，MIT 许可证，本地运行，完全免费。

访问状态🔧 仅开源项目，无在线服务，需自行部署

是否开源是

开源协议MIT

主要语言TypeScript

技术栈/模型ai-agent,autonomous-agent,coding-agent,developer-tools,grammy,nodejs,openclaw-alternative,opencode,telegram,telegrambot,typescript

GitHub 星标★ 1344

上线时间2026-02-09 00:00:00

代码更新2026-11-06

仓库体积16.1 MB

本站数据更新2026-11-09

维护状态活跃

收录时间2026-08-09

浏览次数6

项目介绍

这是一个将 AI 编程助手 OpenCode 接入 Telegram 的移动客户端桥接工具。它解决的核心问题是：开发者无法随时随地查看和操控本地运行的 AI 编程任务。通过 Telegram 机器人，用户可以在手机上发送指令，启动、监控和干预本地机器上的 OpenCode 编码任务，所有计算和代码操作仍在本地完成，确保代码安全。项目基于 Node.js 和 grammY 框架构建，支持任务调度（定时运行），并提供任务状态推送、结果查看等能力。它本质上是一个远程控制面板，让 AI 编程从桌面延伸到移动场景，适合需要在外出时管理长时间运行任务的开发者。

Star 增长趋势

本站每日记录该项目 GitHub 星标变化，观测越久曲线越完整

数据来源：GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1344

技术标签

ai-agent autonomous-agent coding-agent developer-tools nodejs

使用教程

难度：入门约 10 分钟部署方式：命令行工具 8 步

环境要求

已在本机安装并运行 OpenCode（本地 OpenCode 服务器，默认端口 4096）
Node.js 环境（可用 npx / npm）
一个 Telegram Bot Token 和你的 Telegram 用户 ID
系统为 macOS、Windows 或 Linux

安装与启动步骤

1启动 OpenCode 服务

机器人需要连接本地 OpenCode 服务器，先在宿主机启动它并监听 4096 端口，再启动机器人。
```
opencode serve --port 4096
```
2快速运行机器人

最快方式，直接用 npx 运行，无需克隆仓库。注意不要在源码仓库根目录执行，否则会报 opencode-telegram: not found。
```
npx @grinev/opencode-telegram-bot@latest
```
3完成向导配置

若未通过环境变量或 .env 提供配置，会出现交互向导：依次填写界面语言、Bot Token、用户 ID、OpenCode API URL，以及可选的服务器用户名/密码。
4全局安装方式

也可以全局安装后使用 start 命令。前台模式推荐用于 systemd、Docker 和本地调试等外部进程管理场景。
```
npm install -g @grinev/opencode-telegram-bot
opencode-telegram start
```
5后台守护模式

内置后台模式适合没有外部进程管理器的独立 npm 安装场景，可启动、查看状态和停止。
```
opencode-telegram start --daemon
opencode-telegram status
opencode-telegram stop
```
6随时重新配置

需要修改 Bot Token、用户 ID 或 OpenCode 地址等配置时，运行 config 命令重新进入配置流程。
```
opencode-telegram config
```
7从源码运行

克隆仓库、安装依赖并复制环境变量模板，之后按 Development 章节说明启动（不要用 npx）。
```
git clone https://github.com/grinev/opencode-telegram-bot.git
cd opencode-telegram-bot
npm install
cp .env.example .env
```
8Docker 部署准备

镜像只包含 Telegram 机器人，OpenCode 必须已在宿主机运行。克隆后复制 .env 并按 Configuration 小节填写环境变量。
```
git clone https://github.com/grinev/opencode-telegram-bot.git
cd opencode-telegram-bot
cp .env.example .env
```

关键配置

配置项	必填	说明	示例
`OPENCODE_API_URL`	是	OpenCode 服务器地址；Linux 默认 compose 下经 host 网络访问	`http://127.0.0.1:4096`
`OPENCODE_MODEL_PROVIDER`	否	默认模型提供方，与 Model ID 组合后固定出现在模型收藏中	`anthropic`
`OPENCODE_MODEL_ID`	否	默认模型 ID，与 Provider 组合使用	`claude-sonnet-4`
`OPENCODE_TELEGRAM_CONTAINER`	否	Docker Compose 自动设为 1，提示哪些命令需要宿主机文件系统	`1`
`INITIAL_SETTINGS_PRESET`	否	以 JSON 设定初始默认设置，仅影响尚未持久化的键	`{"showAssistantRunFooter":false,"compactOutputMode":true,"tt`
`MAX_QUEUED_PROMPTS`	否	消息队列上限，默认 5 条，队列在 /abort 或切换会话时清空	`5`