Skip to content

Linux 服务器部署

在任意 Linux 服务器或云 VPS 上运行 OpenClaw Gateway。本页帮助你选择服务商,解释云端部署的工作原理,并介绍适用于所有环境的通用 Linux 调优方法。

选择服务商

服务商特点
Railway一键部署,浏览器操作
Northflank一键部署,浏览器操作
DigitalOcean简单的付费 VPS
Oracle Cloud永久免费 ARM 套餐
Fly.ioFly Machines
HetznerHetzner VPS 上运行 Docker
GCPCompute Engine
AzureLinux VM
exe.dev带 HTTPS 代理的 VM
Raspberry PiARM 自托管

AWS(EC2 / Lightsail / 免费套餐) 同样支持。社区视频教程可在 x.com/techfrenAJ/status/2014934471095812547 查看(社区资源,可能随时下线)。

云端部署工作原理

  • Gateway 运行在 VPS 上,拥有状态和工作区。
  • 你从笔记本或手机通过 Control UITailscale/SSH 连接。
  • 将 VPS 视为数据源头,定期备份状态和工作区。
  • 安全默认:将 Gateway 绑定到回环接口,通过 SSH 隧道或 Tailscale Serve 访问。若绑定到 lantailnet,需要设置 gateway.auth.tokengateway.auth.password

相关页面:Gateway 远程访问平台概览

在 VPS 上运行团队共享代理

当所有用户在同一信任边界且代理仅用于业务时,为团队运行单个代理是有效的方案。

  • 保持在专用运行时(VPS/VM/容器 + 专用 OS 用户/账号)上运行。
  • 不要将该运行时登录到个人 Apple/Google 账号或个人浏览器/密码管理器配置文件。
  • 若用户之间存在对抗关系,按网关/主机/OS 用户分割。

安全模型详情:安全性

配合节点使用 VPS

你可以将 Gateway 保留在云端,同时在本地设备(Mac/iOS/Android/无头设备)上配对节点。节点提供本地屏幕/摄像头/画布和 system.run 功能,而 Gateway 留在云端。

文档:节点节点 CLI

小型 VM 和 ARM 主机的启动优化

若 CLI 命令在低功率 VM(或 ARM 主机)上感觉较慢,可启用 Node 模块编译缓存:

bash
grep -q 'NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache' ~/.bashrc || cat >> ~/.bashrc <<'EOF'
export NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
mkdir -p /var/tmp/openclaw-compile-cache
export OPENCLAW_NO_RESPAWN=1
EOF
source ~/.bashrc
  • NODE_COMPILE_CACHE 改善重复命令的启动时间。
  • OPENCLAW_NO_RESPAWN=1 避免自重启路径带来的额外启动开销。
  • 第一次运行命令会预热缓存;后续运行更快。
  • 有关 Raspberry Pi 的具体信息,见 Raspberry Pi

systemd 调优清单(可选)

对于使用 systemd 的 VM 主机,考虑以下配置:

  • 为稳定启动路径添加服务环境变量:
    • OPENCLAW_NO_RESPAWN=1
    • NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
  • 保持明确的重启行为:
    • Restart=always
    • RestartSec=2
    • TimeoutStartSec=90
  • 优先使用 SSD 支持的磁盘作为状态/缓存路径,以减少随机 I/O 冷启动延迟。

示例:

bash
sudo systemctl edit openclaw
ini
[Service]
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Restart=always
RestartSec=2
TimeoutStartSec=90

Restart= 策略如何帮助自动化恢复:systemd 可以自动化服务恢复