OpenClaw 完整安装与配置指南
本文档梳理了 OpenClaw 在 Linux(Debian/Ubuntu)环境下的完整部署流程,涵盖基础环境准备、核心程序安装、模型配置(Minimax/DeepSeek)以及飞书渠道对接。所有交互式选项均已列出,步骤可直接复制执行。
一、基础环境准备
1. 系统权限与 SSH 配置
建议配置 Root 账户以便远程管理。修改密码并允许远程登录:
# 设置 root 密码
sudo passwd root
# 编辑 SSH 配置文件
sudo vim /etc/ssh/sshd_config
在编辑器中,找到 PermitRootLogin 行(若被注释请先删除 #),将其改为 PermitRootLogin yes。保存退出后重启服务:
sudo systemctl restart sshd
2. 安装 Node.js 环境
OpenClaw 依赖 Node.js,版本需 ≥20.x(推荐 22.x)。
# 添加 NodeSource 官方源
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
# 安装 Node.js
sudo apt-get install -y nodejs
# 验证版本
node -v
注意:若 curl 命令连接失败,可尝试更换国内镜像源或手动上传安装包。
3. 编译工具链
OpenClaw 需要 CMake(≥3.19)及基础编译工具。
# 下载并安装 CMake 3.28.3
wget https://github.com/Kitware/CMake/releases/download/v3.28.3/cmake-3.28.3-linux-x86_64.sh
chmod +x cmake-3.28.3-linux-x86_64.sh
sudo ./cmake-3.28.3-linux-x86_64.sh --prefix=/usr/local --skip-license
# 验证 CMake
cmake --version
# 安装基础编译工具
sudo apt-get install -y make gcc g++ build-essential
若提示找不到 cmake,请执行 export PATH=/usr/local/bin:$PATH。
4. 安装 XPM 依赖管理工具
npm install -g xpm
xpm -v
二、OpenClaw 核心安装与初始化
1. 安装主程序
npm install -g openclaw@latest
如遇权限不足,请在命令前加 sudo。

