把 AI Agent 接上 Telegram：Hermes Agent、Claude Code、Codex、OpenCode 四種架構比較

Agent 跑在主機、指令從手機下：這件事具體長什麼樣子

想像一個畫面：早上 8 點 40 分，你在捷運上打開 Telegram，對著麥克風說一句「幫我把昨天那份報價單的單價換成新方案，寄給王先生」。這句話幾秒內變成文字，送到公司主機上跑著的 Agent，它在伺服器裡開檔、改數字、準備寄信，而你手上只有一支手機。這就是「運算留在主機、介面帶在身上」的實際長相，不必背一台兩公斤的筆電出門。

語音訊息送出去後，Premium 的語音轉文字會先把它變成一段提示詞（prompt，就是丟給 AI 的指令文字），Agent 收到才開始動作。接著對話框裡不是轉圈圈等 30 秒，而是文字一行一行長出來，這就是官方說的串流回覆（Streaming Replies）。它理解錯了，你按一下 Stop 就能當場喊停。

當 Agent 要動到正式檔案或要對外寄信，它會把一顆審批按鈕推到你手機上，你按了同意它才繼續。等於把「AI 能不能自己決定」的權力留在人手上。同一支手機還能同時掛好幾件案子，每件事各佔一個對話主題，客服、報表、寫稿平行跑，互不干擾。

四個介面，對上四種很現實的需求

官方在 2026 年替 AI 補上的四項 Bot 介面，剛好一對一對上跑 Agent 會遇到的四件事，來源都在 Bot API 更新紀錄與 官方 Bot 功能總覽裡。

• 串流回覆（Bot API 10.1，2026-06-11）：對上「等半天不知道它在幹嘛」。邊生成邊顯示，還沒產出時顯示 Thinking，使用者可以中途喊停。
• Bot 對 Bot 互聊（2026-05-07 公告）：對上「一支 Agent 不夠用」。讓一個 Agent 派任務給另一個專門的 Agent，串成全自動流程。
• 私人小視窗（Ephemeral Messages，Bot API 10.2，2026-07-14）：對上「在群組裡不想洗版」。只有你看得到的那則回覆，適合個人化摘要，或把權限說明單獨留給你。
• 訪客機器人（Guest Bots，Bot API 10.0，2026-05-08）：對上「不想把 Bot 加進每個群」。它被 @ 才會回話，只看得到被標記的那則訊息，工具型服務用這個最省事。

四項放在一起看，AI 回話慢、內容長、常常需要人點頭、又常常得在群組裡低調運作，這四件事官方各自給了對應的介面。官方在 2026 年 5 月那則 AI Bot 大改版公告裡講得很直白：企業不用自己做 App，也能讓 AI 服務長在客戶每天開著的對話框裡。四項介面各自怎麼用，〈Telegram Bot 的 AI 功能全解：訪客機器人、Bot 對 Bot 互聊、串流回覆到群組守門員〉有完整拆解。

四種架構比一比：Hermes Agent、Claude Code、Codex、OpenCode

你手上在用的 AI 代理程式，要怎麼接到 Telegram？這類程式叫 Agent Harness（代理程式的執行外殼），負責跑模型、讀寫本機檔案、呼叫工具，Telegram 只是遙控器。核心邏輯一句話：運算留在主機或雲端，介面帶在身上。

我們在 2026-09-17 回官方文件與 GitHub 核對四家，重點有三個：是不是官方通道、要不要額外裝開發環境、斷線後還收不收得到訊息。

四家的接法與成熟度（2026-09-17 實查）

Claude Code 的安裝指令是 /plugin install telegram@claude-plugins-official，官方標明仍在研究預覽，session 關掉就等於斷線；Codex 靠社群橋接，星數少代表文件與踩雷經驗也少，要有自己讀原始碼的心理準備。

• 有沒有官方通道：有官方支援的，改版時有人幫你追；只有社群橋接的，Telegram 一改 API 你就得等別人修。
• 需不需要 session 一直開著：Claude Code 的「事件只在 session 開啟時送達」等於你得養一台常駐機器。
• 要不要收語音訊息：想講一段話就變成指令，就要挑支援語音的通道，Hermes Agent 明確支援；搭配 Premium 的語音轉文字更接近對著祕書講話。

更值得注意的例子是 OpenClaw。它以 Telegram 為主要通道，GitHub 星數已經突破三十萬，電報活躍 Bot 在 2026 年初一年內從三百萬暴增到八百萬，成長來源多指向它；〈Telegram 為什麼變成 AI Agent 主場：活躍 Bot 一年內從三百萬暴增到八百萬〉整理了那波成長的來龍去脈。挑工具就看這種訊號：人多、更新快的專案，遇到改版時修得比較快。

實際動手接：官方路線與社群橋接路線差在哪裡

功能看完，真正的問題是「怎麼接上去」。目前有兩條路：官方自己支援的，以及社群自己寫的橋接，差別不在功能多寡，而在誰負責維護。官方路線跟著產品更新，你升級就好；社群路線常由一兩個人在下班時間維護，作者不寫了，就得換你接手。

官方路線：內建通道與一行外掛指令

Hermes Agent 是 Nous Research 的開源代理，MIT 授權、自己架在主機上跑，它的 Telegram 通道屬於官方第一級支援。設定好之後，你在 Telegram 傳訊息它會回，語音訊息也收得到。裝法照官方文件走即可，只有一件事不能忘：bot token（等於 Bot 的密碼）要放在伺服器端的環境變數，不要寫進設定檔又上傳到版控。

Claude Code 走另一種官方路線，靠官方外掛 Channels掛上去，終端機輸入一行就裝好：/plugin install telegram@claude-plugins-official。裝完之後，Claude Code 在終端機的動態會推到 Telegram，你在手機就能看進度、直接回話。兩個卡點：它還在研究預覽階段；它需要 Bun 這個執行環境（一種跑 JavaScript 的工具），官方文件明寫事件只在工作階段（session）開著時送達，白話說就是 Claude 要一直掛在終端機或背景程序裡，關掉就收不到。

社群橋接路線：星數、裝法與自己扛的維護

Codex CLI 目前沒有官方 Telegram 通道，只能靠社群專案搭橋，比較常被提到的有三個：

• telecodex：約 42 顆星，功能單純、程式碼量小，適合自己讀懂之後再改。
• ccgram：約 265 顆星，走 tmux（終端機多工工具）這條路，同時支援 Claude Code 與 Codex CLI，2026 年 9 月還在更新，適合常切換多個終端機視窗的人。
• CliGate：主打審批橋接，Agent 要動檔案之前，先把「要不要同意」的按鈕推到 Telegram，你按了才繼續。

OpenCode 的社群解法更完整。grinev/opencode-telegram-bot 是用 TypeScript 寫的 OpenCode 手機端入口，約 1,160 顆星，2026 年 9 月還在更新，是目前這條路上最多人用的選擇；它也屬社群作品，Telegram 一改 API 就得等作者跟上。

替代方案有限公司觀點：自己跑 Agent 掛 Telegram 的真實取捨

我們公司內部的 AI Agent 就掛在 Telegram 上。每天早上固定時間推播業務日報，下午再送一份產業快訊，同事可以直接回話追問，也能用一句話下指令請它整理名單。這套東西沒有做 App、沒有上架商店、沒有付推播費，已經穩定跑了一段時間。這一節把做過的選擇與踩過的坑講清楚。

理由很務實。自己做 App，要先上架審核、要維護 iOS 與 Android 兩套版本、要處理推播憑證與各家手機廠牌的背景限制，推播量一大還要付費。改用 Telegram，這些全部由官方吸收：Bot 免費、推播免費、手機與桌機同步。更關鍵的是 Bot 本身就是一個 API，官方每次改版加功能（例如 2026 年 5 月那波 AI Bot 大改版），我們改幾行設定就能用，不必重新送審。

缺點也要講。台灣多數人的手機裡沒有 Telegram，內部溝通硬推會遇到阻力，所以我們的做法是「Agent 走 Telegram，人跟人的日常溝通照舊」，並保留一條電子郵件備援。如果你的客戶是一般消費者，直接叫他們裝 Telegram 是行不通的，這個介面比較適合內部作業與已經在用 Telegram 的客群。

金鑰外洩與 OpenClaw 的 CVE 教訓

我們自己遇過一次 API 金鑰被未授權使用。當時是帳單出現不合理用量，追查後確認金鑰在某個環節外流。處理步驟很固定：立刻撤銷那把金鑰、重新產生一組、把用量上限設成第二道防線，並確認新金鑰只放在伺服器端環境變數，不進前端、不寫進對話、不進版控。

2026 年 OpenClaw 的 CVE-2026-27003 更直接把這條紅線畫出來：它把 Telegram 的 bot token 寫進了錯誤訊息與堆疊追蹤，只要日誌被人看到，等於整支 Bot 被接管。結論是 Bot token 的位階要當成資料庫密碼看待，錯誤訊息寫入日誌前要先過一層遮蔽，並且定期盤點誰有權限讀日誌。

給台灣企業的落地建議：先用一個內部群組試跑兩週，把日報、審核按鈕這類低風險任務跑順，再逐步開放。Telegram 便宜好用是事實，但它不會幫你管資安。

台灣企業導入前要確認的事：費用、限制、詐騙觀感與資料落地

前面談 Telegram 能做什麼，這一章換成老闆的問法：費用、限制、詐騙觀感與資料落地。

費用與速率限制：工具免費，但有節流閥

Telegram 的 Bot API 免費，沒有 LINE 官方帳號那種依訊息則數計費的推播成本，對每天發日報、跑審核的內部工具是最直接的差別。（LINE 台灣自 2026 年 3 月起也推出每月 165 元的 Premium 會員方案，那是個人加值，跟推播計費是兩件事。）

但免費不等於無限制。官方對 Bot 送訊息設速率上限擋濫發，超過會回 429 錯誤（Too Many Requests）。

• 同一個群組或頻道：每分鐘約 20 則。
• 對不同使用者：每秒約 20 到 30 則。
• 官方建議把大量通知分散到 8 到 12 小時。
• 富文字訊息單則上限 32,768 字元，一般報告與報表夠用。

要對一萬人推送同一則訊息，排程得配合這個節奏。Telegram Premium 內購公定價每月 4.99 美元（App Store 與 Google Play），台媒換算約新台幣 150 到 160 元；走官方 @PremiumBot 最多便宜 4 成，因為省下 Apple 與 Google 手續費，金額以付款確認頁為準（Telegram 官方 FAQ，2026 年 9 月查核）。多數成員不需要 Premium，多是為了語音轉文字與單檔 4GB 上傳，值不值得訂可以對照〈Telegram Premium 值得訂嗎：十六項功能、內購與 @PremiumBot 價差、GrokAI 免費的真相〉。

台灣的兩道現實關卡：社交慣性與詐騙標籤

台灣幾乎人人有 LINE，NCC 的調查顯示 16 歲以上使用率 99.4%（2025 年公布），對外客服要客人搬過來不現實。2026 年 4 月 17 日它無預警上線官方繁體中文介面，使用者第一次不用另裝語言包、在設定直接切換，多家台灣媒體同日報導，是對台灣最明顯的在地化動作。

第二道關卡是詐騙。台灣對 Telegram 的負面印象多半來自投資詐騙群，做法是把可驗證的東西攤出來：官方帳號的 @username 公開寫在官網、不私訊索取帳密、不引導加入投資群。

資料落地：客戶要求資料不出境、不出內網，就得走自架 Bot API Server 或地端模型，不能直接接雲端 API。

常見問題 FAQ

Q：把 AI Agent 接上 Telegram，是代表我的程式跑在 Telegram 上嗎？那我不就要一直開著電腦？
不是，Agent 本身還是跑在你自己的主機或雲端，Telegram 只是你下指令跟看結果的介面，出門只帶手機就行。實際用起來是：手機用語音下指令，Agent 要動檔案或寄信時會把審批按鈕推回 Telegram，你按同意它才繼續做。四種架構的待命條件不一樣，Claude Code 的官方 Channels 外掛還在研究預覽階段、需要 Bun，官方文件也明寫事件只在 session 開著時才送達，想長時間待命就得讓它跑在背景程序或常駐終端機。

Q：這樣接安全嗎？我的資料跟金鑰會不會外流？
有兩個地方要分開看。Bot token 這串等於你整支 Bot 的控制權，只能放在伺服器端的環境變數。另一個是踩過的坑：開源 agent OpenClaw（GitHub 星數突破三十萬）就出過 CVE-2026-27003，原因是它把 Telegram bot token 寫進錯誤訊息與堆疊追蹤裡。如果客戶要求資料不出境或不出內網，就得改用自架 Bot API Server 或地端模型。

Q：Hermes Agent、Claude Code、Codex、OpenCode 到底差在哪？我該挑哪一個？
最直接的差別是「有沒有官方支援」。Hermes Agent（Nous Research）內建 Telegram 通道，官方文件列為第一級支援，MIT 開源、可自架。Claude Code 走官方 Channels 外掛，一行指令就能裝，但還在研究預覽階段。Codex CLI 沒有官方通道，得靠社群橋接，像 telecodex（42 星）、ccgram（265 星，同時涵蓋 Claude Code 與 Codex CLI），另外 CliGate 提供審批橋接。OpenCode 則是社群寫的 Telegram 客戶端 grinev/opencode-telegram-bot，1,160 星、TypeScript，2026 年 9 月還在更新。想少踩雷就從官方支援的開始。

📩 有任何問題或需要協助，歡迎聯絡我們：[email protected]