OpenClaw 完整安装与配置
本文档梳理了 OpenClaw 在 Linux（Debian/Ubuntu）环境下的完整部署流程，涵盖基础依赖准备、核心程序初始化、Minimax/DeepSeek 模型接入以及飞书渠道对接。所有步骤均经过验证，可直接复制执行。
前置准备
确保服务器已联网，能够访问 GitHub、npm 及飞书官网。操作全程建议在终端命令行中进行，并拥有 root 或 sudo 权限。若使用远程工具连接，建议提前配置好 SSH 登录。
一、基础环境搭建
1. 配置 Root 账户
为了便于后续管理，建议启用 Root 远程登录。修改密码后，编辑 SSH 配置文件开启 Root 权限：
# 修改 root 密码
sudo passwd root
# 编辑 sshd 配置
sudo vim /etc/ssh/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（≥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
# 安装基础编译工具
sudo apt-get install -y make gcc g++ build-essential
若提示找不到 cmake 命令，请临时导出环境变量：export PATH=/usr/local/bin:$PATH。
4. 安装依赖管理工具
OpenClaw 使用 xpm 进行依赖管理：
npm install -g xpm
xpm -v
二、核心安装与初始化
1. 安装主程序
使用 npm 全局安装最新版本：
npm install -g openclaw@latest
如遇权限不足，请在命令前加 。
