在Ubuntu上安装OpenClaw主要有两种主流且官方推荐的方式：一键脚本安装（适合新手和快速部署）和 Docker 安装（适合需要环境隔离和生产环境部署）。此外，对于开发者或需要特定版本的用户，也可以选择从源码安装。
以下是针对Ubuntu系统的详细操作步骤分解。
⚙️ 第一步：系统准备与依赖安装
在开始之前，需要确保你的Ubuntu系统（建议使用22.04或24.04 LTS版本）已经准备好必要的工具。
🚀 第二步：选择并执行安装方法
你可以根据自身需求，从以下三种方法中选择一种进行安装。
方法一：一键脚本安装（最推荐）
这是官方推荐的最简单、最省心的方式。脚本会自动处理Node.js依赖的检测和安装，并直接启动配置向导。
curl -fsSL https://openclaw.ai/install.sh | bash
执行后，脚本会引导你进入下一步的配置流程。
方法二：Docker 安装（环境隔离）
如果你偏好使用Docker，或者希望将OpenClaw运行在隔离的容器环境中，可以使用此方法。
mkdir -p ~/openclaw && cd ~/openclaw
# 克隆官方仓库
git clone https://github.com/openclaw/openclaw.git .
# 运行Docker设置脚本
./docker-setup.sh
该脚本会自动构建镜像、生成访问令牌并启动服务。
方法三：npm / pnpm 安装（手动管理）
如果你已经安装了Node.js 22+，并希望自己管理全局包，可以使用npm或pnpm进行安装。
sudo apt install -y nodejs
🧭 第三步：初始化配置
安装完成后，你需要通过“新手引导”来完成核心设置，如添加AI模型API密钥、配置守护进程等。
- 如果你使用了一键脚本或npm安装，需要手动启动配置向导：openclaw onboard –install-daemon
这个命令会启动一个交互式终端界面，引导你完成配置。
- 如果你使用了Docker安装，docker-setup.sh脚本通常会在安装过程中自动启动这个向导。
在配置向导中，你需要完成以下几个关键步骤：
✅ 第四步：验证安装并访问界面
检查网关状态：
openclaw gateway status
如果显示 running，则表示启动成功。
获取访问令牌：
你需要令牌来登录Web界面。可以通过以下命令查看配置文件中生成的令牌：
grep -A1 '"token"' ~/.openclaw/openclaw.json
访问 Web UI：
打开浏览器，访问 http://你的UbuntuIP地址:18789。如果是本地安装，直接访问 http://127.0.0.1:18789。
在页面中输入你找到的令牌，即可进入OpenClaw的控制面板。
⚠️ 重要注意事项
- 网络访问配置：如果需要在局域网内的其他设备上访问OpenClaw的Web界面，你需要修改配置，让其监听所有网络接口：openclaw config set gateway.bind lan
openclaw gateway restart安全提示：请勿将此端口（18789）直接暴露在公网上，以免带来安全风险。如需远程访问，强烈建议使用VPN或配置带身份验证的反向代理（如Caddy、Nginx）。
- 项目曾用名：OpenClaw曾多次更名（Clawdbot → Moltbot → OpenClaw）。如果你在查找旧文档或配置文件（如 ~/.clawdbot/），它们可能仍然指向同一个工具。
