本教程适用于在 Ubuntu 虚拟机环境下，通过官方脚本部署 OpenClaw。

注意：新版 OpenClaw（2026.1.24+）使用配置向导，无需手动设置模型，向导会自动识别并配置可用模型。

• 1. 基础环境配置（免密设置）
• 2. 安装基础工具与 OpenSSH
• 3. 安装 OpenClaw (官方脚本)
• 4. 配置向导
• 5. 国内 API 配置
• 6. 局域网访问配置
• 7. 浏览器扩展安装

为了在后续安装脚本运行中避免频繁输入密码，我们需要为当前用户开启 sudo 免密权限。

sudo visudo

在文件末尾添加以下内容（将 spoto 替换为你实际的用户名）：

spoto ALL=(ALL) NOPASSWD: ALL

• nano 编辑器：按 Ctrl+O 保存，Enter 确认，Ctrl+X 退出
• vim 编辑器：输入 :wq 保存退出

确保系统更新，并安装远程连接及脚本下载所需的组件。

# 更新系统包列表
sudo apt update

# 安装基础下载工具
sudo apt install -y curl

# 安装并启动 OpenSSH 服务（方便通过 PC 远程管理）
sudo apt install -y openssh-server

# 检查 SSH 服务状态
sudo systemctl status ssh

# 如果服务未启动，使用以下命令启动
sudo systemctl start ssh

# 获取局域网 IP 地址，用于远程连接
ip addr show | grep -E "inet " | awk '{print $2}' | cut -d'/' -f1 | grep -v "^127"

记录此 IP 地址，后续可通过 SSH 远程管理虚拟机。

使用官方提供的一键安装脚本进行部署：

curl -fsSL https://molt.bot/install.sh | bash

运行配置向导完成基本设置（推荐）：

openclaw onboard --install-daemon

按照向导提示完成配置：

1. 选择安全选项 - 理解风险
2. 配置工作区目录 - 设置工作文件存放位置
3. 配置国内 API（可选）- 选择 MiniMax 或智谱，输入 API Key
4. 配置局域网访问（可选）- 开启 LAN Access
5. 设置认证方式 - Token 认证

# 检查 openclaw 是否安装成功
which openclaw

# 查看版本
openclaw --version

# 检查 Gateway 状态
openclaw gateway status

与旧版教程的区别：新版 OpenClaw 向导会自动识别并配置模型，无需手动编辑配置文件。

openclaw onboard

选择对应 API 服务商，输入 API Key 即可。

openclaw models list

注意：配置向导可以开启局域网访问，但 无法直接配置 controlUi，需要手动添加。

openclaw onboard

选择 Enable LAN Access 或类似选项。

向导设置后，需手动编辑配置文件：

nano ~/.openclaw/openclaw.json

在 gateway 配置中添加：

"controlUi": {
  "dangerouslyAllowHostHeaderOriginFallback": true,
  "allowInsecureAuth": true,
  "dangerouslyDisableDeviceAuth": true
}

openclaw gateway restart

# 获取局域网 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/

如需在 OpenClaw 中调用浏览器功能，请在终端执行扩展安装命令：

openclaw browser extension install

# 检查浏览器扩展状态
openclaw browser status

问题：执行 sudo visudo 时权限不足

解决方案：

# 切换到 root 用户
su -

# 然后执行 visudo
visudo

问题：从主机无法 SSH 连接虚拟机

解决方案：

1. 检查虚拟机防火墙：

   sudo ufw status
   sudo ufw allow ssh

2. 检查 SSH 服务：

   sudo systemctl restart ssh

3. 确认虚拟机 IP 地址正确

问题：官方脚本安装失败

解决方案：

1. 检查系统要求：

   node --version  # 需要 Node.js ≥ 22

2. 清理后重试：

   npm uninstall -g openclaw
   npm cache clean --force
   curl -fsSL https://molt.bot/install.sh | bash

3. 查看错误日志：

   tail -f ~/.openclaw/logs/gateway.log

问题：openclaw onboard 命令不存在

解决方案：

openclaw --version
# 确保版本 ≥ 2026.1.24

# 如需更新
openclaw update

问题：其他设备无法访问 Web UI

解决方案：

1. 确认已按 6.2 节添加 controlUi 配置
2. 检查防火墙：sudo ufw allow 18789/tcp
3. 重启 Gateway：openclaw gateway restart

完成本教程后，你将拥有：

• ✅ 运行在 Ubuntu 虚拟机上的 OpenClaw
• ✅ 配置完成的国内 API（MiniMax 或智谱）
• ✅ 可通过局域网访问的 Web UI
• ✅ 可选的浏览器扩展功能

• OpenClaw 官方文档
• OpenClaw GitHub
• MiniMax 官网
• 智谱 AI 官网

MIT License - 详见 LICENSE 文件

• 更新日期: 2026-03-02
• 适用系统: Ubuntu 20.04/22.04
• 支持的 OpenClaw 版本: 2026.1.24+