OpenClaw安装Windows/Mac/Linux 系统都行

 把 OpenClaw 安装流程拆解成“分系统、分场景、零门槛、避坑版“的保姆级步骤，不管你是 Windows/Mac/Linux 用户，哪怕完全不懂代码，跟着做都能装成功。

核心前提先明确

1. OpenClaw 免费开源，消耗的是你电脑/服务器资源（免费）；

2. 仅需为 “AI 模型 API“ 付费（国内厂商首月低至7.9元，可先体验）；

3. 最低配置要求：Node.js ≥ 22（安装脚本会自动搞定，不用管）。

一、懒人版：一键安装（90%用户首选，5分钟搞定）

1. Windows 系统

步骤1：打开 PowerShell（管理员模式）

- 按下 `Win + X` → 选择「Windows PowerShell (管理员)」→ 允许权限。

步骤2：复制执行一键安装命令

```powershell

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

```

步骤3：等待执行完成

脚本会自动安装：NVM（Node版本管理）→ Node.js 22 → OpenClaw → 配置国内镜像（解决网络问题）。

验证是否安装成功：

在 PowerShell 输入：

```powershell

openclaw -v

```

输出版本号（如 `v1.8.2`）= 安装成功。

2. Mac/Linux 系统

步骤1：打开终端

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

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

步骤2：复制执行一键安装命令

```bash

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

```

步骤3：等待执行完成（Linux可能需要输入sudo密码）

验证是否安装成功：

在终端输入：

```bash

openclaw -v

```

输出版本号 = 安装成功。

二、手动安装（一键脚本失败时用，更稳）

如果一键脚本因系统依赖报错，按以下步骤手动装，适合新手：

通用步骤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

配置环境

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

```

验证 Node 安装：

```bash

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

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

```

通用步骤2：安装 OpenClaw

1. 打开终端/PowerShell，执行：

```bash

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

```

2. 执行初始化配置：

```bash

openclaw onboard --install-daemon

```

   - `onboard`：交互式引导，帮你完成基础配置；

   - `--install-daemon`：注册为系统守护进程，开机自动运行（不用每次手动启动）。

3. 按提示完成配置：

   - 选择语言（选「中文」）；

   - 确认安装路径（默认即可）；

   - 暂时跳过模型配置（后面单独对接）。

通用步骤3：验证 OpenClaw 启动

```bash

openclaw start

```

输出「OpenClaw gateway started on port 3000」= 启动成功。

三、对接国内 AI 模型（关键步骤，让 OpenClaw 有“大脑”）

以「阿里通义（首月7.9元，最适合新手）」为例：

步骤1：购买模型套餐

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

2. 选择「首月7.9元套餐」→ 购买 → 关闭自动续费（避免高价续费）。

步骤2：获取 API Key

1. 登录阿里百炼控制台：https://bailian.console.aliyun.com/

2. 「API 访问」→ 「创建 AccessKey」→ 保存 AccessKey ID 和 Secret（重要，别丢）。

步骤3：配置 OpenClaw 对接阿里模型

```bash

设置模型提供商

openclaw config set llm.provider tongyi

设置 API Key

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

设置模型名称

openclaw config set llm.model qwen-max

验证配置

openclaw config get llm

```

测试模型是否生效：

```bash

openclaw run "用一句话介绍 OpenClaw"

```

输出回答 = 模型对接成功。

四、必装 8 个核心技能（装完才算真能用）

```bash

一键安装核心技能（国内镜像）

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`：自我优化，记录错误并学习；

2. `browser`：浏览器自动化（核心技能，能搜/爬/填表单）；

3. `desktop-control`：控制电脑鼠标/键盘；

4. `auto-updater`：自动更新 OpenClaw 和技能；

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

6. `subagent-driven-development`：AI委派子任务；

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

8. `clawhub`：技能市场，一键装其他技能。

五、常见坑&解决方法（新手必看）

1. “一键脚本报错“：

   - 原因：系统缺少依赖（如Windows缺少.NET、Linux缺少curl）；

   - 解决：手动装依赖后，重新执行脚本。

2. “Node版本不够“：

   - 解决：用NVM切换版本：`nvm install 22 && nvm use 22`。

3. “模型对接失败“：

   - 检查 API Key 是否正确；

   - 确认模型套餐有余额；

   - 国内用户记得配置代理（如果需要）。

4. “技能安装慢“：

   - 加国内镜像：`--registry https://clawhub.npmmirror.com`。

六、启动&停止 OpenClaw（日常使用）

```bash

启动（后台运行）

openclaw start

停止

openclaw stop

查看状态

openclaw status

重启

openclaw restart

```

总结

1. 安装核心：优先一键脚本，失败再手动装 Node + OpenClaw；

2. 关键步骤：对接 AI 模型（没模型=空壳）+ 装核心技能；

3. 避坑重点：用国内镜像、验证版本、保存 API Key；

4. 验证标准：`openclaw -v` 有版本、`openclaw run` 有回答、技能安装无报错。

按这个流程走，哪怕是纯新手，30分钟内必能把 OpenClaw 跑起来，接下来就可以“养”它、用它干活了。

本文链接：https://www.idcbest.com/cloundnews/11016908.html