实战：团队 Telegram 助手 | Easy Understand Hermes Agent

實戰：團隊 Telegram 助手

嘿，朋友們！今天咱們來點硬核又實用的——把 Hermes Agent 變成你們團隊的 Telegram 助手。想像一下：在群裡 @ 一下機器人，它就能幫你跑任務、定時彙報、甚至聽懂你的語音備忘錄。是不是很酷？跟著我一步步來，包教包會！

第一步：找 BotFather 領個「身份證」

每個 Telegram 機器人都有一個專屬的 API Token，這玩意兒得找官方機器人管理員 @BotFather 要。

打開 Telegram，搜尋 @BotFather（或者直接造訪 t.me/BotFather）
傳送 /newbot
給它起個顯示名稱，比如「Hermes Agent」，隨便起
再起個使用者名稱，記住必須以 bot 結尾，而且得全球唯一（比如 my_hermes_bot）
BotFather 會回你一串 API Token，長這樣：

123456789:ABCdefGHIjklMNOpqrSTUvwxYZ

⚠️ 警告：這串 Token 就是機器人的「鑰匙」，誰拿到誰就能控制你的機器人。萬一洩漏了，趕緊找 BotFather 發 /revoke 吊銷重來！

第二步：給機器人「化妝」（可選）

想讓機器人更專業？找 BotFather 用這幾個命令：

命令	作用
`/setdescription`	設定機器人「能幹啥」的介紹文字
`/setabouttext`	個人主頁的簡短介紹
`/setuserpic`	上傳頭像
`/setcommands`	設定聊天框裡的 `/` 命令選單
`/setprivacy`	控制群聊訊息可見性（下一步細說）

推薦一組 /setcommands 起步命令：

help - Show help information
new - Start a new conversation
sethome - Set this chat as the home channel

小彩蛋：線上狀態指示器

想讓大家知道機器人「醒著」沒？在 ~/.hermes/config.yaml 裡加幾行：

gateway:
  platforms:
    telegram:
      extra:
        status_indicator: true
        status_online: "🟢 Online"
        status_offline: "🔴 Offline"

這樣機器人連線成功時，它的簡介會顯示「🟢 Online」，正常關閉時變「🔴 Offline」。注意：這改的是機器人全域簡介，不是聊天裡的狀態點，而且只有乾淨退出才會更新，強殺程序可不會變哦。

命令選單管理

Hermes 啟動時會自動註冊命令選單，預設最多 60 個命令（Telegram 上限 100 個，但太多容易出錯）。想讓你自己的外掛命令排前面？這樣配：

platforms:
  telegram:
    extra:
      command_menu:
        max_commands: 60
        priority_mode: prepend  # prepend | append | replace
        priority:
          - my_plugin_command

prepend：你的命令排前面
append：預設命令排前面
replace：完全用你的列表

第三步：群聊隱私模式（重點！）

這是新手最容易踩的坑！Telegram 機器人預設開啟隱私模式，這意味著在群裡它只能看到：

以 / 開頭的命令訊息
直接回覆它訊息的內容
成員進出、置頂等系統訊息

關掉隱私模式後，它才能看到群裡所有訊息。操作步驟：

找 @BotFather 發 /mybots
選中你的機器人
進入 Bot Settings → Group Privacy → Turn off

⚠️ 注意：改完設定後，必須把機器人從群裡移除再重新新增！Telegram 會快取隱私狀態，不加這一步不生效。

不想關隱私模式？ 還有個辦法：把機器人設為群管理員。管理員機器人無視隱私設定，能看到所有訊息，還不用全域開關。

進階玩法：只觀察，不打擾

想讓機器人「眼觀六路」但不「多嘴」？這樣配：

telegram:
  allowed_chats:
    - "-1001234567890"
  group_allowed_chats:
    - "-1001234567890"
  require_mention: true
  observe_unmentioned_group_messages: true

這樣機器人會把群裡沒 @ 它的訊息記入上下文（方便後續對話理解），但不會自動回覆。只有你明確 @ 它時才出手，完美！

搞定這三步，你們的團隊 Telegram 助手就正式上崗啦！快去試試語音備忘錄轉文字、定時任務推送這些騷操作吧。有問題隨時在群裡 @ 它——哦不對，是來問我們！