13.7 Linux应用

OpenClaw Gateway 在 Linux 上可完整运行，推荐使用 Node.js 作为运行时。

VPS 用户快速入门

初学者路径包含以下主要步骤：

1. 安装 Node 22 或更高版本
2. 通过 npm 全局部署 OpenClaw
3. 运行入门守护进程安装
4. 从本地机器建立 SSH 隧道
5. 访问界面并输入您的认证令牌

安装步骤

# 1. 安装 Node.js 22+
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# 2. 全局安装 OpenClaw
npm install -g openclaw

# 3. 运行入门向导并安装守护进程
openclaw onboard --install-daemon

# 4. 从本地机器建立 SSH 隧道（在本地终端运行）
ssh -L 18789:localhost:18789 user@your-server

# 5. 在浏览器中访问 http://localhost:18789

安装选项

存在多种安装路径：

• 标准 Node.js 安装 - 推荐方式
• 实验性 Bun 支持 - 不推荐用于 Gateway
• Nix 包管理器集成
• 容器化 Docker 部署

服务管理

应用默认安装为 systemd 用户级服务，不过系统级服务适合共享或持久化服务器环境。

用户级服务

# 启用并启动用户级服务
systemctl --user enable openclaw-gateway
systemctl --user start openclaw-gateway

# 查看服务状态
systemctl --user status openclaw-gateway

系统级服务

# 启用并启动系统级服务
sudo systemctl enable openclaw-gateway
sudo systemctl start openclaw-gateway

# 查看服务状态
sudo systemctl status openclaw-gateway

故障排除

openclaw doctor 命令可帮助诊断和解决安装问题或进行配置迁移。

# 运行诊断
openclaw doctor

# 查看状态
openclaw status