# Agents Gateway 使用說明（給人看的一頁版）

## 這是什麼

Agents Gateway 讓你的 Agent 接上你的 LINE 官方帳號：它會記錄你指定群組的對話與檔案，在有人 @ 它時回話，也能主動在群組裡發訊息。你不用架伺服器，也不用寫程式——把說明交給你的 Agent，它會自己設定，只有幾個步驟需要你在 LINE 上點一下。

## 你要準備什麼

| 項目 | 說明 |
|---|---|
| 說明網址＋管理金鑰 | 平台給你的兩樣東西。金鑰以 `lgw_omni_` 開頭，**等同你整個帳號的鑰匙**，只交給你自己的 Agent，用私訊交，不要貼到群組 |
| 一個 Agent | 能上網、能呼叫 API 或 MCP 工具的程式（例如 Claude Code、Codex CLI）。目前可直接用的類型見下方「哪些 Agent 能用」 |
| 你的 LINE 帳號 | 要能登入 LINE Official Account Manager 與 LINE Developers（用一般 LINE 帳號登入即可） |
| 大約 30 分鐘 | 第一次設定；之後日常不用管 |

## 把哪一段貼給 Agent

把下面這句話**私訊**給你的 Agent（跟官網首頁「交給你的 Agent」是同一句；已經有管理金鑰的話，在後面加一句「管理金鑰：〈lgw_omni_…〉」，只交給你自己的 Agent）：

> 請照 https://agents-gateway.cloud/install.md 的說明幫我註冊 Agents Gateway、把你接上 LINE，全部自己判斷、自己完成。

## Agent 會請你做哪些事

Agent 會一步一步告訴你，每一步都會附說明。整個流程中你會被請求做這些：

| 時機 | 你要做的事 | 大約時間 |
|---|---|---|
| 一開始（還沒有 Bot 時） | 在 LINE 網站建一個官方帳號、開啟 Messaging API，把 **Channel secret** 與 **Channel access token** 私訊給 Agent | 10 分鐘 |
| 接著 | 在 LINE Developers 打開「Use webhook」「Webhook redelivery」，允許 Bot 加入群組，關掉「自動回應訊息」與「歡迎訊息」 | 3 分鐘 |
| 成為管理員 | 用 LINE 加 Bot 為好友，私訊它 Agent 給你的 8 碼配對碼 | 1 分鐘 |
| 進群 | 把 Bot 邀進你要的群組，在群裡說一句話 | 1 分鐘 |
| 確認告知文字 | Agent 會給你一則「本群對話會被記錄」的告知讓你確認，同意後它才發 | 1 分鐘 |
| 邀其他人 | 把 Agent 給的配對碼轉給要授權的群友，請他在群裡貼上 | 每人 1 分鐘 |
| 實測 | 在群裡用 @ 選單點 Bot、打「你好」，再傳一張圖 | 1 分鐘 |
| 可選 | 連接你的 Google Drive（開 Agent 給的網址按同意）；私訊 Bot 一段語音測試轉文字 | 各 2 分鐘 |

Agent **不會**也**不應該**請你去找平台或任何其他人要東西。若它這樣要求，請它重新讀說明。

## 怎麼確認成功

1. 在群裡用 @ 選單點 Bot、打「你好」：10～45 秒內出現回覆，發言者顯示你的 Agent 的名字。
2. 開 `〈Gateway 網址〉/ui/login`，貼上管理金鑰登入（唯讀）：
   - 「Bots」頁：你的 Bot 的 webhook 狀態是 active。
   - 「Agents」頁：你的 Agent 是 online。
   - 「最近訊息」頁：看得到剛才的「你好」和回覆。
3. 把 Agent 暫停幾分鐘，你的 LINE 會收到 Bot 私訊的「Agent 離線」通知；恢復後再收到一則。

## 日常

- **想改設定**（誰能叫它、要不要每句都聽、換預設 Agent、加關鍵字分工）：直接跟你的 Agent 說。群組管理員也可以在群裡叫 Agent 改該群的設定；不是管理員的人叫它改，Gateway 會擋下來。
- **群組回覆模式**：只記錄／默默聽每句／任何人 @ 都回／聽全部但必要時才開口／只有授權的人 @ 才回（預設）。跟 Agent 說你要哪種。
- **推播額度**：LINE 免費方案每月主動推播的則數有限。Agent 回覆別人 @ 它的那句不算額度；主動發訊才算。快用完時你會收到通知。
- **檔案**：沒有連 Google Drive 時，平台不保管你的圖片與檔案（訊息文字照記）；要存檔請 Agent 幫你連接自己的 Drive。
- **語音轉文字**：預設關閉；要用的話跟 Agent 說，它會先確認這個平台有沒有開這項功能。

## 出事了怎麼辦

| 狀況 | 怎麼做 |
|---|---|
| 金鑰可能外洩 | 叫 Agent「撤換管理金鑰」，它會建新的、作廢舊的，把新的私訊給你 |
| LINE 的 token 或 secret 重發了 | 把新的值私訊給 Agent，它會更新 |
| @ 了沒反應 | 叫 Agent「查為什麼沒回」，它會逐段檢查並告訴你卡在哪 |
| 不想用了 | 叫 Agent「移除 Bot」；再到 LINE Developers 關掉 Use webhook，或停用官方帳號 |
| 要 Bot 離開某個群 | 叫 Agent「讓 Bot 離開〈群組〉」（1 對 1 聊天沒辦法離開，封鎖 Bot 即可） |
| 收到「Gateway 網址已變更」通知 | 通知會列出哪些 Bot 已自動更新、哪些要處理；要處理的照 Agent 的指示到 LINE Developers 改 Webhook URL |
| 不要再記錄某個群 | 叫 Agent 把那個群設成「不記錄」 |

## 目前還不能用的

- 網頁版聊天產品的連接器只能查詢與發訊，不會在有人 @ 時自動回話。
- 在儀表板直接改設定（請透過 Agent）。
- 資料保留天數、匯出、刪除整個帳號。

## 哪些 Agent 能用

| Agent 類型 | 能做到 | 你要做的額外步驟 |
|---|---|---|
| 能在電腦上常駐程式的 Agent（Claude Code、Codex CLI、自寫程式；Windows／macOS／Linux） | 被 @ 時 45 秒內自動回話、主動發訊、查記錄 | 無（Agent 會在它的電腦裝一個小程式，不需要公開網址） |
| 有公開 HTTPS 網址可以被叫醒的 Agent（雲端服務、喚醒網址型 Agent） | 同上 | 無 |
| 只能用 MCP 工具、不能常駐的 Agent（排程型） | 查記錄、主動發訊；回話速度取決於它多久檢查一次 | 無 |
| 網頁版聊天產品（只支援 OAuth 的自訂連接器，例如 Claude.ai、ChatGPT） | 在對話中查記錄、搜尋、看檔案、主動發訊；**不會自動回話** | 在該產品的連接器設定填 Gateway 網址，在跳出的授權頁貼上管理金鑰並按同意 |


---
Agents Gateway 0.1.0