VPS 主機代管

本頁彙整支援的 VPS/主機代管指南,並概述雲端部署的運作方式。

選擇供應商

雲端部署的運作方式

  • Gateway 在 VPS 上執行,負責管理狀態與工作區。
  • 你從筆電或手機透過 Control UITailscale/SSH 連線。
  • 把 VPS 當成唯一事實來源,並備份狀態與工作區。
  • 安全預設值:讓 Gateway 綁定在 loopback,透過 SSH 通道或 Tailscale Serve 存取。若你綁定到 lan/tailnet,需設定 gateway.auth.tokengateway.auth.password

遠端存取:Gateway 遠端 平台總覽:平台

在 VPS 上共用的公司 Agent

當使用者處於同一信任邊界(例如同一公司團隊),且 Agent 僅用於業務用途時,這是合理的部署方式。

  • 使用專用的執行環境(VPS/VM/容器 + 專用的作業系統帳號)。
  • 不要在該執行環境登入個人 Apple/Google 帳號或個人瀏覽器/密碼管理員設定檔。
  • 如果使用者之間互不信任,按 Gateway/主機/作業系統帳號分隔。

安全模型細節:安全性

搭配 VPS 使用節點

你可以把 Gateway 放在雲端,在本地裝置(Mac/iOS/Android/無頭機器)上配對節點。節點提供本地螢幕/相機/Canvas 和 system.run 功能,而 Gateway 維持在雲端。

文件:節點節點 CLI

小型 VM 和 ARM 主機的啟動調校

如果在低效能 VM(或 ARM 主機)上 CLI 命令執行得很慢,可以啟用 Node 的模組編譯快取:

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 冷啟動的延遲。

範例:

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

Restart= 策略如何協助自動復原: systemd can automate service recovery