虚拟机安装openclaw指导文档

昨晚安装openclaw之后虚拟机打开失败，需要修改配置，按以下操作来试试：：

下面给你 Ubuntu 虚拟机（VirtualBox/VMware）安装 OpenClaw 的完整、可直接复制步骤，含虚拟机配置、安装、浏览器修复、验证全流程。

一、虚拟机基础配置（必做）

– CPU：≥2核，开启 VT-x/AMD-V 硬件虚拟化

– 内存：≥4GB（推荐8GB）

– 硬盘：≥20GB（SSD更佳）

– 网络：默认 NAT 即可（宿主机访问用桥接）

– 系统：Ubuntu 22.04 / 24.04（64位）

二、虚拟机内：系统准备（普通用户）

bash
 

# 更新系统

sudo apt update && sudo apt upgrade -y

# 安装基础工具

sudo apt install -y curl git build-essential ca-certificates

# 重启（可选，更稳）

sudo reboot

三、安装 OpenClaw（普通用户，不要root）

方法1：官方一键脚本（推荐）

bash
 

# 一键安装（自动装 Node.js 22+、npm、openclaw）

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

# 验证安装

openclaw –version

出现版本号即成功。

方法2：手动npm安装（已有Node时）

bash
 

# 国内镜像（可选，加速）

npm config set registry https://registry.npmmirror.com

# 全局安装

npm install -g openclaw@latest

# 初始化并安装守护进程

openclaw onboard –install-daemon

四、虚拟机必做：浏览器修复（解决打不开）

1. 安装 Chrome（不要Snap版）

bash
 

# 卸载Snap Chromium（Ubuntu默认）

sudo snap remove chromium

# 安装官方Chrome

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb

sudo dpkg -i google-chrome-stable_current_amd64.deb

sudo apt -f install -y

# 验证

google-chrome –version

2. 配置浏览器无沙箱（虚拟机必须加）

bash
 

# 编辑配置文件

nano ~/.openclaw/openclaw.json

找到  browser  部分，添加/修改：

json
 

“executablePath”: “/usr/bin/google-chrome”,

“args”: [“–no-sandbox”, “–disable-setuid-sandbox”, “–headless=new”]

按  Ctrl+O  保存， Ctrl+X  退出。

3. 重启服务并启动浏览器

bash
 

# 重启网关

systemctl –user restart openclaw-gateway

# 等待5秒

sleep 5

# 启动浏览器

openclaw browser start

# 查看状态（关键）

openclaw browser status

✅ 成功标志： running: true 

五、端口与防火墙（虚拟机常见坑）

bash
 

# 检查18800端口是否被占用

lsof -i :18800

# 有占用就kill

# kill -9 <PID>

# 开放端口（Ubuntu防火墙）

sudo ufw allow 18789

sudo ufw allow 18800

sudo ufw reload

六、最终验证（全流程通）

bash
 

# 查看服务状态

systemctl –user status openclaw-gateway

# 浏览器状态

openclaw browser status

# 访问Web UI（宿主机浏览器打开）

# 虚拟机IP:18789

# 如：http://192.168.1.100:18789

七、常见问题快速修复

– 浏览器还是打不开：再检查  –no-sandbox  是否正确添加

– 服务起不来： openclaw logs –tail 50  看日志

– 端口被占：换端口或kill进程

– 权限问题：全程用普通用户，不要root运行