OpenClaw 保姆级安装教程 2026 最新版：零基础 10 分钟搞定本地部署

想用 OpenClaw 但卡在安装这一步？别急，这篇教程专门写给零基础小白。从检查环境到跑通第一个对话，每一步都有命令和说明，跟着做就行。

安装前准备

你的电脑够不够格

先看下 OpenClaw 的最低要求：

配置项	最低要求	推荐配置
CPU	双核	四核及以上
内存	4GB	8GB 以上
硬盘	2GB 可用空间	10GB 以上（装模型需要）
系统	Windows 10 / macOS 10.15 / Ubuntu 18.04	最新稳定版

说实话，只要是近 5 年买的电脑，基本都能跑。

Node.js 必须先装好

OpenClaw 是用 Node.js 写的，所以得先有这个环境。

检查你有没有装过：

打开终端（Windows 按 Win+R 输入 cmd，Mac 按 Cmd+空格 输入 终端），输入：

node -v

如果显示版本号（比如 v20.11.0），说明已经装好了，版本大于 18 就行。

如果显示"不是内部或外部命令"或者"command not found"，那就得先装 Node.js。

安装 Node.js（三种方式）：

方式一：官网下载（最简单）

去 nodejs.org 下载 LTS 版本，一路下一步安装就行。

方式二：用 nvm 安装（推荐开发者）

Windows 用户下载 nvm-windows，Mac/Linux 用户：

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
nvm install 20
nvm use 20

方式三：用包管理器

Mac：

brew install node@20

Ubuntu/Debian：

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

装完后记得重启终端，再输入 node -v 确认一下。

方式一：一键安装脚本（推荐新手）

OpenClaw 官方提供了安装脚本，会自动检测系统、安装依赖、完成配置。这是最省事的方式。

Windows 用户

打开 PowerShell（管理员模式），复制粘贴：

iwr https://get.openclaw.ai | iex

等几分钟，脚本会自动完成：

• 检测并安装 Node.js（如果没有）
• 下载 OpenClaw
• 启动新手引导

Mac / Linux 用户

打开终端，输入：

curl -fsSL https://get.openclaw.ai | sh

如果提示权限问题，先输入：

sudo curl -fsSL https://get.openclaw.ai | sh

安装过程中会让你选择：

1. 安装位置（默认用户目录就行）
2. 是否创建桌面快捷方式
3. 是否开机自启动

新手直接一路回车用默认值就行。

方式二：npm 全局安装

如果你已经有 Node.js 环境，用 npm 安装更快：

npm install -g @openclaw/cli

装完后验证：

openclaw --version

显示版本号就说明装好了。

然后初始化工作目录：

# 创建一个文件夹
mkdir my-openclaw
cd my-openclaw

# 初始化
openclaw init

初始化过程会让你：

1. 选择默认模型（先选免费模型也行，后面可以改）
2. 设置工作目录名称
3. 是否安装推荐技能

方式三：从源码安装（开发者）

想看源码或者参与开发，可以克隆仓库：

# 克隆仓库
git clone https://github.com/nicepkg/openclaw.git
cd openclaw

# 安装依赖
npm install

# 构建
npm run build

# 启动
npm run start

这种方式适合想深入研究或者二次开发的用户。

首次启动和配置

启动 OpenClaw

安装完成后，启动命令：

openclaw start

第一次启动会比较慢，因为要：

• 初始化配置文件
• 下载必要的依赖
• 构建缓存

看到 OpenClaw is running 或者 Dashboard: http://localhost:3000 就说明成功了。

打开控制台

浏览器访问 http://localhost:3000，你会看到 OpenClaw 的控制台界面。

如果是第一次使用，会进入新手引导流程：

1. 选择模型：推荐先选内置免费模型体验，后续可以配置自己的 API
2. 设置智能体名称：给你的 AI 助手起个名字
3. 选择频道：选择在哪里使用（控制台、Discord、微信等）

配置大模型

OpenClaw 支持多种模型后端。新手建议先用免费方案：

方案一：内置免费模型

在控制台选择"使用内置模型"，无需配置 API Key，但每天有调用次数限制。

方案二：接入第三方 API

点击"设置" → "模型配置" → "添加模型"，填入：

• 模型名称（如 gpt-4）
• API Key
• Base URL（可选）

支持的平台包括：

• OpenAI
• Anthropic（Claude）
• 阿里云百炼
• 腾讯云
• DeepSeek
• Kimi（月之暗面）
• 本地 Ollama

测试一下

在控制台输入框里发条消息：

你好，请介绍一下你自己

如果收到回复，恭喜你，安装成功！

常见安装问题

问题一：node 不是内部或外部命令

原因：Node.js 没装或者没加到环境变量。

解决：

1. 重新安装 Node.js，勾选"Add to PATH"
2. 或者手动添加环境变量

问题二：npm install 很慢或者失败

原因：国内访问 npm 官方源速度慢。

解决：换成国内镜像

# 临时使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 或者用 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com
cnpm install -g @openclaw/cli

问题三：端口被占用

启动时报 Port 3000 is already in use

解决：

# Windows：查找占用端口的进程
netstat -ano | findstr :3000
taskkill /PID <进程ID> /F

# Mac/Linux
lsof -i :3000
kill -9 <进程ID>

或者换个端口启动：

openclaw start --port 3001

问题四：Permission denied

Mac/Linux 用户遇到权限问题：

# 给安装目录权限
sudo chown -R $(whoami) ~/.openclaw

# 或者重新安装到用户目录
npm config set prefix ~/.npm-global

问题五：ERR_UNSUPPORTED_ESM_URL_SCHEME

这是 Node.js 模块加载问题，通常是 Node 版本不兼容。

解决：

1. 升级 Node.js 到 18 以上
2. 或者降级到 16.x

nvm install 18
nvm use 18

进阶配置

配置文件在哪

配置文件位于工作目录下的 config/ 文件夹：

my-openclaw/
├── config/
│   ├── settings.yaml    # 主配置
│   ├── models.yaml      # 模型配置
│   └── agents.yaml      # 智能体配置
├── data/
│   └── memory/          # 记忆存储
└── logs/                # 日志文件

开机自启动

Windows：

# 安装为 Windows 服务
openclaw service install

Mac/Linux：

用 systemd 或 pm2 管理：

# 用 pm2
npm install -g pm2
pm2 start "openclaw start" --name openclaw
pm2 save
pm2 startup

后台运行

# 后台启动
openclaw start --daemon

# 查看状态
openclaw status

# 停止
openclaw stop

下一步

安装完成后，你可以：

1. 安装技能：在控制台或用命令 openclaw skill install <技能名>
2. 接入频道：配置 Discord、微信、钉钉等
3. 自定义智能体：编辑 agents.yaml 设置智能体人设
4. 配置记忆：开启持久化记忆让助手记住你

别被这么多配置吓到，先用起来，有问题再慢慢调。OpenClaw 的魅力在于越用越顺手，慢慢你会发现它能帮你做的事情比想象中多得多。