OpenClaw 完整安装与配置指南
本文档基于 Linux 系统(Debian/Ubuntu 系列),梳理 OpenClaw 从环境准备、核心安装,到模型配置(Minimax/DeepSeek)及飞书渠道对接的全流程。所有交互式配置选项均已列出,步骤可直接复制执行。
一、基础环境准备
1.1 配置 Root 账户(可选但推荐)
为了便于远程操作,建议启用 Root 登录权限。
# 修改 root 密码
sudo passwd root
# 修改 sshd 配置文件
sudo vim /etc/ssh/sshd_config
编辑说明:
- 按
i进入编辑模式。 - 找到
PermitRootLogin行,若被注释请删除#,改为PermitRootLogin yes。 - 按
Esc退出,输入:wq保存。 - 重启服务使配置生效:
sudo systemctl restart sshd
1.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 install -y nodejs
# 验证版本
node -v
*注意:若 curl 命令连接失败,可尝试更换国内源或手动下载安装包上传至服务器。
1.3 安装 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
# 安装到 /usr/local/bin 目录
sudo ./cmake-3.28.3-linux-x86_64.sh --prefix=/usr/local --skip-license
# 验证版本
cmake --version
*注意:若提示找不到 cmake 命令,请执行 export PATH=/usr/local/bin:$PATH。
1.4 安装基础编译工具
sudo apt install -y make gcc g++ build-essential
1.5 安装 xpm
OpenClaw 专用依赖管理工具。

