OpenClaw Linux 安装教程 2026:Ubuntu 24.04/Debian 12/CentOS Stream 9 三大系统部署详解
2026-02-22
阅读约13分钟
Linux服务器专题
教程说明:本文覆盖Linux服务器三大主流发行版的OpenClaw完整安装流程:Ubuntu 24.04 LTS、Debian 12 Bookworm、CentOS Stream 9,并提供systemd守护进程配置、Nginx反向代理和HTTPS证书申请的完整方案。
三大Linux系统对比选择
🐧
Ubuntu 24.04 LTS
✅ 社区支持最强
✅ 软件包最丰富
✅ 文档资料最多
🌟 新手首选推荐
🔴
Debian 12 Bookworm
✅ 极致稳定可靠
✅ 资源占用最低
✅ 安全更新及时
🌟 生产环境推荐
⚙️
CentOS Stream 9
✅ 企业级兼容性
✅ RHEL生态支持
⚠️ 需额外配置EPEL
🌟 企业用户选择
服务器最低配置要求
1核+
CPU
2GB+
内存
20GB+
磁盘
Node 22+
Node.js
Ubuntu 24.04 LTS 安装OpenClaw
1 系统更新与基础工具
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential
2 安装nvm与Node.js 22
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22
node -v && npm -v
3 安装OpenClaw并初始化
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway start
Debian 12 Bookworm 安装OpenClaw
Debian系统基础准备
sudo apt update && sudo apt upgrade -y
sudo apt install -y curl wget git build-essential ca-certificates gnupg
# Debian 12默认没有sudo,可能需要先切换到root
su -
apt install sudo -y
usermod -aG sudo 你的用户名
通过NodeSource安装Node.js 22(Debian推荐)
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
node -v # 验证 v22.x.x
NodeSource方式比nvm更适合Debian服务器,包管理更规范。
安装并启动OpenClaw
sudo npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway start
CentOS Stream 9 安装OpenClaw
CentOS系统准备与EPEL源配置
sudo dnf update -y
sudo dnf install -y epel-release
sudo dnf install -y curl wget git gcc gcc-c++ make
通过NodeSource安装Node.js 22
curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs
node -v
npm install -g openclaw@latest
openclaw onboard --install-daemon
CentOS特有问题:SELinux限制
CentOS默认启用SELinux,可能阻止OpenClaw绑定18789端口:
# 临时关闭(测试用)
sudo setenforce 0
# 或为OpenClaw添加端口权限
sudo semanage port -a -t http_port_t -p tcp 18789
生产环境推荐添加端口权限而不是关闭SELinux。
配置systemd守护进程(三系统通用)
systemd是现代Linux的标准服务管理工具,配置后OpenClaw可以开机自启、崩溃自动重启,像系统服务一样稳定运行。
创建systemd服务文件
sudo nano /etc/systemd/system/openclaw.service
填入以下内容(将USER替换为你的用户名):
[Unit]
Description=OpenClaw AI Gateway
After=network.target
[Service]
Type=simple
User=USER
ExecStart=/home/USER/.nvm/versions/node/v22.xx.x/bin/openclaw gateway start
Restart=on-failure
RestartSec=5
Environment="PATH=/home/USER/.nvm/versions/node/v22.xx.x/bin:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin"
[Install]
WantedBy=multi-user.target
启用并启动服务
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw # 查看运行状态
Nginx反向代理 + HTTPS证书(可选)
如果想通过域名访问OpenClaw,并加上HTTPS加密,可以配置Nginx反向代理和Let's Encrypt免费证书。
Ubuntu/Debian安装Nginx
sudo apt install -y nginx certbot python3-certbot-nginx
sudo certbot --nginx -d 你的域名.com
Nginx配置文件(/etc/nginx/sites-available/openclaw)
server {"{"}
server_name 你的域名.com;
location / {"{"}
proxy_pass http://127.0.0.1:18789;
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
proxy_set_header Host $host;
{"}"}
{"}"}
防火墙配置
Ubuntu/Debian(UFW)
sudo ufw allow 22/tcp
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw allow 18789/tcp
sudo ufw enable
CentOS(firewalld)
sudo firewall-cmd --permanent --add-port=22/tcp
sudo firewall-cmd --permanent --add-port=80/tcp
sudo firewall-cmd --permanent --add-port=443/tcp
sudo firewall-cmd --permanent --add-port=18789/tcp
sudo firewall-cmd --reload
Linux服务器网络加速建议
国内Linux服务器安装OpenClaw时面临的网络挑战:
nvm安装超时
GitHub raw文件下载慢,连接经常超时中断
npm包安装慢
NPM registry国内访问限速,安装时间过长
API调用失败
Claude/OpenAI API访问不稳定,频繁超时
VPN07解决方案:在Linux服务器上配置VPN07代理,1000Mbps千兆带宽,覆盖全球70+节点。支持HTTP/SOCKS5代理模式,一行命令为npm和curl配置加速。