把 OpenClaw 安裝流程拆解成“分系統(tǒng)、分場(chǎng)景、零門檻、避坑版“的保姆級(jí)步驟，不管你是 Windows/Mac/Linux 用戶，哪怕完全不懂代碼，跟著做都能裝成功。

核心前提先明確

1. OpenClaw 免費(fèi)開源，消耗的是你電腦/服務(wù)器資源（免費(fèi)）；

2. 僅需為 “AI 模型 API“ 付費(fèi)（國內(nèi)廠商首月低至7.9元，可先體驗(yàn)）；

3. 最低配置要求：Node.js ≥ 22（安裝腳本會(huì)自動(dòng)搞定，不用管）。

一、懶人版：一鍵安裝（90%用戶首選，5分鐘搞定）

1. Windows 系統(tǒng)

步驟1：打開 PowerShell（管理員模式）

- 按下 `Win + X` → 選擇「Windows PowerShell (管理員)」→ 允許權(quán)限。

步驟2：復(fù)制執(zhí)行一鍵安裝命令

```powershell

iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1 -Registry https://registry.npmmirror.com

```

步驟3：等待執(zhí)行完成

腳本會(huì)自動(dòng)安裝：NVM（Node版本管理）→ Node.js 22 → OpenClaw → 配置國內(nèi)鏡像（解決網(wǎng)絡(luò)問題）。

驗(yàn)證是否安裝成功：

在 PowerShell 輸入：

```powershell

openclaw -v

```

輸出版本號(hào)（如 `v1.8.2`）= 安裝成功。

2. Mac/Linux 系統(tǒng)

步驟1：打開終端

- Mac：聚焦搜索「終端」；

- Linux：按下 `Ctrl + Alt + T`。

步驟2：復(fù)制執(zhí)行一鍵安裝命令

```bash

curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com

```

步驟3：等待執(zhí)行完成（Linux可能需要輸入sudo密碼）

驗(yàn)證是否安裝成功：

在終端輸入：

```bash

openclaw -v

```

輸出版本號(hào) = 安裝成功。

二、手動(dòng)安裝（一鍵腳本失敗時(shí)用，更穩(wěn)）

如果一鍵腳本因系統(tǒng)依賴報(bào)錯(cuò)，按以下步驟手動(dòng)裝，適合新手：

通用步驟1：安裝 Node.js（≥22）

Windows：

1. 下載地址：https://nodejs.org/dist/v22.0.0/node-v22.0.0-x64.msi

2. 雙擊安裝 → 一路下一步（勾選「Add to PATH」）→ 完成。

Mac：

```bash

安裝Homebrew（如果沒裝）

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

安裝Node.js 22

brew install node@22

配置環(huán)境

echo "export PATH="/usr/local/opt/node@22/bin:$PATH"" >> ~/.zshrc

source ~/.zshrc

```

Linux（Ubuntu/Debian）：

```bash

安裝依賴

sudo apt update && sudo apt install -y curl

安裝Node.js 22

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

sudo apt install -y nodejs

```

驗(yàn)證 Node 安裝：

```bash

node -v  輸出 v22.x.x 即可

npm -v   輸出 10.x.x 即可

```

通用步驟2：安裝 OpenClaw

1. 打開終端/PowerShell，執(zhí)行：

```bash

npm install -g openclaw@latest --registry https://registry.npmmirror.com

```

2. 執(zhí)行初始化配置：

```bash

openclaw onboard --install-daemon

```

   - `onboard`：交互式引導(dǎo)，幫你完成基礎(chǔ)配置；

   - `--install-daemon`：注冊(cè)為系統(tǒng)守護(hù)進(jìn)程，開機(jī)自動(dòng)運(yùn)行（不用每次手動(dòng)啟動(dòng)）。

3. 按提示完成配置：

   - 選擇語言（選「中文」）；

   - 確認(rèn)安裝路徑（默認(rèn)即可）；

   - 暫時(shí)跳過模型配置（后面單獨(dú)對(duì)接）。

通用步驟3：驗(yàn)證 OpenClaw 啟動(dòng)

```bash

openclaw start

```

輸出「OpenClaw gateway started on port 3000」= 啟動(dòng)成功。

三、對(duì)接國內(nèi) AI 模型（關(guān)鍵步驟，讓 OpenClaw 有“大腦”）

以「阿里通義（首月7.9元，最適合新手）」為例：

步驟1：購買模型套餐

1. 打開鏈接：https://www.aliyun.com/benefit/ai/aistar?userCode=vz8mervt

2. 選擇「首月7.9元套餐」→ 購買 → 關(guān)閉自動(dòng)續(xù)費(fèi)（避免高價(jià)續(xù)費(fèi)）。

步驟2：獲取 API Key

1. 登錄阿里百煉控制臺(tái)：https://bailian.console.aliyun.com/

2. 「API 訪問」→ 「創(chuàng)建 AccessKey」→ 保存 AccessKey ID 和 Secret（重要，別丟）。

步驟3：配置 OpenClaw 對(duì)接阿里模型

```bash

設(shè)置模型提供商

openclaw config set llm.provider tongyi

設(shè)置 API Key

openclaw config set llm.api-key "你的AccessKey ID:你的AccessKey Secret"

設(shè)置模型名稱

openclaw config set llm.model qwen-max

驗(yàn)證配置

openclaw config get llm

```

測(cè)試模型是否生效：

```bash

openclaw run "用一句話介紹 OpenClaw"

```

輸出回答 = 模型對(duì)接成功。

四、必裝 8 個(gè)核心技能（裝完才算真能用）

```bash

一鍵安裝核心技能（國內(nèi)鏡像）

clawhub install self-improvement browser desktop-control auto-updater skill-vetter subagent-driven-development vector-memory clawhub --registry https://clawhub.npmmirror.com

```

技能作用（新手必懂）：

1. `self-improvement`：自我優(yōu)化，記錄錯(cuò)誤并學(xué)習(xí)；

2. `browser`：瀏覽器自動(dòng)化（核心技能，能搜/爬/填表單）；

3. `desktop-control`：控制電腦鼠標(biāo)/鍵盤；

4. `auto-updater`：自動(dòng)更新 OpenClaw 和技能；

5. `skill-vetter`：掃描技能安全性，防偷文件；

6. `subagent-driven-development`：AI委派子任務(wù)；

7. `vector-memory`：本地向量記憶，越用越懂你；

8. `clawhub`：技能市場(chǎng)，一鍵裝其他技能。

五、常見坑&解決方法（新手必看）

1. “一鍵腳本報(bào)錯(cuò)“：

   - 原因：系統(tǒng)缺少依賴（如Windows缺少.NET、Linux缺少curl）；

   - 解決：手動(dòng)裝依賴后，重新執(zhí)行腳本。

2. “Node版本不夠“：

   - 解決：用NVM切換版本：`nvm install 22 && nvm use 22`。

3. “模型對(duì)接失敗“：

   - 檢查 API Key 是否正確；

   - 確認(rèn)模型套餐有余額；

   - 國內(nèi)用戶記得配置代理（如果需要）。

4. “技能安裝慢“：

   - 加國內(nèi)鏡像：`--registry https://clawhub.npmmirror.com`。

六、啟動(dòng)&停止 OpenClaw（日常使用）

```bash

啟動(dòng)（后臺(tái)運(yùn)行）

openclaw start

停止

openclaw stop

查看狀態(tài)

openclaw status

重啟

openclaw restart

```

總結(jié)

1. 安裝核心：優(yōu)先一鍵腳本，失敗再手動(dòng)裝 Node + OpenClaw；

2. 關(guān)鍵步驟：對(duì)接 AI 模型（沒模型=空殼）+ 裝核心技能；

3. 避坑重點(diǎn)：用國內(nèi)鏡像、驗(yàn)證版本、保存 API Key；

4. 驗(yàn)證標(biāo)準(zhǔn)：`openclaw -v` 有版本、`openclaw run` 有回答、技能安裝無報(bào)錯(cuò)。

按這個(gè)流程走，哪怕是純新手，30分鐘內(nèi)必能把 OpenClaw 跑起來，接下來就可以“養(yǎng)”它、用它干活了。

本文鏈接：http://51huadong.com/cloundnews/11016908.html