🔧

Part 11: 常見問題與指令表

遇到問題?這裡有解答!

❌ 問題 1:spawn npm ENOENT

看到的錯誤訊息:

Error: spawn npm ENOENT

解決方法:

  1. 關掉 PowerShell
  2. 重新開一個新的 PowerShell(系統管理員)
  3. 輸入:nvm use 22
  4. 輸入:setx PATH "$env:APPDATA\npm;$env:Path"
  5. 關掉 PowerShell,再重新開一個
  6. 再試一次原本的指令

❌ 問題 2:OAuth token 過期

看到的錯誤訊息:

OAuth token refresh failed for openai-codex

解決方法:

  1. 在 PowerShell 輸入:codex login
  2. 瀏覽器會打開,登入你的 ChatGPT/OpenAI 帳號
  3. 登入完成後,回到 PowerShell
  4. 輸入:openclaw gateway restart

❌ 問題 3-4:版本問題

Node.js 版本太舊

required: { node: '>=22' }

解決:

nvm install 22
nvm use 22

ngrok 版本太舊 (ERR_NGROK_121)

Your ngrok-agent version is too old

解決:

ngrok update

❌ 問題 5:PowerShell 執行原則錯誤

看到的錯誤訊息:

PSSecurityException: 無法載入檔案...
因為這個系統上已停用指令碼執行

解決方法:

  1. 以系統管理員身分開啟 PowerShell
  2. 執行:Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
  3. 輸入 Y 確認
  4. 重新執行原本的指令

❌ 問題 6:ngrok authtoken 格式錯誤

看到的錯誤訊息:

ERR_NGROK_105: The authtoken you specified is improperly formatted

解決方法:

  1. 登入 https://dashboard.ngrok.com/
  2. 點左邊的 Your Authtoken
  3. Reset 重設 token
  4. 複製新的 token,重新執行:
    ngrok config add-authtoken 你的新token

❌ 問題 7:502 Bad Gateway

看到的錯誤訊息:

502 Bad Gateway
ngrok: upstream connection error

解決方法:

  1. 確認 OpenClaw 正在執行:openclaw gateway status
  2. 如果沒在跑,啟動它:openclaw gateway start
  3. 確認 ngrok 連接的 port 正確:ngrok http 18789
  4. 重新啟動 OpenClaw:openclaw gateway restart
⚠️ 注意:ngrok 和 OpenClaw 都要同時執行才會正常!

❌ 問題 8:LINE 機器人沒回應

可能原因 1:ngrok 已經關了

解決:重新開 ngrok,然後更新 LINE Webhook URL

ngrok http 18789

可能原因 2:OpenClaw 沒在跑

openclaw gateway start

可能原因 3:還沒配對

傳訊息給機器人取得配對碼,然後執行:

openclaw pairing approve line 配對碼
💡 需要更多協助?
可以詢問 Gemini 小幫手 來解決問題!

📋 OpenClaw 常用指令

你想做的事輸入這個指令
🚀 啟動龍蝦openclaw gateway start
🛑 關閉龍蝦openclaw gateway stop
🔄 重新啟動龍蝦openclaw gateway restart
📊 看龍蝦狀態openclaw gateway status
🔍 檢查有沒有問題openclaw doctor
✅ 批准 LINE 配對openclaw pairing approve line 配對碼
🔑 重新登入 OpenAIcodex login

📋 ngrok 與 Node.js 指令

ngrok 指令

你想做的事輸入這個指令
🌐 啟動 ngrokngrok http 18789
🔄 更新 ngrokngrok update
🛑 關閉 ngrokCtrl + C

Node.js 指令

你想做的事輸入這個指令
看 Node 版本node -v
安裝 Node 22nvm install 22
切換到 Node 22nvm use 22

🔐 Pairing 配對模式說明

你說:

什麼是 pairing?

龍蝦會回覆:

Pairing 是 OpenClaw 的「配對」機制 🔐

📌 用途:
   控制「誰可以跟這隻龍蝦講話」

📌 運作方式:
   1. 新使用者傳訊息給機器人
   2. 機器人回覆一組 pairing code(配對碼)
   3. 管理員在終端機執行:
      openclaw pairing approve line <code>
   4. 該使用者就被加入白名單,可以正常對話

📌 好處:
   ✅ 避免陌生人濫用你的 AI
   ✅ 保護 API 額度
   ✅ 可隨時撤銷存取權限
💡 白名單機制!
只有經過配對的使用者才能使用你的龍蝦 AI!

⚙️ 背景執行設定

你說:

設定一下:以後系統維護類的操作在背景做,不要給我看過程

龍蝦會回覆:

收到 ✅

已設定:系統維護類操作(如更新、清理、備份等)
會在背景執行,只在完成時回報結果。

如果你想臨時看進度,可以說「顯示目前背景任務」。
🎯 更清爽的體驗!
不用看一堆執行過程,只看結果就好!
💡 你還可以這樣說:
• 「顯示目前背景任務」- 查看進行中的任務
• 「取消背景任務」- 停止執行中的任務

🤖 查詢使用的 AI 模型

你說:

你現在使用哪個 AI?

龍蝦會回覆:

目前正在使用的是:

🔹 模型:gpt-5.2(或 openai-codex)
🔹 提供者:OpenAI
🔹 特色:
   - 更強的推理能力
   - 支援多模態(文字、圖片)
   - 更長的上下文記憶
💡 可更換 AI 模型!
龍蝦支援多種 AI 後端,可以在設定檔中調整:
• OpenAI (gpt-5.2, openai-codex)
• Gemini (gemini-2.5-flash, gemini-2.5-pro)
• Groq (llama-3.3-70b-versatile)

🔄 關閉與重新啟動

📋 快速指令摘要(每次開機都要做):
openclaw gateway start → 第一個視窗
ngrok http 18789 → 第二個視窗
然後更新 LINE Webhook URL!

要關閉的時候

  1. 在 ngrok 的視窗按 Ctrl + C
  2. 在另一個視窗輸入:openclaw gateway stop

下次要啟動的時候

  1. 開 PowerShell,輸入:openclaw gateway start
  2. 開另一個 PowerShell,輸入:ngrok http 18789
  3. 重要!用指令開啟 LINE Developers:
    start https://developers.line.biz/
    更新 Webhook URL(因為 ngrok 網址會變)
📚

接下來看看應用範例!

學會安裝後,來看看龍蝦可以幫你做什麼事!

➡️ Part 12:自動開發+部署