OpenClaw 跨平台部署指南
目前最便捷的安装方式是通过一行脚本一键部署。若环境配置顺利，整个过程会非常顺畅。本文重点记录在全新虚拟机环境中部署时遇到的典型问题及解决方案，特别是针对 WSL Ubuntu 和 CentOS9 两种环境的差异。
注意：在使用 Qwen 等大模型时，认证步骤依赖可视化浏览器环境。若在纯命令行或无图形界面的虚拟机中操作，可能会卡在认证流程。建议优先使用带图形界面的环境或通过 API Key 方式绕过验证。
CentOS 9 虚拟机环境部署
前置环境准备：Node.js >= 22
CentOS 默认源中的 Node.js 版本较旧（通常为 v16），无法满足要求，需手动升级。
1. 清理并配置软件源
首先检查 /etc/yum.repos.d/ 目录下的配置文件。如果存在 nodesource 相关的 repo 文件且导致下载失败，建议删除（生产环境请谨慎操作）：
sudo rm -f /etc/yum.repos.d/nodesource-*.repo
接着安装 EPEL 仓库以获取额外软件包：
sudo dnf install -y epel-release
sudo dnf clean all && sudo dnf makecache
2. 安装 Node.js 22
由于 yum/dnf 无法直接提供新版 Node.js，推荐使用 NVM 进行安装。
清理旧版本残留：
sudo dnf remove -y nodejs npm
# 手动清理可能存在的符号链接
sudo rm -rf /usr/lib/node_modules
sudo rm -rf /usr/local/lib/node_modules
sudo rm -rf /var/cache/yum/*node*
sudo rm -f /usr/local/bin/node /usr/local/bin/npm
sudo rm -f /usr/bin/node /usr/bin/npm
# 清理用户目录
rm -rf ~/.npm ~/.node-gyp ~/.nvm
使用 NVM 安装：
# 安装 NVM
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | bash
source ~/.bashrc
# 安装 LTS 版本的 Node.js 22
nvm install 22 --lts
# 验证版本
node -v
