如何安裝 OpenClaw — Windows、Mac 與 Linux 完整安裝指南

安裝 OpenClaw 大約需要 5 分鐘。 你需要 Node.js 22+、Git 和 8GB 記憶體。最快的方式是執行一條 npm install -g openclaw@latest 指令，然後執行設定精靈。或者，使用 MyClaw.ai 的託管服務，完全跳過安裝步驟。

安裝 OpenClaw 前的準備

在你的機器上安裝 OpenClaw 之前，請確認以下需求：

需求最低建議記憶體8GB16GB儲存空間10GB20GBNode.jsv22v22+（最新 LTS）作業系統Win 10（WSL2）/ macOS 12 / Ubuntu 20.04最新穩定版

方案 1：使用託管服務跳過安裝

不想處理安裝？ MyClaw.ai 提供完全託管的 OpenClaw 服務——無需任何設定，幾秒鐘即可使用：

• 即時啟用 — 無需安裝、無需設定、無需終端指令
• 全天候運行 — 7×24 小時在線，無需保持電腦開機
• 自動更新 — 始終執行最新版本的 OpenClaw

立即開始使用 MyClaw.ai →

---

方案 2：自行託管 OpenClaw

自行託管有兩種方式：建議的全域安裝（最簡單）或從原始碼編譯（適合開發者）。

建議：全域安裝

這是在任何平台上最快執行 OpenClaw 的方式：

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

設定精靈將引導你完成閘道器、工作區、頻道和技能的設定。--install-daemon 參數會設定背景服務（macOS 上為 launchd，Linux 上為 systemd），使 OpenClaw 持續運行。

設定完成後，驗證安裝：

openclaw doctor

---

替代方案：從原始碼編譯

如果你想要完全控制或希望為 OpenClaw 做出貢獻，可以從原始碼編譯。請按照以下平台特定指南操作。

在 Windows 上安裝 OpenClaw

強烈建議使用 WSL2 在 Windows 上執行 OpenClaw。請先安裝 WSL2，然後按照下方的 Linux 說明操作。

如果你仍然想在 Windows 上原生執行：

步驟 1：安裝前置依賴

1. 下載 Node.js v22+（LTS 版本）
2. 下載 Git for Windows
3. 安裝 pnpm — OpenClaw 建議的套件管理器
4. 安裝後重新啟動終端

驗證安裝：

node --version   # 應為 v22 或更新版本
git --version
pnpm --version

步驟 2：複製 OpenClaw 儲存庫

開啟 PowerShell 或命令提示字元並執行：

git clone https://github.com/openclaw/openclaw.git
cd openclaw

步驟 3：安裝和編譯

pnpm install
pnpm ui:build
pnpm build

這將下載所有必要的套件並編譯專案。

步驟 4：執行設定精靈

pnpm openclaw onboard --install-daemon

精靈將引導你完成 OpenClaw 的設定，包括設定 AI 模型、頻道和工作區。

在 macOS 上安裝 OpenClaw

步驟 1：安裝前置依賴

使用 Homebrew 是最簡單的方式：

# 如需安裝 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安裝 Node.js 和 Git
brew install node git

# 安裝 pnpm
brew install pnpm

步驟 2：複製和編譯

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

步驟 3：執行設定精靈

pnpm openclaw onboard --install-daemon

這將設定 launchd 服務，使 OpenClaw 自動在背景執行。

macOS 權限設定

OpenClaw 可能會要求螢幕錄製和語音功能的輔助功能權限。當提示時，前往：

系統設定 > 隱私與安全性 > 輔助使用

將你的終端應用程式加入允許清單。

在 Linux（Ubuntu/Debian）上安裝 OpenClaw

步驟 1：安裝前置依賴

# 更新套件管理器
sudo apt update

# 透過 NodeSource 安裝 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 安裝 Git
sudo apt install -y git

# 安裝 pnpm
npm install -g pnpm

步驟 2：複製和編譯

git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm ui:build
pnpm build

步驟 3：執行設定精靈

pnpm openclaw onboard --install-daemon

這將設定 systemd 使用者服務，使 OpenClaw 在背景持續運行。

常見安裝問題排查

"pnpm install" 因權限錯誤失敗

在 Linux/macOS 上，不要對 pnpm 或 npm 使用 sudo。請改為修正權限：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH=~/.npm-global/bin:$PATH

"Node 版本不支援」錯誤

OpenClaw 需要 Node.js 22 或更高版本：

node --version

如果你的版本較舊，請從 nodejs.org 下載最新版本，或使用 nvm 管理版本：

nvm install 22
nvm use 22

連接埠已被佔用

另一個應用程式正在使用相同的連接埠。你可以：

• 停止衝突的應用程式
• 指定不同的連接埠：openclaw gateway --port 18790

缺少原生依賴

在 Linux 上，你可能需要額外的編譯工具：

sudo apt install build-essential

執行診斷工具

OpenClaw 內建了診斷指令，可以檢查你的設定：

openclaw doctor

驗證安裝

安裝 OpenClaw 後，執行診斷工具確認一切正常：

openclaw doctor

然後用一個簡單的代理指令進行測試：

openclaw agent --message "你好，你在運作嗎？"

如果 OpenClaw 有回應，表示安裝已完成。

更新 OpenClaw

將 OpenClaw 更新到最新版本：

如果是全域安裝：

openclaw update --channel stable

如果是從原始碼編譯：

cd openclaw
git pull origin main
pnpm install
pnpm ui:build
pnpm build

下一步

現在 OpenClaw 已經安裝好了：

• 閱讀入門指南學習基本用法
• 了解更多關於 OpenClaw 是什麼
• 探索 OpenClaw 託管方案實現 7×24 小時運行