Telegram Bot 設定教學

1. 在 Telegram 搜尋 @BotFather 並開始對話。
2. 輸入 /newbot。
3. 依提示輸入 Bot 名稱（顯示名稱）和 username —— username 必須以 bot 結尾。
4. BotFather 會回傳 Bot Token，先存起來。

AGEND_BOT_TOKEN=123456789:ABCdefGHIjklMNOpqrsTUVwxyz

不用自己動手寫檔案 —— agend quickstart 會問你 token 並寫進 ~/.agend/.env。 Token 等同密碼，拿到的人就能完全操控你的 bot。

預設 Bot 只收得到 / 開頭的指令和被 @ 提及的訊息。 AgEnD 需要讀所有訊息，所以隱私模式一定要關。

1. 對 BotFather 輸入 /mybots。
2. 選擇你的 Bot → Bot Settings → Group Privacy。
3. 選 Turn off。

1. 在 Telegram 建立一個新 Group（私人的，只有你和 bot）。
2. 點擊 Group 名稱進入設定。
3. 點 Edit（鉛筆圖示）。
4. 開啟 Topics。開啟後每個對話都在獨立 Topic 裡 —— AgEnD 就是靠這個區分 instance。

1. 在 Group 中點 Add Members，搜尋你的 bot username 並加入。
2. Group 設定 → Administrators → Add Admin。
3. 選擇你的 bot，授予下表權限。

User ID 用於 fleet.yaml 的存取控制，把 bot 鎖給你自己用。 沒有存取名單的話，任何人找到你的 bot 就能操控你的 agent。quickstart 會從你在 Group 傳的/start 取得你的 User ID，所以這一步只是用來確認，或之後加同事時使用。

1. 在 Telegram 搜尋 @userinfobot。
2. 對它發送任意訊息。
3. 它會回覆你的 User ID（純數字）。

agend quickstart 會自動寫入：

channel:
  access:
    mode: locked
    allowed_users:
      - '951494522'    # 你的 user ID

要跟同事共用的話，把他們的 User ID 一起加進清單。

agend quickstart      # 選 Telegram，貼上 token，再到 Group 傳 /start

quickstart 會等你在 Group 傳 /start，從中取得 Group 和你的 User ID。 最後會詢問要不要把 fleet 安裝成服務並啟動；如果你選了不要，就執行 agend start。

接著在 Group 的 General topic 傳一則訊息。Bot 有回你就完成了，之後就能陸續加專案 instance。 要開網頁 dashboard，在 General 傳 /web：bot 會私訊給你登入連結和一次性代碼（請先跟 bot 開啟私人對話）。