跳轉到內容
最近更新

OpenClaw VPS 部署（Docker / 原生）

你將完成什麼

  • 通過 Docker 或原生方式在 VPS 部署 OpenClaw
  • 持久化設定和狀態資料
  • 學會安全地重啟、停止和驗證網關
  • 規避 Docker、網絡、權限和資料丟失等常見問題

VPS 設定建議

  • 至少 2 vCPU / 2 GB RAM / 20 GB SSD
  • Ubuntu 22.04 或更高版本

方案 A：Docker（推薦）

Step 1：更新系統

Command
sudo apt update && sudo apt upgrade -ysudo apt install -y curl git ca-certificates

Step 2：安裝 Docker 和 Compose

Command
sudo apt install -y docker.io docker-composedocker --versiondocker-compose --version

Step 3：修復 Docker 權限

Command
sudo usermod -aG docker $USER

執行後退出並重新登錄。

Step 4：克隆倉庫

Command
git clone https://github.com/openclaw/openclaw.gitcd openclaw

Step 5：運行官方 Docker 初始化腳本

Command
chmod +x ./docker-setup.sh./docker-setup.sh

Step 6：在 CLI 容器中完成 onboarding

Command
docker compose exec openclaw-cli openclaw onboard --flow quickstart

Step 7：查看日誌驗證

Command
docker compose logs -f openclaw-gateway

方案 B：原生安裝

Step 1：安裝 OpenClaw

Command
curl -fsSL https://openclaw.bot/install.sh | bashnpm i -g openclaw@latest

Step 2：完成 onboarding 並安裝後臺服務

Command
openclaw onboard --install-daemon

Step 3：驗證運行狀態

Command
openclaw healthopenclaw status --all

如何安全地重啟和停止 OpenClaw

Docker 重啟

Command
docker compose restart openclaw-gateway openclaw-cli

Docker 停止

Command
docker compose stop

原生重啟

Command
openclaw gateway restart || openclaw restart

原生停止

Command
openclaw stop || pkill -f openclaw

持久化資料與備份

通常最關鍵的路徑是：

  • ~/.openclaw/
  • ~/.openclaw/workspace/

快速備份：

Command
tar -czf openclaw-backup.tar.gz ~/.openclaw

最小安全加固

Command
sudo ufw allow OpenSSHsudo ufw enablesudo ufw status

除非你非常明確理解風險，否則不要把網關直接暴露到公網。優先綁定 localhost，或通過 token 與反向代理鑑權保護。

安全訪問 Control UI

優先使用 SSH 隧道，不要直接開放端口：

Command
ssh -N -L 18789:127.0.0.1:18789 user@your-vps-ip

常見 Docker / VPS 問題

什麼時候應該使用 Docker？

如果你需要可重複部署、方便持久化和更清晰的隔離，優先用 Docker。

什麼時候使用原生安裝？

只有在你明確知道原因，或者你的環境不適合 Docker 時才考慮原生安裝。

網關令牌、瀏覽器中繼和技能設定在哪裡看？

繼續看 高級設定，其中會解釋 gateway token、browser relay 和技能相關設置。

相關 OpenClaw 指南