Ubuntu 虚拟机安装 OpenClaw 完整流程

基础环境配置免密设置为了在后续安装脚本运行中避免频繁输入密码我们需要为当前用户开启sudo免密权限。1.1 编辑 sudoers 配置sudo visudo1.2 添加免密权限在文件末尾添加以下内容将spoto替换为你实际的用户名spoto ALL(ALL) NOPASSWD: ALL1.3 保存并退出nano编辑器按CtrlO保存Enter确认CtrlX退出vim编辑器输入:wq保存退出2. 安装基础工具与 OpenSSH确保系统更新并安装远程连接及脚本下载所需的组件。# 更新系统包列表 sudo apt update # 安装基础下载工具 sudo apt install -y curl # 安装并启动 OpenSSH 服务方便通过 PC 远程管理 sudo apt install -y openssh-server2.1 验证 SSH 服务状态# 检查 SSH 服务状态 sudo systemctl status ssh # 如果服务未启动使用以下命令启动 sudo systemctl start ssh2.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 | bash4. 配置向导运行配置向导完成基本设置推荐openclaw onboard --install-daemon4.1 向导配置选项按照向导提示完成配置选择安全选项- 理解风险配置工作区目录- 设置工作文件存放位置配置国内 API可选- 选择 MiniMax 或智谱输入 API Key配置局域网访问可选- 开启 LAN Access设置认证方式- Token 认证4.2 验证安装# 检查 openclaw 是否安装成功 which openclaw # 查看版本 openclaw --version # 检查 Gateway 状态 openclaw gateway status5. 国内 API 配置与旧版教程的区别新版 OpenClaw 向导会自动识别并配置模型无需手动编辑配置文件。5.1 使用向导配置推荐openclaw onboard选择对应 API 服务商输入 API Key 即可。5.2 API Key 获取服务商地址MiniMaxhttps://www.minimaxi.com → 控制台 → API Keys智谱 AIhttps://bigmodel.cn → 控制台 → API Keys5.3 验证模型openclaw models list6. 局域网访问配置注意配置向导可以开启局域网访问但无法直接配置 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 重启 Gatewayopenclaw gateway restart6.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 install7.1 验证浏览器扩展# 检查浏览器扩展状态 openclaw browser status常见问题Q1: sudo 免密设置失败问题执行sudo visudo时权限不足解决方案# 切换到 root 用户 su - # 然后执行 visudo visudoQ2: 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.logQ4: 向导找不到问题openclaw onboard命令不存在解决方案openclaw --version # 确保版本 ≥ 2026.1.24 # 如需更新 openclaw updateQ5: 局域网无法访问问题其他设备无法访问 Web UI解决方案确认已按 6.2 节添加 controlUi 配置检查防火墙sudo ufw allow 18789/tcp重启 Gatewayopenclaw gateway restart