第一步:环境准备与依赖安装
yum update -y
yum install -y curl wget git
第二部:安装 Node.js:OpenClaw 核心依赖 Node.js,且要求版本 22.x 或更高 。
# 下载并执行 NodeSource 安装脚本(自动配置 yum 源)
curl-fsSL https://rpm.nodesource.com/setup_22.x |sudobash -
# 安装 Node.js(npm 会一同安装)
yum install-y nodejs
# 验证安装
node--version
npm--version
第三步:配置 npm 国内镜像(可选,推荐):为了加速依赖包的下载,建议将 npm 镜像源设置为淘宝镜像。npm config set registry https://registry.npmmirror.com
第四步:安装 OpenClaw
npminstall-g openclaw@latest
2.验证安装:安装完成后,检查版本号以确保安装成功。openclaw --version
第五步:初始化与配置
1.启动配置向导:运行初始化命令,开始配置你的 OpenClaw 实例。openclaw onboard
2.核心配置项:在交互式向导中,有几个关键选择需要留意接受风险提示 (I understand this is powerful and inherently risky. Continue?):输入 Y 并回车。
Onboarding mode:直接回车,选择 QuickStart。
Model/auth provider (模型/认证提供商):这是最关键的一步。由于你是在本地服务器部署,推荐使用本地模型(如 Ollama)或跳过,后续再配置。
Configure skills now? (现在配置技能吗?):初学者建议输入 N 并回车,先完成基础部署。
Enable hooks?:按空格键选中,然后回车。
How do you want to hatch your bot?:选择 Do this later。
第六步:生成访问令牌:配置完成后,需要生成一个令牌(Token),用于登录 Web 管理界面。
openclaw token generate
请务必复制并保存好生成的 Token 字符串,首次访问 Web 界面时需要用到。
第七步:启动服务
启动 Gateway 服务:这是 OpenClaw 的核心通信服务
openclaw gateway start
保持后台运行:为了让服务在退出 SSH 后仍能持续运行,可以使用 screen 工具或将其配置为系统服务。
# 安装 screen (如果未安装)
yum install-yscreen
# 创建一个名为 openclaw 的 screen 会话
screen-S openclaw
# 在会话中启动 gateway 服务(如果之前启动过,先停止 openclaw gateway stop)
openclaw gateway start
之后,你可以按 Ctrl+A 然后按 D 键来分离(detach)这个会话,让它继续在后台运行。需要重新进入时可以执行 screen -r openclaw。
第八步:防火墙配置
放行端口:OpenClaw 默认使用 18789 端口进行 Web 通信
firewall-cmd --permanent --add-port=18789/tcp
firewall-cmd --reload
补充说明,若是测试机直接关闭防火墙服务即可。