本指南基于 OpenClaw 官方文档，详细介绍如何在虚拟机中部署 OpenClaw 环境。按照本指南操作，您将能够在虚拟机中成功安装和配置 OpenClaw。

准备工作

系统要求

根据官方文档，OpenClaw 需要以下环境：

• Node.js 20+：必须安装 Node.js 20 或更高版本
• 操作系统：支持 Linux、macOS 和 Windows (WSL 2 或 PowerShell)

虚拟机配置建议

• CPU：至少 2 核
• 内存：至少 4GB RAM（建议 8GB 以上）
• 存储：至少 50GB 可用空间
• 网络：稳定的网络连接

第一步：创建虚拟机

安装虚拟机软件

1. 下载并安装 VirtualBox
2. 下载 Ubuntu 22.04 LTS 镜像文件

创建并配置虚拟机

1. 打开 VirtualBox，点击 "新建"
2. 名称：输入 "OpenClaw"
3. ISO 镜像：选择下载好的 Ubuntu 镜像文件
4. 内存：设置为至少 4GB（4096MB）
5. 硬盘：至少 50GB
6. 点击 "完成" 创建虚拟机

安装 Ubuntu 操作系统

1. 启动虚拟机
2. 按照安装向导完成 Ubuntu 安装
3. 创建用户账户并设置密码
4. 安装完成后重启虚拟机

第二步：安装 Node.js

打开终端

在 Ubuntu 系统中，按下 Ctrl + Alt + T 打开终端。

安装 Node.js 20+

在终端中输入以下命令：

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

验证 Node.js 安装

输入以下命令验证安装是否成功：

node -v

如果显示 Node.js 版本号（如 v20.x.x），则安装成功。

第三步：安装 OpenClaw

OpenClaw 提供两种安装方式：快速安装和手动安装。

方法一：快速安装

在终端中输入以下命令：

curl -fsSL https://openclaw.ai/install.sh | bash

方法二：手动安装

如果您希望手动控制每一步，可以按照以下步骤安装：

1. 克隆仓库

git clone https://github.com/openclaw/openclaw.git ~/.openclaw
cd ~/.openclaw

2. **安装依赖**
```bash
npm install

1. 构建项目

npm run build

4. **创建默认配置**
```bash
npm run init

第四步：配置环境变量

添加 OpenClaw 到 PATH

在终端中输入以下命令：

export PATH="$HOME/.openclaw/bin:$PATH"

永久添加到环境变量

编辑 ~/.bashrc 文件：

nano ~/.bashrc

在文件末尾添加以下行：

export PATH="$HOME/.openclaw/bin:$PATH"

保存并退出（按 Ctrl + X，然后按 Y，最后按回车）。

应用环境变量

source ~/.bashrc

第五步：验证安装

检查 OpenClaw 版本

openclaw --version

如果显示版本号（如 OpenClaw v1.0.0），则安装成功。

运行健康检查

openclaw doctor

这个命令会检查：

• Node.js 版本是否正确
• 所有必需的依赖是否安装
• 配置文件是否有效
• 与技能注册表的网络连接
• Docker 可用性（如果适用）

第六步：启动 OpenClaw

启动服务

openclaw start

访问 OpenClaw

在浏览器中输入 http://localhost:3000 访问 OpenClaw 界面。

常见问题及解决方案

1. npm 安装失败，提示权限错误

解决方案：

mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
export PATH="$HOME/.npm-global/bin:$PATH"
source ~/.bashrc
npm install

2. node: command not found

解决方案：
重新安装 Node.js：

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

3. 构建失败，提示内存不足

解决方案：
增加 Node.js 堆大小：

export NODE_OPTIONS="--max-old-space-size=4096"
npm run build

4. curl: command not found

解决方案：
安装 curl：

sudo apt update && sudo apt install -y curl

5. 端口 3000 已被占用

解决方案：
修改配置文件中的端口：

nano ~/.openclaw/config.yaml

找到并修改以下内容：

server:
  port: 3001

或者通过环境变量设置：

export OPENCLAW_PORT=3001
openclaw start

第七步：更新 OpenClaw

快速更新

openclaw update

手动更新

cd ~/.openclaw
git pull origin main
npm install
npm run build

第八步：卸载 OpenClaw

完全移除 OpenClaw

# 删除安装目录
rm -rf ~/.openclaw

# 从 shell 配置文件中移除 PATH 条目
# 编辑 ~/.bashrc 并删除包含 openclaw 的行

总结

恭喜您！您已成功在虚拟机中部署了 OpenClaw 环境。按照官方文档的要求，您现在可以开始使用 OpenClaw 了。

如果您在部署过程中遇到任何问题，请参考本指南中的 "常见问题及解决方案" 部分，或访问 OpenClaw 官方文档 获取更多帮助。

---

最后更新时间：2026 年 2 月 21 日
版本：1.0.0