乐于分享
好东西不私藏

OpenClaw 2026.5.19-beta.2 预发布:Docker 和 Podman 用同一个环境变量,Gateway 重启追踪更清晰了

OpenClaw 2026.5.19-beta.2 预发布:Docker 和 Podman 用同一个环境变量,Gateway 重启追踪更清晰了

用过 Docker 部署 OpenClaw 的人大概都做过一件事:在 Compose 文件里加 OPENCLAW_DOCKER_APT_PACKAGES,给容器塞额外的系统包。后来切到 Podman,发现这个变量名带着 “DOCKER” 两个字,用起来别扭。

v2026.5.19-beta.2 把这件小事收拾了。

01 | 容器变量:新名字,旧的还能用

这次引入了一个新的运行时中立变量:

OPENCLAW_IMAGE_APT_PACKAGES=curl,git,ffmpeg

无论你用 Docker 还是 Podman,统一写这一个变量名就够了。原来的 OPENCLAW_DOCKER_APT_PACKAGES 作为 legacy fallback 保留,旧配置不用改也能继续工作。

迁移建议:新项目直接用新变量名;存量部署不用动,等下次整理配置再换。

02 | Gateway 重启追踪:看清楚耗时在哪

Gateway/ACPX 的重启追踪现在会把启动探测(startup probe)、配置加载、运行时初始化、资源计数这几项成本分开归因,记录到 restart trace 里。

具体是说:以前 Gateway 重启慢,日志里就是一个总时间,不知道卡在哪一步。现在每一段耗时单独标注,定位问题快很多。就绪行为本身没有变化,只是观测信息更细了。

对运维来说这是低成本的改进,不需要任何配置变更,升级后日志自动变详细。

03 | Agents 修复默认行为

这次更新明确了 Agents 处理修复任务时的默认策略:

修复应该优先采用有界的小范围重构,保持内部逻辑简洁,同时为插件 SDK/API 的废弃提供明确的迁移路径。简单说,就是修一个地方不要把周围全改了,要改接口也要留好废弃声明。

这条变化主要影响使用 Agents 做代码修复的团队,框架行为更可预期。

04 | 完整变更列表

  • NEWAgents:明确修复任务默认采用有界重构,保持内部简洁,提供插件 SDK/API 显式废弃路径
  • FIXDependencies:@openclaw/proxyline 升级到 0.3.3
  • FIXDependencies:Pi packages 升级到 0.75.1,Node.js 22 最低支持线提升到 22.19
  • NEWDocker/Podman:新增 OPENCLAW_IMAGE_APT_PACKAGES 统一容器镜像构建变量,旧变量 OPENCLAW_DOCKER_APT_PACKAGES 保留兼容
  • NEWGateway/ACPX:restart trace 中分项归因启动探测、配置、运行时、资源计数耗时,不改变就绪行为

beta 版本,生产环境观望即可。容器部署用户可以提前测试新变量名,迁移成本接近零。

你现在跑的 OpenClaw 用的是 Docker 还是 Podman?

⭐点赞、转发、关注和推荐一键三连⭐