OpenClaw 完整安装与配置指南
本文档梳理了 OpenClaw 在 Linux(Debian/Ubuntu)环境下的全流程部署,涵盖基础依赖、核心程序初始化、Minimax 与 DeepSeek 模型接入,以及飞书渠道对接。所有交互式配置选项均已列出,步骤可直接复制执行。
一、基础环境准备
1. 配置 Root 账户
建议启用 Root 远程登录以方便操作。修改密码及 SSH 配置如下:
# 设置 root 密码
sudo passwd root
# 编辑 SSH 配置文件
sudo vim /etc/ssh/sshd_config
在 sshd_config 中找到 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. 安装 CMake 与编译工具
需 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
若提示找不到命令,请执行 export PATH=/usr/local/bin:$PATH。随后安装基础编译工具:
sudo apt install -y make gcc g++ build-essential
4. 安装 XPM
OpenClaw 专用依赖管理工具。
npm install -g xpm
xpm -v
二、OpenClaw 核心安装与初始化
1. 安装主程序
npm install -g openclaw@latest

