SuperAPI AI 工具集

openclaw-release-maintainer

办公与效率

查看项目

更新于 10-16 09:59

技能介绍

用途:该技能驱动 OpenClaw 的正常发布流程,覆盖稳定版与预发布版、变更日志发布说明和发布校验。普通开发改动和 GHSA 安全公告相关工作不在本技能范围内。

主要能力与规则:不得在未获操作者明确批准时修改版本号;任何 npm publish 或发布步骤前需先取得许可。核心 openclaw 发布为手动 workflow_dispatch,创建或推送标签本身不会触发发布。发布通道命名需保持一致:stable 仅打标签发布并发布到 npm latest,随后镜像到 npm beta(除非 beta 已指向更新的预发布版);beta 使用 vYYYY.M.D-beta.N 形式标签并配 npm dist-tag beta,优先使用 -beta.N。使用 beta Git 标签发布 npm 时应带匹配的 beta 版本后缀。

版本与文件一致性:版本位置包括 package.json、apps/android/app/build.gradle.kts、apps/ios/Sources/Info.plist、apps/ios/Tests/Info.plist、apps/macos/Sources/OpenClaw/Resources/Info.plist、docs/install/updating.md 以及 Peaboo Xcode 工程和 plist 版本字段。创建发布标签前,以上所有版本位置都要与该标签编码的版本一致;“到处升级版本”指上述全部位置(不含 appcast.xml)。回退修正标签如 vYYYY.M.D-N 时,仓库版本仍保持 YYYY.M.D。

发布前校验:运行 pnpm build、pnpm ui:build、pnpm release:check、pnpm test:install:smoke;非 root 冒烟路径用 OPENCLAW_INSTALL_SMOKE_SKIP_NONROOT=1 pnpm test:install:smoke。npm 发布后运行 node --import tsx scripts/openclaw-npm-postpublish-verify.ts <published-version> 验证注册表安装路径。默认发布检查还包括 pnpm check。

发布流程要点:确认操作者要发版,选定版本与标签,更新 CHANGELOG.md 并用匹配的发布说明,跑完整预检,确认 npm 版本未发布,创建推送标签,创建或刷新 GitHub release,依次以 preflight_only=true 运行 npm 发布工作流、公共 mac 验证工作流和私有 mac 预检,再以相同标签执行真实发布,等待 @openclaw/openclaw-release-managers 批准。任何预检失败都要新提交修复、删除并重建标签与 release 后重跑。所有相关构建面都需检查,不能只检查 npm 包。

限制:发布使用 GitHub 可信发布与工作流环境审批,不应使用 NPM_TOKEN 或插件 OTP 流程;@openclaw/* 插件发布走独立维护者流程,且只发布 npm 上已存在的插件。凭据、恢复步骤和 mac 签名/公证细节在私有维护者文档中,本技能资料未提供具体内容。