OpenClaw 常見錯誤怎麼解決？

遇到問題？這裡有最常見的解決方案。

安裝錯誤

Node.js 版本不符

OpenClaw 需要 Node.js 22 以上。使用以下指令檢查版本：

# 檢查版本
node --version

# 如果版本不對，使用 nvm 切換
nvm install 22
nvm use 22

權限問題（Permission denied）

Linux/macOS 可能需要 sudo 權限：

# 使用 sudo 安裝
sudo curl -fsSL https://get.openclaw.ai | sudo bash

# 或修正 npm 權限
sudo chown -R $(whoami) ~/.npm

PATH 環境變數問題

如果安裝後找不到 openclaw 指令：

# 手動加入 PATH（bash/zsh）
echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Windows PowerShell
[Environment]::SetEnvironmentVariable("PATH", "$env:USERPROFILE\\.openclaw\\bin;$env:PATH", "User")

連線錯誤

API Key 失效

確認 API Key 是否過期或額度已用完：

  • OpenAI：platform.openai.com
  • Claude：console.anthropic.com

代理伺服器（Proxy）設定

如果你在需要 Proxy 的網路環境中：

# 設定環境變數
export HTTP_PROXY=http://your-proxy:port
export HTTPS_PROXY=http://your-proxy:port

Config 設定錯誤

設定檔格式錯誤是最常見的問題。使用內建工具自動修復：

# 自動檢查並修復設定
openclaw doctor --fix

# 手動檢查設定檔
openclaw config validate

# 重設為預設設定（會備份原始檔案）
openclaw config reset

救援機器人（Rescue Bot）

設定一個輕量級的救援機器人，當主程序掛掉時，你會收到通知並可以遠端修復。

{
  "rescue": {
    "enabled": true,
    "telegramChatId": "YOUR_CHAT_ID",
    "alertOnCrash": true,
    "autoRestart": true,
    "maxRestarts": 3
  }
}

建議每位使用者都設定救援機器人，尤其是 24 小時運行的環境。

常見問題