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

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

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

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

打开终端。
更新系统包：这是为了避免因系统包过旧而导致的依赖冲突。
```
sudo apt update && sudo apt upgrade -y
```
安装基础工具链：安装后续步骤中可能用到的curl、git等工具。
```
sudo apt install -y curl wget git build-essential
```

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

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

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

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

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

克隆仓库并运行脚本：

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

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

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

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

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

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

如果你使用了一键脚本或npm安装，需要手动启动配置向导：
```
openclaw onboard --install-daemon
```
这个命令会启动一个交互式终端界面，引导你完成配置。
如果你使用了Docker安装，docker-setup.sh脚本通常会在安装过程中自动启动这个向导。

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

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

检查网关状态：
```
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/），它们可能仍然指向同一个工具。

转载自CSDN-专业IT技术社区

评论