龍蝦安裝卡關全解：webhook、token、Docker、記憶與主動提醒最常出錯的地方

如果你正在自己架 OpenClaw(社群暱稱「龍蝦」),或是試過 Hermes 這類 AI agent,很可能會遇到一個很挫折的情況:

明明文件照著做了,模型也有回,但一接到 LINE、Webhook、Docker、記憶、排程,就開始各種怪問題。

這篇不是要寫一份「每一行指令都照抄」的安裝手冊。不同專案、版本、主機環境會變,照抄反而最容易過期。這篇要整理的是:自架 AI agent 最常卡在哪幾類,你該怎麼判斷問題在哪一層。

一、安裝指令跑完,不代表真的能用

很多教學會把重點放在第一步:

跑安裝指令 → 打開 CLI → 問一句話 → 有回答,成功。

這只能證明「模型對話」這條路通了,還不能證明它能當你的 AI 員工。

真正要能用,至少還要過這幾關:

• 它能不能常駐在主機上?
• 重開機後會不會自動回來?
• LINE 或 Telegram 訊息能不能送進來?
• 回覆能不能送出去?
• 記憶會不會留下來?
• 排程到時間會不會真的提醒人?
• 工具有沒有被收斂到安全範圍?

所以第一個心法是:不要把「CLI 會回話」當成完工。那只是把員工帶進門,還沒開始上班。

二、Webhook 收不到:通常不是 AI 問題

自架的人最常卡在這句:

我在 LINE 傳訊息了,為什麼 agent 沒反應?

這時候很多人會先懷疑模型、prompt、SOUL。其實更常見的是 webhook 根本沒打進來。

可以先照這個順序想:

1. 外部網址是否真的打得到你的主機?

LINE 這類平台不會直接連你的筆電或家裡內網。它需要一個公開的 HTTPS webhook URL。你可能會用 Cloudflare Tunnel、ngrok、Caddy + 網域,或其他反向代理。

如果這條路不通,agent 再聰明也沒有用,因為它根本沒收到訊息。

2. webhook URL 是不是填錯環境?

常見錯誤是:

• 填到舊的 tunnel URL;
• 本機測試 URL 和正式主機 URL 混在一起;
• 路徑少打一段,例如 /webhook、/line/webhook 不一致;
• HTTPS 憑證還沒生效。

3. 平台後台的 secret / token 是否對得上?

像 LINE 會有 channel secret、access token 這類設定。secret 用來驗證「這真的是 LINE 打來的」;token 用來讓你的 agent 回 LINE。

兩者放反、複製到舊值、或漏了換行空白,都會讓整條路看起來像 agent 壞掉。

這類問題的判斷方式很單純:先確認 webhook 真的有進到 gateway log,再來看 agent 有沒有醒來。不要一開始就改 prompt。

三、Token 和金鑰:不是能用就好,還要能保存、能輪替

第二個常見坑是金鑰。

自架 AI agent 會碰到好幾種 secret:

• 模型 API key 或 OAuth;
• LINE channel secret / access token;
• GitHub 或 Google 這類外部工具權限;
• 資料庫或檔案儲存憑證;
• 主機 SSH key。

新手最常見的做法是先塞進 .env、貼進 config、或直接放在 shell history 裡。短期會動,長期很危險。

你至少要問三個問題:

1. 這把 key 掉了,誰有辦法重建?
2. 這把 key 外洩,會不會能讀公司資料或發 LINE 訊息?
3. 這把 key 過期或被撤銷時,agent 會怎麼失敗?

如果答案都不知道,這就不是安裝完成,只是暫時能跑。

比較健康的做法是:secret 進正式的密碼管理或平台環境變數;程式碼、文章、截圖、log 裡都不要出現明文 key。

四、Docker 和工具權限:功能開太多,反而最危險

AI agent 真正好用的地方,是它可以用工具:

• 讀檔案;
• 寫檔案;
• 跑指令;
• 查網路;
• 操作瀏覽器;
• 呼叫公司系統。

但這也是最危險的地方。

如果你把所有工具都開給一個會讀外部訊息的 agent,等於讓 LINE 訊息、廠商傳來的圖片、文件裡的文字,都有機會影響一個能跑指令的系統。這不是科幻,這就是 prompt injection 的基本風險。

所以自架時要特別注意:

• LINE / 客戶通道不要拿到不必要的 terminal / file / code execution 權限;
• 需要執行命令時要有 approval;
• 沙箱要真的隔離,不要把主機敏感目錄整包掛進去;
• 第三方 skills 不要亂裝;
• 會碰 secret 的 workflow 不要執行未釘版的遠端腳本。

一句話:不要把「能做很多事」誤會成「應該全部開著」。AI 員工跟真人員工一樣,權限應該照職務給,不是先給總管理員再說。

五、記憶亂存:會比沒有記憶更麻煩

很多人期待龍蝦或 Hermes 這類 agent 有記憶,因為這正是它和一般聊天機器人的差別。

但記憶要用對。

適合放進長期記憶的是:

• 老闆穩定偏好;
• 公司固定稱呼;
• 常用工作規則;
• 不想每次重講的習慣。

不適合塞進 agent 記憶的是:

• 客戶清單;
• 報價紀錄;
• 案場文件;
• 每一筆互動;
• 會一直變的待辦與提醒。

這些應該放在真正的資料庫、文件系統或公司知識庫裡,讓 agent 去查,而不是叫 agent 靠印象回答。

為什麼?因為錯的記憶比沒有記憶更危險。沒有記憶,它會問你;錯的記憶,它可能很有自信地答錯。

六、排程和主動提醒:不是有 cron 就會真的送到人

很多 agent 都有排程或 heartbeat 概念。這是它從「聊天工具」變成「員工」的關鍵:它可以每天早上整理待辦,或到期時主動提醒。

但主動提醒至少有三層要驗證:

1. 排程有沒有跑。 到時間 cron 有沒有醒來?
2. 內容有沒有產生。 它有沒有真的查資料、整理出該提醒的事?
3. 訊息有沒有送到人。 LINE / Telegram / Email 有沒有成功 delivery?

這三件事常常被混在一起。你只看 cron log 綠,不代表老闆真的收到;你只看到 agent 回「已提醒」,也不代表平台送出成功。

而且在 LINE 官方帳號裡,主動 push 會受訊息額度限制。好的 AI 特助不應該每件小事都推爆,而是要會合併 digest、分級提醒,只在真的需要人決定時打擾。

七、什麼時候該承認:你要的其實不是自架,是有人幫你顧

如果你看到這裡,覺得每一關都不是不能做,但每一關都要查、要試、要維護——那你的感覺是對的。

自架 AI agent 的困難,不在於某一個步驟特別神祕,而是它橫跨太多層:

• 主機;
• HTTPS webhook;
• 平台 token;
• 模型金鑰;
• Docker / sandbox;
• 記憶;
• skills;
• cron;
• delivery;
• 權限與資安。

對工程師來說,這些是日常。對一個生意跑在 LINE 上的老闆來說,這些就是每週都會冒出來的小麻煩。

我們做特助 AI,就是想把這些麻煩包起來:你不用自己顧 VPS、token、webhook、更新、資安加固;你只要在 LINE 裡跟你的 AI 特助說事情,它會記、會提醒、會查資料,不確定時會問你。

免費諮詢先聊,我們把你這一行的流程,一起畫成特助看得懂的簿子。上線前,不收任何費用。

點這裡跟我們約個時間聊聊。