在Ubuntu上安装OpenClaw主要有两种主流且官方推荐的方式：一键脚本安装（适合新手和快速部署）和 Docker 安装（适合需要环境隔离和生产环境部署）

在Ubuntu上安装OpenClaw主要有两种主流且官方推荐的方式：一键脚本安装（适合新手和快速部署）和 Docker 安装（适合需要环境隔离和生产环境部署）。此外，对于开发者或需要特定版本的用户，也可以选择从源码安装。

以下是针对Ubuntu系统的详细操作步骤分解。

⚙️ 第一步：系统准备与依赖安装

在开始之前，需要确保你的Ubuntu系统（建议使用22.04或24.04 LTS版本）已经准备好必要的工具。

1. 打开终端。

安装基础工具链：安装后续步骤中可能用到的curl、git等工具。

sudoaptinstall-ycurlwgetgit build-essential 

更新系统包：这是为了避免因系统包过旧而导致的依赖冲突。

sudoapt update &&sudoapt upgrade -y

🚀 第二步：选择并执行安装方法

你可以根据自身需求，从以下三种方法中选择一种进行安装。

方法一：一键脚本安装（最推荐）

这是官方推荐的最简单、最省心的方式。脚本会自动处理Node.js依赖的检测和安装，并直接启动配置向导。

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

执行后，脚本会引导你进入下一步的配置流程。

方法二：Docker 安装（环境隔离）

如果你偏好使用Docker，或者希望将OpenClaw运行在隔离的容器环境中，可以使用此方法。

1. 安装 Docker：如果你的系统中尚未安装Docker和Docker Compose，需要先安装。

克隆仓库并运行脚本：

# 创建并进入项目目录mkdir-p ~/openclaw &&cd ~/openclaw # 克隆官方仓库git clone https://github.com/openclaw/openclaw.git .# 运行Docker设置脚本 ./docker-setup.sh 

该脚本会自动构建镜像、生成访问令牌并启动服务。

方法三：npm / pnpm 安装（手动管理）

如果你已经安装了Node.js 22+，并希望自己管理全局包，可以使用npm或pnpm进行安装。

1. 验证安装：node --version 应显示 v22.x.x。

全局安装 OpenClaw：

npminstall-g openclaw@latest 

安装 Node.js 22+ （如果还未安装）：

curl-fsSL https://deb.nodesource.com/setup_22.x |sudo-E - bash&&sudoaptinstall-y nodejs 

🧭 第三步：初始化配置

安装完成后，你需要通过“新手引导”来完成核心设置，如添加AI模型API密钥、配置守护进程等。

• 如果你使用了Docker安装，docker-setup.sh脚本通常会在安装过程中自动启动这个向导。

如果你使用了一键脚本或npm安装，需要手动启动配置向导：

openclaw onboard --install-daemon 

这个命令会启动一个交互式终端界面，引导你完成配置。

在配置向导中，你需要完成以下几个关键步骤：

1. AI 模型提供商：选择你使用的模型（如Anthropic、OpenAI、阿里云百炼等），并输入你的API密钥。这是OpenClaw能够进行智能对话和任务处理的核心。
2. 网关守护进程：确认安装。这能让OpenClaw在后台持续运行，并支持开机自启。
3. 工作区路径：通常保持默认的 ~/.openclaw/workspace 即可，用于存储配置和数据。

✅ 第四步：验证安装并访问界面

1. 访问 Web UI：
   打开浏览器，访问 http://你的UbuntuIP地址:18789。如果是本地安装，直接访问 http://127.0.0.1:18789。
   在页面中输入你找到的令牌，即可进入OpenClaw的控制面板。

获取访问令牌：
你需要令牌来登录Web界面。可以通过以下命令查看配置文件中生成的令牌：

grep-A1'"token"' ~/.openclaw/openclaw.json 

检查网关状态：

openclaw gateway status 

如果显示 running，则表示启动成功。

⚠️ 重要注意事项

• 项目曾用名：OpenClaw曾多次更名（Clawdbot → Moltbot → OpenClaw）。如果你在查找旧文档或配置文件（如 ~/.clawdbot/），它们可能仍然指向同一个工具。

网络访问配置：如果需要在局域网内的其他设备上访问OpenClaw的Web界面，你需要修改配置，让其监听所有网络接口：

openclaw config set gateway.bind lan openclaw gateway restart 

安全提示：请勿将此端口（18789）直接暴露在公网上，以免带来安全风险。如需远程访问，强烈建议使用VPN或配置带身份验证的反向代理（如Caddy、Nginx）。