跳轉到內容
最近更新

OpenClaw 本地安裝（Mac / Linux）

⚠️ 重要安全提醒
OpenClaw 可能具備較高權限能力，建議先在舊電腦、虛擬機或獨立賬號上測試。

你將完成什麼

  • 在 Mac 或 Linux 安裝 OpenClaw
  • 完成 onboarding 並驗證第一次成功響應
  • 學會如何啟動、更新、重啟和卸載 OpenClaw
  • 解決 PATH、代理、權限和舊版本衝突等常見問題

開始前準備

你需要什麼

  • macOS 或 Linux 終端
  • 能訪問安裝腳本的網絡環境
  • 一個可用的模型 API Key，例如 Anthropic / Claude

推薦環境

Step 0：快速檢查系統

Command
uname -awhoami

Step 1：安裝 OpenClaw

方式 A：先下載再執行

Command
curl -fsSL https://openclaw.bot/install.sh -o install.shsed -n '1,120p' install.shbash install.sh

方式 B：最快安裝

Command
curl -fsSL https://openclaw.bot/install.sh | bash

驗證安裝結果

Command
openclaw --version || truewhich openclaw || true

Step 2：處理“命令找不到”

重新打開終端

很多安裝腳本會修改 PATH，新開一個 shell 往往就能生效。

重新加載 shell 設定

Command
source ~/.zshrc 2>/dev/null || truesource ~/.bashrc 2>/dev/null || true

檢查 PATH 和安裝位置

Command
echo $PATHwhich openclaw || true

Step 3：清理舊版本殘留

OpenClaw 之前曾使用 Moltbot 與 Clawdbot 名稱，舊的全局包可能導致衝突。

Command
npm uninstall -g clawdbot || truenpm uninstall -g moltbot || truenpm uninstall -g openclaw || true

然後重新執行 Step 1。

Step 4：完成 onboarding

Command
openclaw onboard --flow quickstart

推薦做法：

  • 第一個通道優先選 Telegram，驗證最簡單
  • 密鑰優先放在本地設定或 .env，不要寫進 git

驗證 onboarding

  • 設定寫入 ~/.openclaw
  • 提示流程能夠正常完成，沒有持續報錯

Step 5：啟動 OpenClaw

前臺啟動

Command
openclaw start

後臺啟動

Command
openclaw start --detach

修改設定後的重啟

Command
openclaw gateway restart || openclaw restart

驗證啟動

  • 日誌中沒有持續錯誤
  • 設定好的通道里可以收到測試回覆

Step 6：如何更新 OpenClaw

如果你是本地安裝，可以更新 CLI 或重新執行最新安裝流程，然後重啟 gateway。

Command
npm i -g openclaw@latestopenclaw --versionopenclaw gateway restart || openclaw restart

如果你運行在 Docker 或 VPS 上，不要套用本地更新方式，改看 Docker / VPS 部署指南。

Step 7：如何卸載 OpenClaw

如果你要從本地刪除 OpenClaw，先卸載全局包，再決定是否保留本地狀態目錄。

Command
npm uninstall -g openclaw || truewhich openclaw || true

可選清理：

Command
rm -rf ~/.openclaw

只有在你不再需要設定、歷史和本地狀態時，才刪除 ~/.openclaw。

Step 8：代理或受限網絡問題

如果 onboarding 卡住、技能下載失敗、通道請求超時，優先嚐試代理。

Command
export https_proxy=http://127.0.0.1:7890export http_proxy=http://127.0.0.1:7890openclaw start

Step 9：權限錯誤

如果遇到 EACCES 或 permission denied：

常見問題

通道不響應

  • 重新檢查模型 Key
  • 確認網絡或代理可用
  • 第一個驗證通道優先使用 Telegram

技能或依賴下載失敗

  • 確認網絡穩定
  • 受限網絡下優先走代理
  • 如果問題和技能或插件相關，繼續看 高級設定

相關 OpenClaw 指南