OpenClaw 在 Ubuntu 20.04 上的部署实战
最近在 Ubuntu 20.04 上折腾 OpenClaw,发现几个关键依赖容易踩坑,尤其是 CMake 版本和国内网络环境。下面这份流程是实测通过的,照着做基本能一次成功。
环境准备
先更新系统源并装好基础编译工具,这一步不能省:
sudo apt update && sudo apt upgrade -y
sudo apt install -y git build-essential curl wget libssl-dev libuv1-dev pkg-config zlib1g-dev
Node.js 是核心依赖,OpenClaw 要求 18 以上,建议直接用 22.x LTS:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node --version
npm --version
安装与配置
搞定国内网络加速
拉取 GitHub 或 NPM 包时,国内直连经常超时。提前配好镜像能省很多时间:
# 切换 NPM 源
npm config set registry https://mirrors.cloud.tencent.com/npm/
# Git 强制走 HTTPS 并加代理
git config --global url."https://github.com/".insteadOf "[email protected]:"
git config --global url."https://ghproxy.com/https://github.com/".insteadOf "https://github.com/"
# 修复权限问题,避免后续报错
sudo chown -R $USER:$USER ~/.npm
sudo chown -R $USER:$USER /usr/local/lib/node_modules
升级 CMake(重点)
Ubuntu 20.04 自带的 CMake 只有 3.16,但 OpenClaw 底层依赖 llama.cpp 需要 3.19+。必须手动升级:
sudo apt remove -y cmake
wget -O - https://apt.kitware.com/keys/kitware-archive-latest.asc 2>/dev/null | gpg --dearmor - | sudo tee /usr/share/keyrings/kitware-archive-keyring.gpg >/dev/null
echo 'deb [signed-by=/usr/share/keyrings/kitware-archive-keyring.gpg] https://apt.kitware.com/ubuntu/ focal main' | /etc/apt/sources.list.d/kitware.list >/dev/null
apt update
apt install -y cmake
cmake --version

