Skip to main content

在 Hetzner 上运行 OpenClaw(Docker,生产 VPS 指南)

目标

使用 Docker 在 Hetzner VPS 上运行持久的 OpenClaw Gateway 网关,带持久状态、内置二进制文件和安全的重启行为。
  1. 如果你想要“约 524/7OpenClaw”,这是最简单且可靠的设置。如果你想要"5 的 24/7 OpenClaw”,这是最简单且可靠的设置。 如果你想要"约 5 实现 OpenClaw 24/7”,这是最简单可靠的设置。 Hetzner 定价会变化;选择最小的 Debian/Ubuntu VPS,如果遇到 OOM 再扩容。

我们在做什么(简单说明)?

  • 租用一台小型 Linux 服务器(Hetzner VPS)
  • 安装 Docker(隔离的应用运行时)
  • 在 Docker 中启动 OpenClaw Gateway 网关
  • 在主机上持久化 ~/.openclaw + ~/.openclaw/workspace(重启/重建后保留)
  • 通过 SSH 隧道从你的笔记本电脑访问控制 UI
Gateway 网关可以通过以下方式访问:
  • 从你的笔记本电脑进行 SSH 端口转发
  • 如果你自己管理防火墙和令牌,可以直接暴露端口
  1. 本指南假设你在 Hetzner 上使用 Ubuntu 或 Debian。
  2. 如果你使用其他 Linux VPS,请相应映射软件包。
  3. 通用 Docker 流程请参见 Docker

快速路径(有经验的运维人员)

  1. 配置 Hetzner VPS
  2. 安装 Docker
  3. 克隆 OpenClaw 仓库
  4. 创建持久化主机目录
  5. 配置 .envdocker-compose.yml
  6. 将所需二进制文件烘焙到镜像中
  7. docker compose up -d
  8. 验证持久化和 Gateway 网关访问

你需要什么

  • 具有 root 访问权限的 Hetzner VPS
  • 从你的笔记本电脑进行 SSH 访问
  • 基本熟悉 SSH + 复制/粘贴
  • 约 20 分钟
  • Docker 和 Docker Compose
  • 模型认证凭证
  • 可选的提供商凭证
    • WhatsApp 二维码
    • Telegram 机器人令牌
    • Gmail OAuth

1. 配置 VPS

在 Hetzner 中创建一个 Ubuntu 或 Debian VPS。 以 root 身份连接:
本指南假设 VPS 是有状态的。 不要将其视为一次性基础设施。 不要将其视为一次性基础设施。

2. 安装 Docker(在 VPS 上)

验证:

3. 克隆 OpenClaw 仓库

本指南假设你将构建自定义镜像以保证二进制文件持久化。

4. 创建持久化主机目录

Docker containers are ephemeral. 所有长期存在的状态必须保存在主机上。

5. 配置环境变量

在仓库根目录创建 .env
Generate strong secrets:
不要提交此文件。

6. Docker Compose 配置

创建或更新 docker-compose.yml
--allow-unconfigured 仅用于引导阶段的便利,并不能替代正确的网关配置。 仍然需要设置认证(gateway.auth.token 或密码),并为你的部署使用安全的绑定设置。

7. 将所需二进制文件烘焙到镜像中(关键)

在运行中的容器内安装二进制文件是一个陷阱。 任何在运行时安装的东西都会在重启时丢失。 Anything installed at runtime will be lost on restart. 所有 skills 所需的外部二进制文件必须在镜像构建时安装。 以下示例仅展示三个常见二进制文件:
  • gog 用于 Gmail 访问
  • goplaces 用于 Google Places
  • wacli 用于 WhatsApp
These are examples, not a complete list. You may install as many binaries as needed using the same pattern. 如果你以后添加依赖额外二进制文件的新 skills,你必须:
  1. 更新 Dockerfile
  2. 重新构建镜像
  3. 重启容器
示例 Dockerfile

8. 构建并启动

验证二进制文件:
预期输出:

9. 验证 Gateway 网关

成功:
从你的笔记本电脑:
打开: http://127.0.0.1:18789/ 粘贴你的 Gateway 网关令牌。

持久化位置(事实来源)

  1. OpenClaw 运行在 Docker 中,但 Docker 不是事实来源。 所有长期存在的状态必须在重启、重建和重新启动后仍然存在。

基础设施即代码(Terraform)

对于偏好基础设施即代码工作流的团队,社区维护的 Terraform 方案提供:
  • 带远程状态管理的模块化 Terraform 配置
  • 通过 cloud-init 实现自动化部署
  • 部署脚本(bootstrap、deploy、backup/restore)
  • 安全加固(防火墙、UFW、仅限 SSH 访问)
  • 本指南假设在 Hetzner 上使用 Ubuntu 或 Debian。 如果你使用其他 Linux VPS,请相应地映射软件包。 通用 Docker 流程请参见 Docker
仓库:
  • 基础设施:openclaw-terraform-hetzner
  • OpenClaw 在 Docker 中运行,但 Docker 不是事实来源。 所有长期状态必须在重启、重建和重启后保留。
该方案在上述 Docker 部署方式基础上,补充了可复现部署、版本控制的基础设施以及自动化灾难恢复能力。
注意: 由社区维护。 如有问题或希望贡献,请参阅上述仓库链接。