发布通道
| 通道 | 说明 |
|---|
| stable | 正式版，默认发布到 npm beta，可显式发布到 latest |
| beta | 预发布版，发布到 npm beta |
| dev | main 分支的最新代码 |
版本命名
- 正式版：
YYYY.M.D（git tag：vYYYY.M.D）
- 修正版：
YYYY.M.D-N
- Beta 版：
YYYY.M.D-beta.N
- 不补零（如
2026.5.1 而非 2026.05.01）
发布节奏
- Beta 先行，stable 在 beta 验证后跟进
- 从
release/YYYY.M.D 分支发布，不在 main 上直接操作
- 已推送的 beta tag 需要修复时，切下一个
-beta.N，不删除旧 tag
发布操作员检查清单（简版）
- 从最新
main 拉取，确认 CI 绿色
- 用
/changelog 更新 CHANGELOG.md
- 检查兼容性记录（
src/plugins/compat/registry.ts）
- 创建
release/YYYY.M.D 分支
- 运行
pnpm release:prep 刷新生成文件
- 运行
OpenClaw NPM Release（preflight_only=true）
- 运行
Full Release Validation
- 验证通过后运行
OpenClaw Release Publish
发布测试箱
| 测试箱 | 说明 |
|---|
| Vitest | 完整单元/集成测试套件 |
| Docker | 打包环境下的 E2E 验证 |
| QA Lab | Agent 行为和 channel 级别验证 |
| Package | 可安装产品验证（Package Acceptance） |
相关页面