Ubuntu 虚拟机安装 OpenClaw 完整流程
基础环境配置（免密设置）
为了在后续安装脚本运行中避免频繁输入密码，我们需要为当前用户开启sudo免密权限。
1.1 编辑 sudoers 配置
sudo visudo
1.2 添加免密权限
在文件末尾添加以下内容（将spoto替换为你实际的用户名）：
spoto ALL=(ALL) NOPASSWD: ALL1.3 保存并退出
nano编辑器：按Ctrl+O保存，Enter确认，Ctrl+X退出vim编辑器：输入:wq保存退出
2. 安装基础工具与 OpenSSH
确保系统更新，并安装远程连接及脚本下载所需的组件。
# 更新系统包列表 sudo apt update # 安装基础下载工具 sudo apt install -y curl # 安装并启动 OpenSSH 服务（方便通过 PC 远程管理） sudo apt install -y openssh-server
2.1 验证 SSH 服务状态
# 检查 SSH 服务状态 sudo systemctl status ssh # 如果服务未启动，使用以下命令启动 sudo systemctl start ssh
2.2 获取虚拟机 IP 地址
# 获取局域网 IP 地址，用于远程连接 ip addr show | grep -E "inet " | awk '{print $2}' | cut -d'/' -f1 | grep -v "^127"记录此 IP 地址，后续可通过 SSH 远程管理虚拟机。
3. 安装 OpenClaw (官方脚本)
使用官方提供的一键安装脚本进行部署：
curl -fsSL https://molt.bot/install.sh | bash
4. 配置向导
运行配置向导完成基本设置（推荐）：
openclaw onboard --install-daemon
4.1 向导配置选项
按照向导提示完成配置：
- 选择安全选项- 理解风险
- 配置工作区目录- 设置工作文件存放位置
- 配置国内 API（可选）- 选择 MiniMax 或智谱，输入 API Key
- 配置局域网访问（可选）- 开启 LAN Access
- 设置认证方式- Token 认证
4.2 验证安装
# 检查 openclaw 是否安装成功 which openclaw # 查看版本 openclaw --version # 检查 Gateway 状态 openclaw gateway status
5. 国内 API 配置
与旧版教程的区别：新版 OpenClaw 向导会自动识别并配置模型，无需手动编辑配置文件。
5.1 使用向导配置（推荐）
openclaw onboard
选择对应 API 服务商，输入 API Key 即可。
5.2 API Key 获取
| 服务商 | 地址 |
|---|---|
| MiniMax | https://www.minimaxi.com → 控制台 → API Keys |
| 智谱 AI | https://bigmodel.cn → 控制台 → API Keys |
5.3 验证模型
openclaw models list
6. 局域网访问配置
注意：配置向导可以开启局域网访问，但无法直接配置 controlUi，需要手动添加。
6.1 使用向导开启局域网
openclaw onboard
选择Enable LAN Access或类似选项。
6.2 手动添加 controlUi 配置
向导设置后，需手动编辑配置文件：
nano ~/.openclaw/openclaw.json
在 gateway 配置中添加：
"controlUi": { "dangerouslyAllowHostHeaderOriginFallback": true, "allowInsecureAuth": true, "dangerouslyDisableDeviceAuth": true }6.3 重启 Gateway
openclaw gateway restart
6.4 获取访问信息
# 获取局域网 IP ip addr show | grep -E "inet " | awk '{print $2}' | cut -d'/' -f1 | grep -v "^127" # 获取 Token grep '"token"' ~/.openclaw/openclaw.json访问地址：http://<你的局域网IP>:18789/
7. 浏览器扩展安装
如需在 OpenClaw 中调用浏览器功能，请在终端执行扩展安装命令：
openclaw browser extension install
7.1 验证浏览器扩展
# 检查浏览器扩展状态 openclaw browser status
常见问题
Q1: sudo 免密设置失败
问题：执行sudo visudo时权限不足
解决方案：
# 切换到 root 用户 su - # 然后执行 visudo visudo
Q2: SSH 无法连接
问题：从主机无法 SSH 连接虚拟机
解决方案：
检查虚拟机防火墙：
sudo ufw status sudo ufw allow ssh
检查 SSH 服务：
sudo systemctl restart ssh
确认虚拟机 IP 地址正确
Q3: OpenClaw 安装失败
问题：官方脚本安装失败
解决方案：
检查系统要求：
node --version # 需要 Node.js ≥ 22
清理后重试：
npm uninstall -g openclaw npm cache clean --force curl -fsSL https://molt.bot/install.sh | bash
查看错误日志：
tail -f ~/.openclaw/logs/gateway.log
Q4: 向导找不到
问题：openclaw onboard命令不存在
解决方案：
openclaw --version # 确保版本 ≥ 2026.1.24 # 如需更新 openclaw update
Q5: 局域网无法访问
问题：其他设备无法访问 Web UI
解决方案：
- 确认已按 6.2 节添加 controlUi 配置
- 检查防火墙：
sudo ufw allow 18789/tcp - 重启 Gateway：
openclaw gateway restart