安裝 OpenClaw

很多時候，我們只是想試用一個新工具，卻卡在環境配置。要嘛是 Node 版本對不上，要嘛是全域路徑沒設好，最後明明還沒開始寫 Code，就先被環境搞到心累。如果你也遇過這種情況，這篇安裝指南就是為你準備的。

我們把流程簡化到了幾行指令，無論你是在 macOS、Linux 還是 Windows 上開發，都能快速搞定。

需要準備的東西

在開始之前，請確認你的環境符合以下要求：

Node 22+（如果你沒裝，安裝指令碼會自動幫你處理）
macOS, Linux, 或 Windows
如果你打算從原始碼編譯，則需要 pnpm
Windows 用戶強烈建議在 WSL2 下執行

快速開始

最推薦的方式是使用官方的 installer script，它會自動偵測 Node 環境並引導你完成後續設定。

1. 執行安裝指令碼

macOS / Linux / WSL2

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

Windows (PowerShell)

iwr -useb https://openclaw.ai/install.ps1 | iex

2. 驗證安裝結果

執行以下指令，確認 OpenClaw 已經準備就緒：

openclaw doctor         # 檢查設定問題
openclaw status         # Gateway 狀態
openclaw dashboard      # 開啟瀏覽器 UI

如果你只想安裝二進位檔，不想進入引導流程，可以在指令後方加上參數：

macOS / Linux / WSL2: curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Windows: & ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard

其他安裝選項

如果你偏好手動管理套件，也可以使用 npm 或 pnpm：

使用 npm

npm install -g openclaw@latest
openclaw onboard --install-daemon

使用 pnpm

pnpm add -g openclaw@latest
pnpm approve-builds -g        # 核准 openclaw, node-llama-cpp, sharp 等套件
openclaw onboard --install-daemon

對於想要貢獻程式碼或執行本地版本的開發者，可以選擇從原始碼編譯：

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
pnpm link --global
openclaw onboard --install-daemon

疑難排解

找不到 `openclaw` 指令

這通常是 PATH 的問題。你可以先執行以下指令診斷：

node -v
npm -v
npm prefix -g
echo "$PATH"

如果你的 $PATH 裡沒有 $(npm prefix -g)/bin (macOS/Linux) 或 $(npm prefix -g) (Windows)，你的 shell 就找不到全域安裝的二進位檔。

修正方法： 將路徑加入你的 shell 設定檔（如 ~/.zshrc 或 ~/.bashrc）：

export PATH="$(npm prefix -g)/bin:$PATH"

Windows 用戶請將 npm prefix -g 的輸出路徑手動加入系統環境變數的 PATH 中。

sharp 編譯錯誤

在安裝過程中，如果因為全域安裝了 libvips 而導致 sharp 報錯，可以強制使用預編譯的二進位檔：

SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest

如果你看到 sharp: Please add node-gyp to your dependencies，請安裝建置工具（macOS 請執行 xcode-select --install 加上 npm install -g node-gyp）或使用上方的環境變數。

如果你在安裝過程中遇到任何卡關，可以直接詢問我們的 AI Setup Assistant。

下一步

OpenClaw Expert

還是卡住了？

如果這篇文件沒有解決你的情境，直接問 OpenClaw Expert，拿到可執行步驟。