OpenClaw 零基础安装教程

从零开始，10分钟完成安装配置

一、系统要求

操作系统：

• macOS 13.5 或更高版本（推荐 macOS 14+）

• Windows 10/11（64位）

• Ubuntu 20.04 或更高版本

为什么要 macOS 13.5+？

OpenClaw 最低要求 Node.js 22，而 Node.js 22 要求 macOS 13.5 以上才能正常运行。当前 Node.js LTS 版本是 24.x。

硬件要求：

• 至少 4GB 内存（推荐 8GB）

• 至少 2GB 可用磁盘空间

• 稳定的网络连接

二、安装 Node.js

macOS 用户

方法一：官网下载（推荐）

1. 打开浏览器，访问 https://nodejs.org

2. 点击绿色按钮下载 LTS 版本（当前是 24.x）

3. 下载完成后，双击 .pkg 文件

4. 按照安装向导一路点击"继续"，输入密码完成安装

5. 打开"终端"（应用程序 → 实用工具 → 终端），输入：

node --version

如果显示版本号，说明安装成功。

方法二：使用 Homebrew

brew install node

Windows 用户

1. 访问 https://nodejs.org

2. 下载 LTS 版本（Windows Installer .msi 文件）

3. 双击安装包，勾选"Automatically install the necessary tools"

4. 安装完成后，打开"命令提示符"或"PowerShell"

5. 输入 node --version 验证安装

Linux 用户

Ubuntu/Debian 系统：

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

验证安装：

node --version
npm --version

三、安装 OpenClaw

1. 打开终端

• macOS： 应用程序 → 实用工具 → 终端

• Windows： 开始菜单搜索"PowerShell"或"cmd"

• Linux： Ctrl+Alt+T

2. 安装 OpenClaw

在终端中输入：

npm install -g openclaw

安装过程需要 2-5 分钟，会看到很多下载信息，这是正常的。

国内用户提示： 如果下载速度慢，可以使用淘宝镜像：

npm config set registry https://registry.npmmirror.com
npm install -g openclaw

3. 验证安装

安装完成后，输入：

openclaw --version

如果显示版本号，说明安装成功。

四、初始化 OpenClaw

1. 运行初始化向导

在终端中输入：

openclaw onboard --install-daemon

这个命令会：

• 创建配置文件

• 安装并启动网关服务（daemon）

• 设置工作目录

初始化过程中会询问一些问题，暂时可以直接按回车跳过（API Key 配置留到下期教程）。

如果 Gateway 安装成功： 会自动打开浏览器访问 Web 界面。

如果 Gateway 安装失败： 需要手动启动，运行以下命令：

openclaw gateway --port 18789 --verbose

2. 访问 Web 界面

初始化完成后，打开浏览器访问：

http://localhost:18789

如果看到 OpenClaw 的 Web 界面，恭喜你，安装成功！

注意： 此时还没有配置 API Key，所以暂时无法与 AI 对话。下期教程会详细讲解如何配置。

3. 其他常用命令

# 查看服务状态
openclaw gateway status

# 停止服务
openclaw gateway stop

# 重启服务
openclaw gateway restart

五、常见问题

Q1: 无法访问 http://localhost:18789

A: 检查以下几点：

• 确认 gateway 服务已启动（运行 openclaw gateway status）

• 检查端口是否被占用

• 尝试用 IP 地址访问（如 http://127.0.0.1:18789）

Q2: macOS 提示"无法验证开发者"

A: 系统偏好设置 → 安全性与隐私 → 允许从以下位置下载的 App → 任何来源

Q3: Windows Defender 拦截

A: 这是误报，点击"允许"即可。OpenClaw 是开源项目，代码完全透明。

六、下一步

安装完成后，你需要：

1. 获取 API Key（下期教程详细讲解）

2. 配置 OpenClaw

3. 开始与 AI 对话

更多资源：

• 官方文档：https://docs.openclaw.ai

• 社区讨论：https://discord.com/invite/clawd

• 技能市场：https://clawhub.com

下期预告： 如何获取和配置 API Key，让 OpenClaw 真正运行起来。

关注我，下期教你如何获取 API Key！