为什么选择 VPS 部署
将 Gateway 部署在云端 VPS，可以让它 24 小时不间断运行，不依赖你的个人电脑。各类消息渠道（Telegram、Discord、WhatsApp 等）的事件监听、定时任务、多终端共享等场景都更适合在云端运行。macOS 或移动端 App 可以作为远程节点接入，贡献本地的摄像头、屏幕等能力，而计算和状态管理由云端 Gateway 负责。
服务商选择参考
| 类型 | 推荐选项 |
|---|---|
| 一键部署（零配置） | Railway、Northflank |
| 传统 VPS | DigitalOcean、Hetzner |
| 免费套餐 | Oracle Cloud（ARM 永久免费实例） |
| 全球边缘 | Fly.io |
| 自托管 | Raspberry Pi（ARM 架构） |
| 大厂云 | AWS EC2/Lightsail、GCP Compute Engine、Azure Linux VM |
基础安装
以 Ubuntu/Debian 为例：
# 安装 Node.js（推荐 v20+）
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
# 全局安装 OpenClaw CLI
npm install -g openclaw
# 启动 Gateway
openclaw gateway --port 18789
性能优化：启动加速
低配 VPS（如 Oracle Cloud ARM 免费实例）首次启动较慢，可通过编译缓存大幅提升后续速度：
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：Node.js V8 编译缓存，首次运行后后续启动明显加快OPENCLAW_NO_RESPAWN=1：禁止进程自重启，配合 systemd 使用
systemd 服务配置
将 Gateway 注册为系统服务，实现开机自启和自动重启：
[Unit]
Description=OpenClaw Gateway
After=network.target
[Service]
ExecStart=/usr/bin/openclaw gateway --port 18789 --bind tailnet
Environment=OPENCLAW_NO_RESPAWN=1
Environment=NODE_COMPILE_CACHE=/var/tmp/openclaw-compile-cache
Environment=OPENCLAW_STATE_DIR=/home/openclaw/.openclaw
Restart=always
RestartSec=2
TimeoutStartSec=90
User=openclaw
[Install]
WantedBy=multi-user.target
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo systemctl status openclaw
安全访问建议
默认配置下 Gateway 只监听 loopback（127.0.0.1），这是最安全的做法。通过以下两种方式安全访问：
方式一：SSH 端口转发
ssh -N -L 18789:127.0.0.1:18789 user@YOUR_VPS_IP
在本地浏览器访问 http://127.0.0.1:18789/ 即可打开控制台。
方式二：Tailscale 私有网络
在 ~/.openclaw/openclaw.json 中设置 "gateway": { "bind": "tailnet" }，Gateway 绑定到 Tailscale 网络，只有同一 tailnet 的设备可以访问，无需暴露公网端口。
团队共用配置
多人共用同一 Gateway 时，建议：
- 为每个成员或每个业务创建独立的 OS 用户，隔离状态目录
- 不要将个人账号（Apple、Google 等）绑定到共享运行时
- 对于有对抗性行为风险的用户，需独立部署 Gateway 实例
重要： 定期备份
~/.openclaw/状态目录和 workspace，VPS 数据丢失无法恢复。