H
Hermes TG AI 秘書架構藍圖
BLUF 結論先行：光明正大、零封號、月費封頂、專治濕碎家務

多人共用 Telegram AI 秘書終極方案
Hermes Agent + OpenRouter + MECE 四大記憶庫

針對你提出嘅四大核心訴求（多人跨國共用唔怕 Block、不用國產模型、類似月費封頂體驗、完全無結構嘅立雜濕碎輸入），最佳解係將美國 Nous Research 開源嘅 Hermes Agent 部署喺單一海外 VPS，透過 OpenRouter（設定每月 $15-$20 硬上限） 呼叫 Claude 4.5 / 5 或 Gemini 2.5，並配合 Telegram Forum Topics（話題群組） 進行自動分揀歸檔。

痛點 01 / 跨國流量
用家來自不同國家怕被封？

解法：單點伺服器代理。 全球成員只同 TG 官方伺服器連線；真正向 AI 發出請求嘅只有你部東京/美西 VPS，AI 供應商眼中 100% 係合規海外流量。

痛點 02 / 預算控制
無得用個人月費怕爆煲？

解法：OpenRouter Credit Limit。 支援香港信用卡，為 TG Bot 專屬 API Key 設定每月自動重設硬上限（如 $15 USD），5-10 人日常使費實測僅約 $8-$12/月。

痛點 03 / 模型合規
堅持唔用國產 AI 模型？

解法：歐美官方路由鎖定。 透過 OpenRouter 底層直連 AWS Bedrock / Google Vertex AI，一鍵指定只用 Claude Haiku 4.5 / Sonnet 5 及 Gemini 2.5 Flash。

痛點 04 / 濕碎輸入
生日、格價、洗費亂咁噏？

解法：Hermes 四路分流。 隨口打字或錄廣東話語音，Agent 自動分揀入 MEMORY.md、lists/*.md、expenses.csv (Python 計數) 同 Cron 提醒。

Interactive System Architecture

Archify / LivePanel 動態系統架構與數據流圖

點擊上方按鈕切換 3 大核心運作場景，或直接點擊圖中任何組件節點 (Node) 在右側 LivePanel 檢視配置細節與數據封包。

全景模式：顯示所有組件與雙向數據管道
Layer 01 // 終端用家與 Telegram 官方雲端層 (完全隱藏用家真實國家 IP) MTProto Encrypted
Client Layer HK / UK / JP / CA
👨‍👩‍👦 跨國家庭 / 團隊成員
隨口輸入：廣東話錄音、文字、街市收據相片
TG Supergroup Privacy: OFF
💬 Telegram 話題群組 (Topics)
#日常速記(旁聽) #購物與旅行清單 #家居洗費記帳 #重要日子提醒
Long Polling (出站加密連線)
Layer 02 // 海外 VPS 核心層 (AWS Tokyo / US-West Docker 隔離環境) 100% 合規海外 IP
Auth & Voice Gatekeeper
🛡️ 白名單與旁聽網關
  • • 鎖死 ALLOWED_USERS
  • • 靜默旁聽群組背景對話
  • • 廣東話錄音自動轉文字
Hermes Agent AGENTS.md
🧠 意圖拆解與工具調度中樞

根據 AGENTS.md 守則，將單句立雜說話平行拆解為多個 Tool Calls 寫入對應檔案。

OpenRouter API Cap: $15/mo
⚡ 歐美模型路由 (月費封頂)
  • • 日常：Claude Haiku 4.5
  • • 語音/圖片：Gemini 2.5 Flash
  • • 複雜推理：Claude Sonnet 5
平行 Function Calling (MECE 四路分流)
Layer 03 // MECE 四大持久化記憶與排程層 (杜絕失憶、杜絕算術幻覺) ~/.hermes/ persistence
01 / 核心人物與背景
📘 MEMORY.md

記住屋企人稱呼、邊個個仔生日、常去街市、過敏與固定習慣（長駐 Prompt）。

02 / 動態清單與格價
📂 /workspace/lists/

獨立維護 travel.md、shopping.md、market_prices.md，支援隨時剔走。

03 / 家居洗費帳目
📊 expenses.csv + Py

每筆支出追加寫入 CSV，月結查詢時自動跑 Python pandas 計算，100% 零誤差。

04 / 歷史搜尋與提醒
⏰ state.db + Cron

SQLite FTS5 秒搜幾年前對話；Cron 排程喺生日前 3 日朝早自動彈通知落 TG。

Routing Simulator

濕碎輸入分揀模擬

揀下面任何一句「亂咁噏」嘅說話，睇 Hermes 會點樣拆成多個 Tool Calls、寫入邊個檔案、有咩後續動作。 核心原則：講嘢唔使有格式，歸檔由 Agent 負責；算術一律交 Python，唔靠模型心算。

模擬輸入（點擊試吓）
AGENT 解讀 揀一句輸入開始

未揀輸入。左邊點一句，呢度會顯示意圖拆解結果同四個目的地嘅實際寫入內容。

Deployment

六步部署實戰

全部指令都係官方路徑；照次序做，中途唔需要改任何源碼。

  1. 1

    開 Bot，取 Token

    Telegram 找 @BotFather → /newbot → 跟指示命名 → 取得 API token。順手做三個設定：/setcommands（指令選單）、/setdescription、/setprivacy（下一步要用）。

    123456789:AAExampleTokenDoNotUse_xxxxxxxxxxxxxxxxx

    ⚠️ Token 等於你部 bot 嘅鎖匙；洩漏就即刻 /revoke 換新。

  2. 2

    海外 VPS 安裝 Hermes

    東京或美西 VPS（1-2 vCPU / 2GB RAM 夠用），Docker 或裸機都可以。安裝腳本會自己搞掂 Python、依賴同 launcher，唔需要 sudo 污染系統。

    curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash hermes doctor

    hermes doctor 有紅字就要先解決，唔好帶病上線。

  3. 3

    接上 Telegram + 白名單

    跑 hermes gateway setup 揀 Telegram，貼 token 落 .env；再把你同家人嘅 Telegram 數字 user id 加入白名單（唔係 username）。dashboard 亦有 QR 一鍵建立。

    TELEGRAM_BOT_TOKEN=123456789:AA... TELEGRAM_ALLOWED_USERS=6709930151,8123456789

    取 user id 最快方法：叫 bot 接收你一句訊息，喺 gateway log 就見到 sender id。

  4. 4

    群組 + Topics 靜默旁聽（最易炒車嘅一步）

    Bot 預設有 Privacy Mode，只睇到 @mention 同回覆。要佢旁聽全群：BotFather → Bot Settings → Group Privacy → Turn off， 然後將 bot 踢出群再重新加入（Telegram 會 cache 加入時嘅權限，唔重加唔會生效）；或者更簡單——直接升佢做 group admin。

    platforms: telegram: allowed_chats: ["-1001234567890"] group_allowed_chats: ["-1001234567890"] require_mention: true observe_unmentioned_group_messages: true

    咁樣設定：全群對話會寫入共享 transcript 做背景上下文，但只會喺被 @mention／回覆 bot 時先真正回覆——啱晒家庭／團隊「唔想佢亂咁插嘴」嘅用法。每個 Topic 就係一條獨立 thread，可分別叫「#日常速記」「#洗費記帳」等。

  5. 5

    模型路由 + 月費封頂

    OpenRouter 建立一個專屬 API key 俾呢部 bot，然後喺 key 上設每月 credit limit（例如 $15）。再用 hermes model 揀主模型。

    hermes model # 揀 provider / 主模型 hermes config set auxiliary.vision.model <vision 模型>

    分工建議：日常對話用細快模型，複雜推理先升級；語音／圖片交俾 vision 模型。上限設低一級（$15）比事後補救穩陣。

  6. 6

    服務化 + 備份

    裝成 systemd service，開機自動起；之後定期備份 state.db 同 ~/.hermes/（記憶、清單、記帳 CSV 全喺裡面）。

    hermes gateway install hermes gateway status tar czf ~/hermes-backup-$(date +%F).tar.gz ~/.hermes/state.db ~/.hermes/config.yaml

    匯出嘅備份唔好放喺同一部 VPS（VPS 死 = 記憶全失）。

Checklist

避坑檢查表

上線前逐項剔一次；每項都係實際會靜靜地壞嘅位。