OpenClaw 完整安装与配置指南
在 Linux（Debian/Ubuntu）环境下部署 OpenClaw，核心在于环境准备、程序初始化以及模型和渠道的配置。本文梳理了从 Node.js 安装到飞书对接的全流程，重点说明交互式选项的选择逻辑，确保新手也能顺利落地。
基础环境准备
首先确保服务器联网，能访问 GitHub、npm 及飞书官网。建议使用 Xshell 或 Putty 等远程工具操作，并拥有 root 或 sudo 权限。
1. 配置 Root 账户
为了方便后续管理，建议启用 root 远程登录。修改密码后编辑 SSH 配置文件：
sudo passwd root
sudo vim /etc/ssh/sshd_config
在 sshd_config 中找到 PermitRootLogin，取消注释并改为 yes。保存退出后重启服务：
sudo systemctl restart sshd
2. 安装 Node.js
OpenClaw 依赖 Node.js 环境，建议版本 ≥20.x（推荐 22.x）。
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
node -v
若 curl 失败，可尝试更换国内源或手动上传安装包。
3. 安装编译工具与 CMake
CMake 用于编译依赖，需 ≥3.19。同时安装基础编译工具链：
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
export PATH=/usr/local/bin:$PATH
sudo apt install -y make gcc g++ build-essential
验证 CMake 版本后，安装 OpenClaw 专用的包管理工具 xpm：
npm install -g xpm
xpm -v
OpenClaw 核心安装与初始化
1. 安装主程序
使用 npm 全局安装最新版本：
npm install -g openclaw@latest
若遇权限提示，加 sudo 即可。
2. 交互式初始化
执行 onboard 命令进入配置向导，以下是关键选项的推荐选择：
openclaw onboard --install-daemon
- 协议确认：选 Yes。
- 初始化模式：选 QuickStart，后续可通过命令补充细节。
- 模型提供商：先选 Skip for now，稍后单独配置。
