Skip to main content
EasyRunner 将 OpenClaw Gateway 作为一个小型容器化应用运行在其 Caddy 代理后面。本指南假设 EasyRunner 主机运行兼容 Podman 的 Compose 应用，并通过 Caddy 终止 HTTPS。

​
开始之前

  • 一个已绑定域名的 EasyRunner 服务器。
  • 官方 OpenClaw 镜像（ghcr.io/openclaw/openclaw）或你自己的构建版本。
  • 一个用于 /home/node/.openclaw 的持久化配置卷。
  • 一个用于 /home/node/.openclaw/workspace 的持久化工作区卷。
  • 一个强密码的 Gateway token 或密码。
尽可能保持设备认证启用。如果你的反向代理无法正确传递 设备身份，请先修复 trusted-proxy 设置（参见 Trusted proxy auth）；只有在完全私有、由运维人员控制的网络中，才使用危险的认证绕过方式。

​
Compose 应用

使用如下结构的 Compose 文件创建一个 EasyRunner 应用：
将 openclaw.example.com 替换为你的 Gateway 主机名。将 OPENCLAW_GATEWAY_TOKEN 存储在 EasyRunner 的密钥/环境管理器中，而不是提交到应用定义里。该镜像默认绑定到回环地址，因此 command 中显式指定 --bind lan --port 1455 是 Caddy 访问容器所必需的。

​
配置 OpenClaw

在持久化配置卷中，确保 Gateway 仅能通过代理访问，并要求认证：
如果 Caddy 为 Gateway 终止 TLS，请为精确的代理路径配置受信任代理设置，而不是全局禁用认证检查。请参阅 受信任代理认证。

​
验证

在你的工作站上：
从 EasyRunner 主机上，GET /healthz（存活检查）和 GET /readyz （就绪检查）不需要认证，并支持镜像内置的容器健康 检查。还要查看应用日志，确认 Gateway 正在监听，并且没有启动 SecretRef、插件或通道认证失败。

​
更新与备份

  • 拉取或构建新的 OpenClaw 镜像，然后重新部署 EasyRunner 应用。
  • 在更新前备份 openclaw-config 卷。它包含 openclaw.json、agents/<agentId>/agent/auth-profiles.json 以及已安装的 插件包状态。
  • 如果代理会在 openclaw-workspace 中写入持久化项目数据，请备份该卷。
  • 在重大更新后运行 openclaw doctor，以捕获配置迁移和 服务警告。

​
故障排查

  • gateway probe 无法连接：确认 Caddy 主机名指向应用，并且容器监听 0.0.0.0:1455。
  • 认证失败：同时轮换 EasyRunner secrets 中的 token 和本地客户端命令。
  • 恢复后文件归 root 所有：镜像以 node（uid 1000）身份运行；修复已挂载的卷，以便该用户可以写入 /home/node/.openclaw 和 /home/node/.openclaw/workspace。
  • 浏览器或通道插件失败：检查所需的外部二进制文件、网络外连能力以及已挂载的凭据是否在容器内可用。