跳轉到主要內容

​
安裝

已經完成 Getting Started？ 一切就緒 — 本頁面提供替代安裝方式、平台特定指引與維護資訊。

​
系統需求

  • Node 22+（若未安裝，安裝程式腳本 會自動安裝）
  • macOS、Linux 或 Windows
  • 僅在從原始碼建置時才需要 pnpm
在 Windows 上，我們強烈建議於 WSL2 下執行 OpenClaw。

​
安裝方式

安裝程式腳本 是安裝 OpenClaw 的建議方式。它可在單一步驟中處理 Node 偵測、安裝與導覽設定。

Installer script

下載 CLI、透過 npm 全域安裝，並啟動入門引導精靈。
curl -fsSL https://openclaw.ai/install.sh | bash
就這樣 — 腳本會處理 Node 偵測、安裝與入門引導。若要略過入門引導、僅安裝二進位檔：
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
所有旗標、環境變數與 CI／自動化選項，請參閱 Installer internals。
若你已具備 Node 22+，並偏好自行管理安裝：
npm install -g openclaw@latest
openclaw onboard --install-daemon
若你已全域安裝 libvips（在 macOS 上常見於 Homebrew），且 sharp 失敗，請強制使用預先建置的二進位檔：
SHARP_IGNORE_GLOBAL_LIBVIPS=1 npm install -g openclaw@latest
若看到 sharp: Please add node-gyp to your dependencies，請安裝建置工具（macOS：Xcode CLT + npm install -g node-gyp），或使用上述環境變數。
適用於貢獻者或任何想要從本機檢出執行的人。
1

複製並建置

複製 OpenClaw repo 並建置：
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build
2

連結 CLI

讓 openclaw 指令可全域使用：
pnpm link --global
或者略過連結，直接在 repo 內透過 pnpm openclaw ... 執行指令。
3

執行入門引導

openclaw onboard --install-daemon
更深入的開發流程，請參閱 Setup。

​
其他安裝方式

Docker

容器化或無介面部署。

Podman

Rootless container: run setup-podman.sh once, then the launch script.

Nix

透過 Nix 進行宣告式安裝。

Ansible

自動化叢集佈署。

Bun

透過 Bun 執行階段進行僅 CLI 的使用。

​
安裝後

驗證一切是否正常運作： 
openclaw doctor         # check for config issues
openclaw status         # gateway status
openclaw dashboard      # open the browser UI
若需要自訂執行期路徑，請使用：
  • OPENCLAW_HOME 用於以家目錄為基礎的內部路徑
  • OPENCLAW_STATE_DIR 用於可變狀態的位置
  • OPENCLAW_CONFIG_PATH 用於設定檔位置
請參閱 Environment vars 以了解優先順序與完整細節。

​
疑難排解：找不到 openclaw

快速診斷：
node -v
npm -v
npm prefix -g
echo "$PATH"
若 $(npm prefix -g)/bin（macOS/Linux）或 $(npm prefix -g)（Windows）未出現在你的 $PATH 中，表示你的 shell 無法找到全域 npm 二進位檔（包含 openclaw）。修正 — 將其加入你的 shell 啟動檔（~/.zshrc 或 ~/.bashrc）：
export PATH="$(npm prefix -g)/bin:$PATH"
在 Windows 上，請將 npm prefix -g 的輸出加入 PATH。接著開啟新的終端機（或在 zsh 中執行 rehash／在 bash 中執行 hash -r）。

​
更新／解除安裝

Updating

讓 OpenClaw 保持最新。

Migrating

移轉到新機器。

Uninstall

完整移除 OpenClaw。