跳转到内容
最近更新

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 指南