Skip to main content

在 Ubuntu 20.04 上安装 OpenClaw

在 Ubuntu 20.04 上安装 OpenClaw，推荐使用官方的一键安装脚本，这是最简单快捷的方法。如果遇到问题，也可以采用手动安装方式。

🚀 方案一：一键安装（推荐）

官方提供的一键安装脚本会自动完成所有配置，非常适合新手。

  1. 执行安装命令
    在终端中运行以下命令，脚本将自动下载并安装 OpenClaw 及其所有依赖。 
    curl -fsSL https://openclaw.ai/install.sh | bash
    如果因网络问题导致脚本无法下载，可以尝试使用以下国内镜像源的脚本： 
    curl -fsSL https://gitee.com/openclaw-mirror/install-script/raw/main/install.sh | bash
  2. 跟随引导
    安装过程中，终端会提示你进行一些基础配置，例如选择模型、配置 Channel 等。通常直接按回车键使用默认选项即可，这些配置后续也可以在 Web 界面中修改。
  3. 验证安装
    安装成功后，终端会显示 “OpenClaw installed successfully” 并提供控制面板的访问地址（默认为 http://127.0.0.1:18789/openclaw）。

🛠️ 方案二：手动安装

如果一键安装失败，或者你希望更精细地控制安装过程，可以按照以下步骤手动安装。

1. 环境准备

  • 更新系统并安装基础工具 
    sudo apt update && sudo apt upgrade -y
sudo apt install -y curl git build-essential libssl-dev
  • 安装 Node.js (版本 ≥ 22)
    OpenClaw 依赖 Node.js 22 或更高版本。使用 NodeSource 源安装是稳定且推荐的方式。 
    # 导入 NodeSource 22.x 源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt install -y nodejs
# 验证安装
node --version  # 应显示 v22.x.x
npm --version   # 应显示 10.x.x 或更高
  • 配置国内 NPM 镜像（可选）
    为加速依赖包下载，建议将 NPM 镜像源切换到国内。 
    npm config set registry https://registry.npmmirror.com

2. 安装 OpenClaw

  • 使用 NPM 全局安装 
    sudo npm install -g openclaw@latest

3. 初始化配置

  • 启动初始化向导
    安装完成后，运行以下命令来配置模型、API Key 和后台服务等。 
    openclaw onboard --install-daemon
    按照终端提示完成配置即可。

⚠️ 常见问题与排查

  • CMake 版本过低
    Ubuntu 20.04 默认的 CMake 版本可能低于 OpenClaw 要求的 3.19+，这可能导致编译依赖时出错。如果遇到相关问题，需要手动升级 CMake。
  • 防火墙阻止访问
    OpenClaw 的控制面板默认使用 18789 端口。如果无法通过浏览器访问，请检查并放行该端口。 
    sudo ufw allow 18789/tcp
sudo ufw reload
  • 命令未找到
    如果安装后提示 openclaw: command not found，可能是 NPM 的全局路径未被系统识别。可以尝试重新打开终端，或手动创建软链接来解决。
Back to top