跳转到主要内容

​
发布策略

OpenClaw 拥有三个公共发布渠道：
  • stable（稳定版）：发布到 npm latest 的带标签版本
  • beta（测试版）：发布到 npm beta 的预发布标签
  • dev（开发版）：main 的动态头部

​
版本命名

  • 稳定版版本：YYYY.M.D
    • Git 标签：vYYYY.M.D
  • Stable correction release version: YYYY.M.D-N
    • Git tag: vYYYY.M.D-N
  • Beta prerelease version: YYYY.M.D-beta.N
    • Git tag: vYYYY.M.D-beta.N
  • Do not zero-pad month or day
  • latest means the current stable npm release
  • beta means the current prerelease npm release
  • Stable correction releases also publish to npm latest
  • Every OpenClaw release ships the npm package and macOS app together

​
Release cadence

  • Releases move beta-first
  • Stable follows only after the latest beta is validated
  • Detailed release procedure, approvals, credentials, and recovery notes are maintainer-only

​
Release preflight

  • Run pnpm build before pnpm release:check so the expected dist/* release artifacts exist for the pack validation step
  • Run pnpm release:check before every tagged release
  • Run RELEASE_TAG=vYYYY.M.D node --import tsx scripts/openclaw-npm-release-check.ts (or the matching beta/correction tag) before approval
  • After npm publish, run node --import tsx scripts/openclaw-npm-postpublish-verify.ts YYYY.M.D (or the matching beta/correction version) to verify the published registry install path in a fresh temp prefix
  • For stable correction releases like YYYY.M.D-N, the post-publish verifier also checks the same temp-prefix upgrade path from YYYY.M.D to YYYY.M.D-N so release corrections cannot silently leave older global installs on the base stable payload
  • npm release preflight fails closed unless the tarball includes both dist/control-ui/index.html and a non-empty dist/control-ui/assets/ payload so we do not ship an empty browser dashboard again
  • Stable macOS release readiness also includes the updater surfaces:
    • the GitHub release must end up with the packaged .zip, .dmg, and .dSYM.zip
    • appcast.xml on main must point at the new stable zip after publish
    • 打包的应用必须保留非调试的 bundle id、非空的 Sparkle feed URL，以及一个等于或高于该发布版本标准 Sparkle 构建下限的 CFBundleVersion

​
公开参考

维护者使用 openclaw/maintainers/release/README.md 中的私有发布文档来执行实际的运行手册。
本页面源自 openclaw/openclaw，由 BeaversLab 翻译，遵循 MIT 协议 发布。
Last modified on March 27, 2026