环境准备
在开始之前,请确保你的服务器运行的是 Debian 或 Ubuntu 系列 Linux 系统,并且拥有 root 权限。整个流程依赖命令行操作,建议使用 Xshell 或 Putty 等工具连接。
1. 基础依赖安装
首先配置 Root 账户以便远程管理,修改密码并允许 SSH 登录:
sudo passwd root
编辑 SSH 配置文件以启用 Root 登录:
sudo vim /etc/ssh/sshd_config
找到 PermitRootLogin 行,取消注释并改为 yes,保存退出后重启服务:
sudo systemctl restart sshd
接下来安装 Node.js(OpenClaw 核心依赖),推荐版本 22.x:
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
若遇到网络问题,可尝试更换国内源或手动上传安装包。随后安装编译工具链和 CMake:
sudo apt-get install -y make gcc g++ build-essential
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 --version
最后安装 OpenClaw 专用的包管理工具 xpm:
npm install -g xpm
2. 安装与初始化
使用 npm 全局安装 OpenClaw:
npm install -g openclaw@latest
如果提示权限不足,请在命令前加 sudo。执行初始化命令进入交互式配置:
openclaw onboard --install-daemon
按以下指引选择即可:
- 确认协议:输入
Yes继续。 - 初始化模式:选择
QuickStart,后续可通过命令补充细节。 - 模型提供商:暂时选
Skip for now,稍后单独配置。 - 默认模型:保留当前默认值或按需调整。
- 渠道配置:先选
Skip for now,飞书通道后面再配。 - 技能与钩子:建议跳过,后续按需添加。
- 启动方式:选择
Open the Web UI打开管理界面。
验证网关状态:
openclaw gateway status

