opencode-telegram-bot
透過 Telegram 的 OpenCode 行動用戶端:在手機上執行與監控 AI 編碼任務,所有運算皆在本機端進行。支援 OpenCode V2。
opencode-telegram-bot 是什麼?
透過 Telegram 的 OpenCode 行動用戶端:在手機上執行與監控 AI 編碼任務,所有運算皆在本機端進行。支援 OpenCode V2。
opencode-telegram-bot 概覽
這是什麼
OpenCode Telegram Bot 是一個 Telegram 客戶端,用於在本地機器上運行的 OpenCode CLI。它讓您可以從手機執行 AI 編碼任務、監控進度、切換模型以及管理工作階段。該機器人僅與本機的 OpenCode 伺服器和 Telegram Bot API 通訊,無需開放端口或暴露 API。支援 macOS、Windows 和 Linux。
主要功能
- 支援 OpenCode V2 — 同時相容 OpenCode V2 和經典 V1。
- 遠端編碼 — 從任何地方發送提示給 OpenCode,接收包含程式碼檔案的完整結果。
- 工作階段管理 — 建立新工作階段或繼續現有工作階段。
- 即時狀態 — 固定訊息顯示當前專案、模型、上下文使用量和已變更檔案列表,即時更新。
- 模型切換 — 從 OpenCode 收藏和最近歷史中選擇模型,或按提供者瀏覽所有模型。
- 排程任務 — 排程提示在稍後或定期執行。
- 語音提示 — 發送語音/音訊訊息,透過 Whisper 相容 API 轉錄。
- 檔案附件 — 傳送圖片、PDF 文件和文字檔案給 OpenCode。
- 安全性 — 嚴格的使用者 ID 白名單;其他人即使找到機器人也無法存取。
- 在地化 — 支援多種語言的 UI 在地化(英文、阿拉伯文、德文、西班牙文、法文、印尼文、義大利文、韓文、葡萄牙文、俄文、土耳其文、簡體中文)。
使用情境
- 從手機執行 AI 編碼任務,而程式碼在本地機器上運行。
- 遠端監控 OpenCode CLI 工作階段的即時進度。
- 排程提示在稍後或定期執行。
- 管理多個工作階段、切換模型,並透過 Telegram 與代理問題互動。
快速開始
先決條件:Node.js 22.14+、已安裝 OpenCode,以及從 @BotFather 取得的 Telegram Bot Token。 使用 npx 快速啟動: bash npx @grinev/opencode-telegram-bot@latest 或者全域安裝: bash npm install -g @grinev/opencode-telegram-bot opencode-telegram start 如果未透過環境變數或 .env 檔案提供設定,機器人會以互動方式引導您完成設定。
授權與價格
本專案為開放原始碼,採用 MIT 授權。未提及價格資訊,可免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。