OpenClaw 全平臺(tái)安裝實(shí)測(cè)：Windows/macOS/Linux/Docker 哪條路最順？

搞 AI 開發(fā)，本地跑一個(gè) OpenClaw 是很多人的第一步。但網(wǎng)上教程要么只講一個(gè)系統(tǒng)，要么踩坑經(jīng)驗(yàn)零散。我花了兩天，在四臺(tái)機(jī)器上把主流安裝路徑全跑了一遍，把每條路的坑和解法整理出來(lái)，幫你少走彎路。

先搞清楚：OpenClaw 是什么？

OpenClaw 是一個(gè)開源的 AI Agent 開發(fā)框架，你可以把它理解成一個(gè)"AI 大腦的骨架"——它幫你處理消息調(diào)度、工具調(diào)用、記憶管理這些臟活累活，你只需要專注寫業(yè)務(wù)邏輯。類似 Dify 或 Coze，但更輕量，適合想深入理解 Agent 工作原理的開發(fā)者。

環(huán)境要求一覽

不管你用什么系統(tǒng)，先確認(rèn)這幾樣?xùn)|西：

路徑一：Windows + WSL2（推薦指數(shù)：?????）

為什么選 WSL2？ OpenClaw 依賴的很多 npm 包在原生 Windows 上有路徑和權(quán)限問(wèn)題，WSL2 提供了一個(gè)完整的 Linux 環(huán)境，踩坑最少。

步驟 1：開啟 WSL2

打開 PowerShell（管理員），執(zhí)行：

wsl --install -d Ubuntu-22.04

重啟電腦后，Ubuntu 會(huì)自動(dòng)彈出，設(shè)置用戶名和密碼。

為什么要指定 Ubuntu 22.04？ 它的包管理最穩(wěn)定，社區(qū)遇到的問(wèn)題和解法最多，搜什么都搜得到。

步驟 2：安裝 Node.js

進(jìn)入 WSL 終端：

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

驗(yàn)證：

node -v   # 應(yīng)該輸出 v20.x.x
npm -v    # 應(yīng)該輸出 10.x.x

步驟 3：一鍵安裝 OpenClaw

npx openclaw@latest init my-agent
cd my-agent
npm install

npx openclaw@latest init 會(huì)自動(dòng)下載最新版腳手架，生成項(xiàng)目目錄。npm install 安裝所有依賴。

步驟 4：?jiǎn)?dòng)并驗(yàn)證

npm run dev

看到 OpenClaw server running on http://localhost:3000 就成功了。瀏覽器打開這個(gè)地址，能看到管理界面。

實(shí)測(cè)耗時(shí)： 約 3 分鐘（不含 WSL 首次安裝）。

常見問(wèn)題

• EACCES 權(quán)限錯(cuò)誤： 不要用 sudo npm install，改用 nvm 管理 Node 版本，或者執(zhí)行 sudo chown -R $(whoami) ~/.npm
• WSL 訪問(wèn) localhost 失?。?/strong> Windows 防火墻可能攔截了，執(zhí)行 netsh interface portproxy add v4tov4 listenport=3000 listenaddress=0.0.0.0 connectport=3000 connectaddress=localhost

路徑二：Docker 一鍵部署（推薦指數(shù)：?????）

為什么選 Docker？ 環(huán)境完全隔離，不污染本機(jī)，換機(jī)器直接遷移鏡像，團(tuán)隊(duì)協(xié)作最省心。

步驟 1：確保 Docker 已安裝

docker --version

沒裝的話，去 docker.com 下載 Docker Desktop。

步驟 2：拉取并運(yùn)行

docker run -d \
  --name openclaw \
  -p 3000:3000 \
  -v openclaw-data:/app/data \
  openclaw/openclaw:latest

為什么加 -v openclaw-data:/app/data？ 這是把數(shù)據(jù)持久化到 Docker 卷里，容器刪了數(shù)據(jù)還在。不加這行，你配置的 Agent 和對(duì)話記錄全沒了。

步驟 3：驗(yàn)證

docker logs -f openclaw

看到 Server ready 字樣，瀏覽器打開 http://localhost:3000。

實(shí)測(cè)耗時(shí)： 約 1 分鐘（前提是 Docker 已裝好）。

常見問(wèn)題

• 鏡像拉不下來(lái)： 配置 Docker 鏡像加速器，編輯 /etc/docker/daemon.json，加入 "registry-mirrors": ["https://mirror.ccs.tencentyun.com"]，然后 sudo systemctl restart docker
• 端口沖突： 改 -p 3001:3000 用其他端口

路徑三：macOS（推薦指數(shù)：????）

步驟 1：安裝 Node.js

用 Homebrew 最省事：

brew install node@20

步驟 2：安裝并啟動(dòng)

npx openclaw@latest init my-agent
cd my-agent && npm install
npm run dev

關(guān)于 Rosetta 2： 如果你用的是 M1/M2/M3 芯片，Node.js 20 已經(jīng)原生支持 ARM，不需要 Rosetta。只有極少數(shù)舊版 npm 包可能需要，遇到報(bào)錯(cuò)時(shí)執(zhí)行 softwareupdate --install-rosetta 即可。

實(shí)測(cè)耗時(shí)： 約 2 分鐘。

常見問(wèn)題

• xcrun: error: invalid active developer path： 執(zhí)行 xcode-select --install 安裝命令行工具
• M 芯片兼容問(wèn)題： 如果某個(gè)依賴編譯失敗，試試 arch -x86_64 npx openclaw@latest init my-agent 強(qiáng)制走 Rosetta

路徑四：Linux + systemd（推薦指數(shù)：???）

適合誰(shuí)？ 想把 OpenClaw 當(dāng)服務(wù)長(zhǎng)期跑在服務(wù)器上的開發(fā)者。

步驟 1：安裝 Node.js

curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

步驟 2：安裝 OpenClaw

sudo mkdir -p /opt/openclaw
cd /opt/openclaw
sudo npx openclaw@latest init .
sudo npm install --production

為什么加 --production？ 只裝運(yùn)行時(shí)依賴，不裝開發(fā)工具，鏡像體積小一半，啟動(dòng)更快。

步驟 3：創(chuàng)建 systemd 服務(wù)

sudo tee /etc/systemd/system/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw Agent Server
After=network.target

[Service]
Type=simple
User=openclaw
WorkingDirectory=/opt/openclaw
ExecStart=/usr/bin/node server.js
Restart=always
Environment=NODE_ENV=production

[Install]
WantedBy=multi-user.target
EOF

啟動(dòng)服務(wù)：

sudo useradd -r -s /bin/false openclaw
sudo chown -R openclaw:openclaw /opt/openclaw
sudo systemctl daemon-reload
sudo systemctl enable --now openclaw

步驟 4：驗(yàn)證

sudo systemctl status openclaw
curl http://localhost:3000/health

返回 {"status":"ok"} 就正常了。

實(shí)測(cè)耗時(shí)： 約 5 分鐘（多了 systemd 配置步驟）。

常見問(wèn)題

• 服務(wù)啟動(dòng)失敗： sudo journalctl -u openclaw -f 查看實(shí)時(shí)日志，通常是端口被占或權(quán)限問(wèn)題
• 想更新版本： cd /opt/openclaw && sudo npm update && sudo systemctl restart openclaw

四種方案對(duì)比

下一步學(xué)什么？

裝好 OpenClaw 只是開始。建議按這個(gè)順序推進(jìn)：

1. 跑通第一個(gè) Agent： 官方文檔的 Quick Start 帶你寫一個(gè)能回答天氣的簡(jiǎn)單 Agent
2. 接入工具調(diào)用： 學(xué)會(huì)用 MCP 協(xié)議給 Agent 加上搜索、數(shù)據(jù)庫(kù)查詢等能力
3. 部署到生產(chǎn)環(huán)境： 配合 Nginx 反向代理 + HTTPS，把你的 Agent 發(fā)布到公網(wǎng)

遇到問(wèn)題，去 OpenClaw GitHub Issues 搜一下，80% 的坑前人都踩過(guò)了。