一、先認識四個零件
少任何一個，LINE 裡就不會有人回你。
| 零件 | 是什麼 | 怎麼確認有了 |
|---|---|---|
| ① 帳號 | 你在 Agents Gateway 的身分，用信箱收驗證碼登入，沒有密碼 | 能登入 https://agents-gateway.cloud/ui/login |
| ② Bot | LINE 那一端的帳號：用平台的官方 Bot（現成、三分鐘），或你自己的 LINE 官方帳號 | 主控台「Bot」頁有一列 |
| ③ 你的 Agent | 真正回話的那個：Claude Code、Codex、Cursor 的例行程序、Claude.ai… | 主控台「Agent」頁有它，狀態「在線」 |
| ④ 連線 | 讓你的 Agent 聽得到 LINE：bridge 小程式（常駐）、MCP 工具、或例行程序的 webhook | 「Agent」頁的連線方式不是空的 |
二、我現在卡在哪？
| 你看到的 | 代表 | 下一步 |
|---|---|---|
| 私訊官方 Bot，它只回「請把你的 Agent 給的配對碼貼給我」 | 你和帳號還沒綁在一起（①↔②） | 跟你的 Agent 要一組配對碼，私訊貼給 Bot。用 LINE 登入註冊的人不用貼 |
| 群裡 Bot 只說「請負責人貼認領碼」 | 這個群還沒認領（②） | 跟你的 Agent 要一組認領碼，在群裡貼（不是私訊） |
| Bot 說「還沒有任何 Agent 接上來」 | 帳號、Bot 都有了，③ 還沒接 | 把下面「已有帳號」那句話交給你的 Agent（跳到） |
| Bot 說「這個群還沒指定由哪個 Agent 回話」 | ③ 有了，這個群沒指定（④） | 跟你的 Agent 說「把這個群交給你回」，或到主控台該群的設定頁選預設 Agent（跳到） |
| Bot 說「你的 Agent 目前沒連上」 | ④ 斷了 | 把你的 Agent 叫起來（跳到） |
| Bot 說「已超出回覆時間，下次發起對話時會一併回覆」 | 都接好了，只是 Agent 來不及在一分鐘內回 | 等它；常常這樣就看 變慢 |
| 什麼都不說 | 你沒 @ 它；或這個群被設成只記錄不回 | 試著「@〈Bot 名〉你好」；或到主控台看該群的回覆模式 |
| 加好友後出現 LINE 的歡迎訊息 | 正常，那是 LINE 官方帳號的預設 | 不用理會 |
三、不靠 Agent，自己把它接起來
每一步都寫「做什麼」和「成功長怎樣」。全部做完大約 10 分鐘。
1. 註冊或登入
開 https://agents-gateway.cloud/register，輸入信箱，把信裡的 6 碼貼回頁面。成功：看到「帳號已建立」，頁面上顯示一次管理金鑰（lgw_omni_ 開頭）——先複製存好，關掉就看不到了。已經有帳號 → https://agents-gateway.cloud/ui/login 收碼登入。
2. 拿金鑰
註冊完成頁會顯示一次管理金鑰；弄丟了，請你的 Agent 用同一個信箱替你再註冊一次，會拿到一把新的（我們會寄通知信給你）。主控台不提供金鑰建立，降低網頁被盜用的損害。成功：手上有一串 lgw_omni_…。金鑰等於你整個帳號的鑰匙，只交給你自己的 Agent，用私訊，不貼群組。
3. 選 Bot
主控台 → 「新增 Bot」。官方 Bot：從清單挑一隻（名字固定，之後可以幫你的 Agent 取暱稱顯示在前面；想換再加一隻、刪舊的）。自己的 LINE 官方帳號：照頁面指示填 Channel ID 與 secret（在 LINE Developers 看），再到 LINE 後台把 Use webhook 打開。成功：「Bot」頁那一列狀態是綠的。
4. 加好友、拉群、認領
認領碼（官方 Bot）在主控台新增官方 Bot 的完成頁，也可以請你的 Agent 產；配對碼（自己的 Bot）在主控台「配對碼」頁產。手機 LINE：加 Bot 好友 → 把它拉進你的群 → 在群裡貼認領碼（自己的 Bot：私訊它貼配對碼，再拉群）。成功：Bot 在群裡回「已連上」。建議這一步等第 5 步做完再做，不然群友先聊天時沒人回。
5. 把你的 Agent 接上
把這句話交給你的 Agent（點一下全選，再複製給它）：
請照 https://agents-gateway.cloud/install.md#s3 的說明把你接上 LINE；我已經有 Agents Gateway 的帳號和 Bot，管理金鑰我會私訊給你。
它會問你要金鑰，用私訊貼給它。各平台的一句話：
| 你的 Agent | 怎麼做 |
|---|---|
| Claude Code／Codex CLI（在你電腦上） | 貼上面那句話；它會先問你能不能裝一個常駐小程式（bridge），回「可以」 |
| Cursor 的例行程序（GrokBot 類） | 在例行程序面板建一個「當 Webhook 被觸發時」的例行程序，把面板上「Webhook：POST 到」後面的網址和「金鑰」那一行的值給你的 Agent，請它照 https://agents-gateway.cloud/docs/connect/grokbot 登記 |
| Claude.ai／ChatGPT 的連接器 | 在產品的「連接器」加 https://agents-gateway.cloud/mcp，授權頁貼金鑰；這種接法只能查詢與發訊，不會自動回話 |
成功：主控台「Agent」頁出現你的 Agent，狀態「在線」。
6. 指定哪個 Agent 回哪個群
主控台 → 「聊天室」→ 該群 → 「預設 Agent」選它（只有一隻 Agent 時會自動選）。成功：該群顯示預設 Agent 的名字。
7. 測一句
在群裡「@〈Bot 名〉你好」。成功：10～45 秒內出現回覆。接著看 怎麼用。
四、Agent 斷線或失效時
| 情況 | 怎麼辦 |
|---|---|
| 電腦睡著、bridge 停了 | 在那台電腦執行 node ~/line-gateway-bridge/line-gateway-bridge.js list 看每個 Agent 的狀態；不是 online 的就 start --name <那個 Agent 的名稱>。期間的訊息會排隊，Agent 回來會補回 |
| 換電腦、重裝 | 舊電腦 disconnect；新電腦請你的 Agent 照 https://agents-gateway.cloud/install.md §3.2 重接（同一個名字會沿用設定） |
| 常常「超出回覆時間」 | Agent 太慢：例行程序型可以把預期回覆時間調長（請 Agent 改 expectedReplySec）；官方 Bot 會在下次有人說話時一併補回 |
| 金鑰外洩或換了 | 請你的 Agent 撤銷舊的、發一把新的給它自己（主控台不提供金鑰建立與撤銷） |
| 例行程序回 401 | 面板上的金鑰換了，把新的給 Agent 更新 |
| Agent 被刪了 | 主控台「Agent」頁重新讓 Agent 登記（第 5 步） |
五、同一台電腦接兩個 Agent
可以。每個 Agent 用自己的名稱裝（它們執行 connect 時會自己帶 --name）：程式檔共用一份，設定與金鑰各自一個資料夾，各自一個常駐服務，互不影響。
- 看全部：
node ~/line-gateway-bridge/line-gateway-bridge.js list - 只停其中一個：
… stop --name <名稱>；只移除其中一個：… disconnect --name <名稱> - 更新程式：
… upgrade，會一次重啟所有 Agent 的服務 - 以前只裝過一個的，它叫
default，照常用，不用重裝；第二個 Agent 進來時會自己取名
六、還是不行
- 常見問題：https://agents-gateway.cloud/faq
- 給 Agent 讀的完整安裝說明：https://agents-gateway.cloud/install
- 回饋或求助：https://agents-gateway.cloud/feedback（不要貼金鑰）