计划与维护工作流
PR、每小时与发布¶
普通拉取请求(包括 fork 贡献)不再在 ci.yml 中选择这些开销较大的作业:
- Real-Gateway 控制界面 E2E(模拟/打包的
checks-ui-e2e仍由所有者选择)。 - Windows 节点测试、macOS 节点测试、macOS Swift 作业以及 iOS 构建/模拟器冒烟测试。
- 已发布 npm 驱动 × 候选更新单元,包括更新所有者 PR。
- 依赖/失效导出扫描(Knip)和完整运行时拓扑/架构作业。
运行时导入循环检查仍保留在现有 PR 防护中;TypeScript 变更还会在该防护中选择 Madge。
src/、extensions/或packages/下的 TypeScript 变更也会在同一作业中选择 Kysely 防护;生成的 Kysely 类型仍保持延迟。参见作用域选择。 - Android 截图捕获。
前四组保留其现有的每小时主层级和完整发布清单。Android 截图此前已从每小时主层级中排除,并继续保留在完整的手动/发布验证中。普通手动调度和精确头的 release_gate 回退行为不变。SwiftLint 和 SwiftFormat 属于已迁移的 Apple 作业的一部分;它们不会拆分为新的 PR 作业。其他源码测试、静态正确性门禁、Android 单元/lint 工作以及独立的原生本地化检查保留其现有的 PR 选择。
这将频繁的 PR 关键路径移至其现有的后续层级,而不改变作业执行的内容。因此,这些作业特有的失败可能在合并后出现。openclaw/ci-gate 仅要求清单所选择的作业;其必需检查身份和仓库保护不变。参见作用域选择以获取层级表和所有者边界。
每小时主 CI¶
完整的 main 验证层级每小时的第 23 分钟直接从 ci.yml 运行。
GitHub 的调度事件选择规范的主修订版;手动调度输入不能声称调度运行策略。调度选择完整的 main 层级,包括 Android,且不过滤到最后一次提交。Node、原生平台、文档、QA 冒烟测试、浏览器进程证明和已发布更新器幸存者都针对该修订版运行。Node 测试使用完整的紧凑清单,包括工具和 PR 豁免文件,在其 77 行主层级上限内。
现有的 Plugin Prerelease 工作流单独拥有完整的扩展运行时清单,在每小时的第 37 分钟运行。调度运行锁定调度的规范 main SHA,并只选择其扩展矩阵和所需摘要。清单仅限的捆绑插件和直接位于 extensions/ 下的测试使用其现有的文件分片执行路径;
包支持的插件保留其现有的批处理所有者。现有的 12 作业并发限制保持不变。一个不取消的每小时槽位允许活动证明完成,同时 GitHub 合并待定提示;手动和发布运行保留独立的并发组和所有现有阶段。普通 CI 不再附加第二个部分扩展清单。检查 CI 和 Plugin Prerelease 两者以获取每小时覆盖;Full Release Validation 将两个现有子项固定到其精确目标。
Full Release Validation 和普通手动 CI 默认保留 validation_tier=full。它们额外运行仅发布版的运行时/UI 测试、最低 Node 兼容性、iOS 截图、原生 Release 构建、Android 打包以及全部六个 Docker 种子场景。每小时 iOS 保留 ios-build (tests):Swift lint、Rust 测试、语音清理、原生 Access 以及完整的聚焦应用/通知生命周期清单。托管附件 UI/导出证明、Watch 操作模拟器套件和 Watch 投递 UI 证明仅在完整层级的手动/发布验证中运行,每个用例和断言都保留在那里。Android 保留手机/Wear 测试和 lint。Docker 幸存者使用现有的主冒烟包,包括运行时、资源、公共 SDK 声明和 tarball 完整性。手动 SDK API 差异报告保持仅手动:调度提示没有变更范围可比较。
主层级 iOS 构建针对所选模拟器的原生架构,并禁用编译器索引,正如 PR 冒烟测试已做的那样。语音和生命周期测试禁用 Xcode 的冗长诊断收集,同时保留其日志和 xcresult 包。完整层级的手动/发布验证保留通用模拟器构建和失败诊断。这消除了在 76-94 分钟的每小时作业中观察到的重复架构工作和诊断停滞;它不建立新的完成界限。
调度 CI 使用自动主运行器放置,包括在配置时首次尝试的混合放置。原生运行器标签、工作线程限制和重试回退保持不变。控制界面和原生翻译源检查保持强制;生成的区域设置漂移仅为建议性,因为合并后的翻译工作流拥有其修复。普通手动运行(包括 validation_tier=main)保留严格的区域设置 parity。
主层级运行不发出完整验证修订确认。Docs Agent 的自动写入门禁要求该完整层级收据;其显式手动调度仍然可用。
直接检查调度的 CI 运行及其 openclaw/ci-gate 作业。
每次调度运行独立启动,因此较旧的 iOS 模拟器阶段不能阻塞下一个小时间核检查。只有调度的 ios-build 作业共享一个不取消的槽位:活动证明完成,而 GitHub 在另一个 iOS 作业到达时替换待定的 iOS 作业。到达顺序不必匹配修订顺序。在聚合所有者处,openclaw/ci-gate 仅在调度的 openclaw/openclaw 在 main 上的运行中接受所选 ios-build 结果为 cancelled,并发出“Hourly iOS proof coalesced”通知。真正的 iOS 失败或意外跳过仍然使门禁失败,另一个所选通道的取消也是如此。手动和 PR iOS 取消保留其现有的失败策略。带有此通知的通过门禁将 iOS 证明委托给后续的调度作业;它不在被取消的修订版上验证 iOS。即使聚合成功,GitHub 的工作流级结论仍可以是 cancelled。
手动/发布 CI 保持独立,且仅安全推送不能取消调度工作。CI 在发布验证期间保持可用;OPENCLAW_RELEASE_PRIORITY_RUN 不控制准入。
每小时 CI 负责文档检查,包括 RunsOn 路由。独立的 Docs 工作流保留手动和选择加入的推送运行。
Node Runtime Conformance 和 Plugin Init Scaffold Validation 在每小时的第 23 分钟检查变更的输入。它们仅在所需作业在同一分支上于 24 小时内通过且完整输入差异未变化时重用证明。被跳过的作业无法推进比较基线。缺失证明、不完整差异或 API 错误会请求重新验证。每项决策都会报告其理由。两个工作流都保留其 PR 范围,并每天刷新证明以应对依赖漂移。
Sandbox Common Smoke 每天 05:23 UTC 运行,并保留 PR 和手动运行。Plugin NPM Release 每小时运行其非发布元数据和未发布包的打包预览。计划运行无法触发其仅限手动的审批或发布作业。Vitest Cache Warm 在每小时的第 17 分钟运行,保留其手动和 repository-dispatch 恢复路径。预热器是独立的。其完成时间不保证在 CI 之前。
恢复每次推送 CI¶
将 仓库 Actions 变量 OPENCLAW_CI_ON_PUSH 设置为 true,位于设置 → 密钥和变量 → Actions → 变量下。这将恢复 CI 中此前按路径过滤的完整 main 推送准入、独立检查、插件制品预览和缓存预热。GitHub 字符串比较不区分大小写;请使用文档记录的小写 true。未设置、为空、false 和其他值保持仅每小时的 main 层级 CI。删除该变量或将其设置为 false 以恢复默认状态。无论哪种方式,每小时运行保持启用。无需更改密钥、提交或保护设置。
如需立即运行 main 层级 CI,请选择 CI → 运行工作流 → main,选择主验证层级和 Android,或运行:
各个独立工作流也可以手动运行。直接的 CI 调度和发布验证子项保留其现有输入和行为;在请求完整平台覆盖时设置 include_android=true。要衡量开发分支上的每小时覆盖,请在该分支上以 validation_tier=main 和 include_android=true 调度 ci.yml。main 层级要求工作流和检出共享一个修订版本;它无法使冻结的发布目标合格,也无法替代要求精确头部的 PR 发布门禁。
推送时保留的内容¶
CodeQL 保留所有七个 main 推送安全类别。CI 在其现有的非文档推送范围内保留 security-fast(已提交的私钥和变更工作流安全审计)。拉取请求、推送和计划 CI 跳过生产依赖审计;只有发布调度运行它,且作为警告。默认 main 推送还针对精确推送的 before SHA 运行基线增长、断言安全、测试超时竞争和新协议方法元数据保护,因此计划 CI 的 main 对自身比较不会丢失这些检查;Workflow Sanity 在每次被准入的推送中检查跟踪的冲突标记。其工作流 lint 和安全工具仅在工作流、操作或 lint 策略输入更改时运行。完整的 CI 聚合作业在默认 main 推送中被跳过,不会在可运行的 PR 或完整手动运行中被跳过。CodeQL 和 Workflow Sanity 在发布验证期间仍然可用。PR 必需检查名称和安全审查执行保持不变。
发布及其前置检查保持事件驱动:文档镜像和网站安装程序同步、runner 镜像发布、区域设置生成 PR 和 ClawSweeper 活动转发保留其现有准入。当发布输入更改时,运行 stable main 收尾。现有的 pnpm release:stable 收尾阶段等待成功发布,验证 main,并调度收尾。保存了编排器状态后,使用 pnpm release:stable YYYY.M.PATCH --from closeout 恢复它。
如果在 main 前向移植后直接从 Actions UI 发布,请在 Release Publish 成功且 main 携带已发布版本和变更日志后调度收尾:
无关的源推送不再轮询发布完成。手动恢复保留其现有证据检查。Docs Agent 在许可其自动写入作业之前验证精确成功的完整层级 CI 尝试。选择加入的完整 main 推送合格;每小时 main 层级运行和仅安全推送不合格。在未设置 OPENCLAW_CI_ON_PUSH 的情况下,Docs Agent 的自动写入因此被禁用。显式的非机器人 Docs Agent 调度仍然可用,其当前 main 和每小时节奏保护仍适用于合格的工作流运行调用。Security Review 仍然处理 PR 和手动 CI 完成。发布/标签和仅 PR 工作流保留其现有触发器;此更改不会在原本不存在的地方添加合并队列支持,也不会更改任何仓库规则集。
GitHub cron 在默认分支上尽力而为,不是一小时延迟 SLA:运行可能在高负载下延迟或丢弃,公共仓库的计划运行在非活动后可能被禁用。Main 层级 CI 故意重新检查未更改的 SHA,而不是引入单独的最后一个成功账本。失败可以在下一个每小时机会重试,手动调度仍然可用。如果 iOS 证明耗时超过一小时,后续每小时运行可以在等待该槽位时完成其其他检查。被取代的待处理 iOS 作业可以通过委托的 iOS 证明保持聚合绿色,但不能使 Docs Agent 合格。这些已完成的检查仍会消耗 runner 时间;单次运行的 worker 限制不会共同约束并发的每小时运行。该槽位不覆盖手动/PR iOS 作业或由较旧工作流准入的运行。这消除了工作流准入阻塞,而不是 runner 容量等待。不声称节省了测量成本或严格的完成间隔。
夜间完整发布验证¶
Full Release Validation Nightly(full-release-validation-nightly.yml)每 3 小时在第 7 分钟 UTC(7 */3 * * *)运行,以便在提交落地时保持发布就绪状态,使用 stable 配置文件、浸泡和阻塞性能、reuse_evidence=true、rerun_group=all 和 main-qualification 目的。它检出调度器的精确 main SHA 并运行 SHA 固定的助手(pnpm ci:full-release --sha <sha> --workflow-sha <sha> --trusted-workflow-ref main),明确保留计划的非发布 main 合格路由。它将该 SHA 用作 Validation SHA 和 Tooling SHA,并从不可变的 release-ci/<sha12>-<id> 传输引用调度。一旦 main 移动,直接从 main 调度会失败,因为父级拒绝从已移动的工作流引用调度子项。同一 SHA 的仍活跃父级共享该 SHA 特定的 Full Release Validation 并发组并将此调度排队;已完成的运行将再次接受验证,并通过重用取得自身精确目标的证据。父级在配置时自动使用 OPENCLAW_RELEASE_RUNNER_GROUP。计划作业在与父级 release_decision 等待器相同的 runner 选择和 720 分钟预算上运行,匹配助手的 720 分钟监视。
该作业通过其发布决策(Release Decision)与证据验证来监视父运行,因此其结论即为验证结果。一个并发组同时覆盖计划运行和手动运行且不取消:当某个作业仍在监视其父运行时,下一次触发会等待,而 GitHub 只保留最新的待处理运行,因此运行不会重叠,且最新等待触发的 SHA 将在下一次运行。
子级复用是精确目标匹配:当 main 自上一次运行以来未发生移动时,reuse_evidence=true 会让每个子级采用该运行的凭证,而不必再次运行;新的 SHA 则会派发全新的子级。作业日志会打印父运行 URL;上传的 full-release-validation-nightly-request 工件保存辅助程序的请求记录,供 node scripts/full-release-validation-at-sha.mjs --reconcile-request <path> 使用。失败后,辅助程序会同时保留两个传输引用(transport ref),以便重跑和诊断。
要列出每晚的父运行,请按传输分支过滤:
gh run list --workflow full-release-validation.yml --event workflow_dispatch \
--json databaseId,headBranch,headSha,status,conclusion \
--jq '.[] | select(.headBranch | startswith("release-ci/"))'
OpenClaw Performance¶
OpenClaw Performance 是产品/运行时性能工作流。它每天在 main 上运行,也可以手动触发:
gh workflow run openclaw-performance.yml --ref main -f profile=diagnostic -f repeat=3
gh workflow run openclaw-performance.yml --ref main -f profile=smoke -f repeat=1 -f deep_profile=true -f live_openai_candidate=true
gh workflow run openclaw-performance.yml --ref main -f target_ref=v2026.5.2 -f profile=diagnostic -f repeat=3
手动触发通常对工作流 ref 进行基准测试。设置 target_ref 可使用当前工作流实现对某个发布标签或其他分支进行基准测试。已发布的报告路径和最新指针以被测 ref 为键,每个 index.md 记录被测 ref/SHA、工作流 ref/SHA、Kova ref、profile、通道认证模式、模型、重复次数和场景过滤器。
该工作流从固定版本安装 OCM,并按固定的 kova_ref 输入从 openclaw/Kova 安装 Kova,然后运行三个通道:
mock-provider:针对本地构建的运行时运行 Kova 诊断场景,使用确定性的模拟 OpenAI 兼容认证。mock-deep-profile:对启动、网关和代理回合(agent-turn)热点进行 CPU/堆/跟踪剖析。按计划运行,或在触发时通过deep_profile=true运行。live-openai-candidate:一次真实的 OpenAIopenai/gpt-5.6-luna代理回合。按计划选定,或在触发时通过live_openai_candidate=true选定。没有资格使用实时凭据的候选项会被跳过。对于已选定且有资格的通道,缺少OPENAI_API_KEY会导致该通道失败,而不是跳过。
在对部分 Kova 结论表示容忍之前,报告门禁要求聚合的 RSS 和 CPU 样本与各条记录一致,包括重复测量。缺少样本或替换样本都会使门禁保持非零状态,即使样本数量匹配也是如此。
OpenClaw 原生源码检查在独立的 source_performance 作业中运行,在 resolve_target 之后与 Kova 通道并行:覆盖默认、跳过通道、内部钩子和五十插件启动场景的网关启动耗时与内存;打包插件导入 RSS、重复的 mock-OpenAI channel-chat-baseline 问候循环、针对已启动网关的 CLI 启动命令,以及 SQLite 状态冒烟性能检查。当被测 ref 存在先前已发布的 mock-provider 源码报告时,源码摘要会将当前 RSS 和堆值与基线进行比较,并将较大的 RSS 增长标记为 watch。发布者会将这些源码工件包含在 mock-provider 报告包中,Markdown 摘要位于 source/index.md,原始 JSON 位于其旁边。
每个通道都会上传其完整的 GitHub 工件,包括 CPU、堆、跟踪和压缩的诊断包。一个独立的发布者作业会下载并验证这些工件,然后生成一个短期有效的 ClawSweeper GitHub App 令牌,该令牌范围仅限于 openclaw/clawgrit-reports 内容,且只传递给 Git 推送步骤。它在 openclaw-performance/<tested-ref>/<run-id>-<attempt>/<lane>/ 下提交 report.json、report.md、index.md、源码检查工件以及包元数据/校验和;完整诊断归档保留在关联的 Actions 工件中。发布者会在尝试推送之前拒绝任何超过 50 MB 的报告文件。当前被测 ref 指针是 openclaw-performance/<tested-ref>/latest-<lane>.json。计划运行和 profile=release 触发在应用令牌创建或报告发布失败时视为失败。手动非发布触发的发布失败是建议性(advisory)级别的,并会保留 GitHub 工件。先前的源码基线是从公共报告仓库匿名获取的,因此成功获取基线并不能证明发布者认证成功。
所有显式的 Performance 工作流 Git 命令都使用固定的 Git 生命周期所有者,该所有者在每个作业所选 checkout 之前于 RUNNER_TEMP 中准备好。目标解析、Kova 修订版/安装 Git、源码修订版与基线 Git,以及本地发布者操作仍不受此限制。只有初始报告获取、每次推送和每次对账(reconciliation)获取具有 120 秒的截止时间。该所有者会在读取、checkout 复用、工件消费、输出或重试之前排空整个 Git 进程树;独占式报告获取只会在调用创建的锁被清除后回收这些锁。
报告准备和所有获取操作都是匿名的。应用令牌仅在新报告准备完成后创建,随后立即从环境中移除,并仅作为掩码 Basic 头传递给推送命令;它绝不会进入远程 URL 或仓库配置。经验证的已有报告会在令牌创建之前成功返回。只有成功的空 ls-tree 查找才表示基线或报告不存在;仓库/读取失败是终止性的。格式错误的基线指针 JSON 仍保持建议性(advisory)状态,经核实清理后的普通基线获取失败也是如此。
发布允许恰好五次推送。每一次失败的推送(包括第五次)都会经历 2/4/6/8/10 秒的退避,随后执行一次匿名对账抓取。即使第五次推送结果不明确,抓取到的远程报告也能证明成功;直接推送成功则无需抓取。否则,第 1–4 次尝试会在分离的 FETCH_HEAD 上使用 cherry-pick -X theirs 重放报告提交,在保留并发产生的唯一报告的同时,让当前写入者赢得最新指针。不存在第五次尝试的重放。普通抓取失败会在第 1–4 次尝试时发出警告并重试。只有类型化的 Git 失败,或在已验证清理之后的超时,才允许恢复;所有者设置、普查、清理失败和取消都会在回退、重试、重放或成功之前停止。完整发布验证继续完全禁用发布器,并且仅将性能证据作为工作流工件保留。
Gateway 并发基准测试¶
手动 gateway-concurrency 模式会对一个繁忙且隔离的 Gateway 进行测量,并将其结果作为 Actions 工件保留:
gh workflow run openclaw-performance.yml --ref main \
-f mode=gateway-concurrency -f live_openai_candidate=true
一个作业会构建所选源码一次,运行模拟提供程序,然后可选地使用真实密钥运行 OpenAI。每次运行会跨 32 个代理播种 1,000 个会话,并在进行会话更新、历史读取、订阅和 64 轮检查的同时完成 96 轮对话。Dreaming 已禁用;正常的索引编制、回顾和数据库空闲保留策略保持不变。实时运行拒绝工具调用,并将模型输出上限设为 128 个 token。结果包括负载阶段的主线程和 Worker CPU 剖析数据。这两个提供程序代表不同的工作负载,而非前后速度对比。
实时执行要求使用默认分支的工作流,且被测 SHA 必须等于工作流 SHA。如果该条件未满足或缺少 OPENAI_API_KEY,所请求的实时运行将失败。省略 live_openai_candidate 可仅获取模拟证据。此模式不运行任何 Kova 车道、源码检查作业或报告发布,也不会被每日计划选中。有关本地调用和结果解读,请参阅 Gateway 并发。
Vitest 配对基准测试¶
仅限手动运行的 vitest-pair 模式会比较两个确切的提交,并采用候选提交中的工作流实现:
gh workflow run openclaw-performance.yml \
--ref <candidate-branch> \
-f mode=vitest-pair \
-f baseline_ref=<40-character-baseline-sha> \
-f target_ref=<40-character-candidate-sha>
两个输入都必须是小写完整 SHA,target_ref 必须等于由 --ref 选定的工作流 SHA,且拒绝重跑。请发起一次全新的工作流运行,而不是重试之前的尝试。在此模式下,Kova、源码检查、报告发布及其仅限工件的保护措施均保持跳过。基准测试作业具有只读仓库权限,不接收密钥,不恢复或保存 Actions 缓存,并在禁用凭据的情况下检出 helper、候选和基线内容。
已提交的车道清单涵盖具有代表性的核心单元测试、Gateway、Control UI jsdom 和 worker 生命周期测试。两个提交必须暴露相同的所选测试/配置路径和字节,并在创建计时状态之前通过正确性验证。正确性验证还要求双方报告相同的规范化测试文件、测试标识、状态和计数。此后的每次运行都必须匹配已确立的执行摘要。测试框架随后会为每一侧和每一条车道运行一次不计入结果的预热,以交替的侧顺序和轮换的车道顺序进行七轮配对,外加一对使用全新缓存且单独标记的冷配对。冻结安装属于设置阶段,且从不计时。
每个子进程都有固定的截止时间和进程组属主。单独的 165 分钟测试框架截止时间在 180 分钟作业超时内预留了 15 分钟,用于清理、最终清单定稿和工件上传。它会在拒绝进一步启动子进程之前,先中止并等待(join)当前活动且受管理的子进程。每个安装、正确性、预热、被测和冷进程都会通过 npm_execpath 获得精确固定的 pnpm 可执行文件,并使用私有的 Corepack 和 pnpm 状态;解析出的可执行文件和版本会记录在环境和运行记录中。
工件包括原始日志、原始 Vitest JSON 报告、执行摘要和计数、GNU time 用户/系统 CPU、墙钟计时、环境和 Git 标识、源码/配置哈希、逐次运行记录、配对比率分析以及最终的成功或失败清单。即使在测试框架失败之后,工作流也会尝试定稿并上传工件。运行器丢失或外部工作流取消仍可能阻止这些步骤运行。可变的 pnpm 和运行时缓存保留在未上传的临时目录树中。阈值固定于 scripts/vitest-pair-benchmark-lanes.json 中。验收使用七轮每轮聚合比率的中位数,并按车道总持续时间对每轮加权;高于 5% 则判定失败。关键车道仅在其测得比率中位数超过 10% 且配对增量中位数至少为一秒时才判定失败。单独的冷配对仍作为诊断证据,绝不会导致验收失败。只有当每个代表性车道的中位数均优于改善比率,且其七个配对中至少五个单独满足该比率时,报告才会声称有所改善。否则,它会报告逐车道证据,而不作广泛的改善声明。工件的命名仅使用可信的工作流运行 ID 和尝试编号;确切的基线和候选提交仍记录在工件内部。
安全审查对账器¶
每十分钟,安全审查会对 CI 完成记录进行对账,范围从上一次成功计划轮次开始前五分钟起,直至五分钟前(六十分钟回退,十二小时上限)。各轮次之间无缝衔接、没有空隙;延迟或丢失的 cron 触发只会扩大下一个窗口,直至达到上限。运行列表覆盖从窗口开始前三小时到当前时间的创建时间。GitHub 将每次过滤查询限制为 1,000 条结果,因此解析器会对报告总数超过该限制的范围进行二分切分。每个较小的范围都会持续分页,直到出现一个不满整页的页面,其去重运行计数必须覆盖第一页所报告的总数。出现十个完整页面或去重运行数少于报告数时,轮次会在任何状态发布或矩阵输出之前即判定失败,并保留锚点以供完整重试。包含端点的相邻范围之间相隔一秒,运行 ID 会在不同页面和切片之间去重。不足十分钟却仍超过 1,000 次运行的范围会在状态发布或矩阵输出之前判定失败,因此已覆盖的窗口不会向前推进。下一轮次将从最后一次成功的轮次开始重新扫描。计划内的解析器轮次共享一个并发组,但不会取消正在进行的轮次;GitHub 会保留一个待处理的轮次,该轮次仍从最后一次成功的窗口开始。每轮最多选择 100 个 PR head,按最早的 CI 完成时间优先排序,运行 ID 用于打破平局;达到上限后即停止读取状态。如果仍有候选者,reconcile-backlog 作业会在所选审查完成后使工作流失败。这保持了相同的锚点:已审查的 head 具有最新状态,使得下一计划轮次能够从同一窗口中选择剩余部分。
After a reconciler outage longer than twelve hours, older lost completions need a new push or a Security Review rerun.
A CI rerun keeps its original creation time. A rerun of a run created more than three hours before the window relies on its own completion delivery; if that is lost, a new push or a Security Review rerun recovers it.
Wholly skipped CI runs are ignored. The resolver reads status history in reverse
chronological order and uses only the newest openclaw/ci-gate status from
github-actions[bot] with creator type Bot. Other publishers are ignored.
Normal review runs only when that Actions-owned status is missing, older than
CI completion, or pending. Only a
non-pending status created at or after CI completion is settled and stops
reselection. Every pending status remains eligible, including a review wait
published after a pre-completion CI read. Tiled windows bound the harmless extra
review when a head legitimately waits on newer in-progress CI.
It never checks out PR code and uses one hosted
ubuntu-24.04 resolver job per pass, run-list reads plus paginated
status-history reads per newly completed head, and no Blacksmith registrations.
See Security review checks.
QA Lab¶
QA Lab has dedicated CI lanes outside the main smart-scoped workflow. Agentic parity is nested under the broad QA and release harnesses, not a standalone PR workflow. Use Full Release Validation with rerun_group=qa-parity when parity should ride with a broad validation run.
- The
QA-Lab - All Lanesworkflow runs nightly onmainand on manual dispatch; it fans out mock parity plus live Matrix, Telegram, Discord, WhatsApp, and Slack jobs. Live jobs use theqa-live-sharedenvironment; Telegram, Discord, WhatsApp, and Slack use Convex leases, while Matrix provisions disposable local credentials. - Manual and scheduled aggregate runs retain the default
allconcurrency scope. Trusted release calls use separatematrixandbuzzscopes so those lanes can run together for one target SHA; Matrix calls for the same SHA still serialize, while Buzz calls serialize across SHAs because they share pooled credentials. - Release Matrix catalog validation runs on a 16-vCPU Blacksmith runner with a 90-minute job budget. Changes to that timeout, runner size, or concurrency require a matching workflow guard and exact-candidate release proof.
QA Profile Evidencebalances taxonomy category groups across eight isolated jobs, keeps non-isolating live channels on one shard, then asks QA Lab to merge their validated evidence into one attestedqa-evidence.json. A timed-out or missing shard always fails aggregation;allow_failuresapplies only when every shard completed and produced valid evidence. DirectMaturity scorecarddispatches defaultallow_failureson so incomplete evidence can still render a diagnostic docs artifact. A terminal result gate runs after optional generated-PR publication and fails the run when any scenario failed or remained blocked; reusable release calls remain strict by default.
Scheduled, manual, and release Matrix checks use the deterministic mock provider so the live transport contract is isolated from model latency and normal provider-plugin startup. Telegram release checks use the same deterministic model boundary. The live transport gateway disables memory search because QA parity covers memory behavior separately; provider connectivity is covered by the separate live model, native provider, and Docker provider suites.
OpenClaw Release Checks also runs the release-critical QA Lab lanes before release approval; its QA parity gate runs the candidate and baseline packs as parallel lane jobs, then downloads both artifacts into a small report job for the final parity comparison.
For normal PRs, follow scoped CI/check evidence instead of treating parity as a required status.
CodeQL¶
The CodeQL workflow is intentionally a narrow first-pass security scanner, not the full repository sweep. Daily, manual, main push, and non-draft pull request guard runs scan Actions workflow code plus the highest-risk JavaScript/TypeScript surfaces with high-confidence security queries filtered to high/critical security-severity.
The pull request guard stays light: it only starts for changes under .github/actions, .github/codeql, .github/workflows, packages, scripts, src, or process-owning bundled plugin runtime paths, and it runs the same high-confidence security matrix as the scheduled workflow. Android and macOS CodeQL stay out of PR defaults.
Security categories¶
| Category | Surface |
|---|---|
/codeql-security-high/core-auth-secrets |
Auth, secrets, sandbox, cron, and gateway baseline |
/codeql-security-high/channel-runtime-boundary |
Core channel implementation contracts plus the channel plugin runtime, gateway, Plugin SDK, secrets, audit touchpoints |
/codeql-security-high/network-ssrf-boundary |
Core SSRF, IP parsing, network guard, web-fetch, and Plugin SDK SSRF policy surfaces |
/codeql-security-high/mcp-process-tool-boundary |
MCP servers, process execution helpers, outbound delivery, and agent tool-execution gates |
/codeql-security-high/process-exec-boundary |
Local shell, process spawn helpers, subprocess-owning bundled plugin runtimes, and workflow script glue |
/codeql-security-high/plugin-trust-boundary |
Plugin install, loader, manifest, registry, package-manager install, source-loading, and Plugin SDK package contract trust surfaces |
| 类别 | 表面 |
|---|---|
平台特定安全分片¶
CodeQL Android Critical Security— 定时 Android 安全分片。在 workflow sanity 接受的最小 Blacksmith Linux runner 上手动构建 Android 应用以供 CodeQL 使用。上传到/codeql-critical-security/android下。CodeQL macOS Critical Security— 每周/手动 macOS 安全分片。在 GitHub 托管的 Linux 上准备生成的 Mermaid 资源,然后在 GitHub 托管的 Intel runner 上手动构建 ARM64 macOS 应用以供 CodeQL 使用,且不包含未使用的 index-store 或 debug-info 产物;从上传的 SARIF 中过滤掉依赖构建结果,同时保留第一方生成的协议模型;并上传到/codeql-critical-security/macos下。其 macOS 作业有 90 分钟上限,因为完整的跟踪构建和分析超过了之前的 45 分钟预算。由于即使干净时 macOS 构建也占主导运行时间,因此保留在每日默认之外。
关键质量类别¶
CodeQL Critical Quality 是相应的非安全分片。它仅在 GitHub 托管的 Linux runner 上针对狭窄的高价值表面运行错误严重级别、非安全的 JavaScript/TypeScript 质量查询,以便质量扫描不会消耗 Blacksmith runner 注册预算。其拉取请求守卫有意小于定时配置:非草稿 PR 仅运行它们所触及表面的匹配分片,来自十三个可 PR 路由的分片 — agent-runtime-boundary、channel-runtime-boundary、config-boundary、core-auth-secrets、gateway-runtime-boundary、mcp-process-runtime-boundary、memory-runtime-boundary、network-runtime-boundary、plugin-boundary、plugin-sdk-package-contract、plugin-sdk-reply-runtime、provider-runtime-boundary 和 session-diagnostics-boundary。ui-control-plane 和 web-media-runtime-boundary 不纳入 PR 运行。CodeQL 配置和质量工作流更改会运行完整的 PR 分片集(网络运行时分片以其自身的 CodeQL 配置文件和网络拥有的源路径为依据)。
手动调度接受:
profile=all|agent-runtime-boundary|config-boundary|core-auth-secrets|channel-runtime-boundary|gateway-runtime-boundary|memory-runtime-boundary|mcp-process-runtime-boundary|network-runtime-boundary|plugin-boundary|plugin-sdk-package-contract|plugin-sdk-reply-runtime|provider-runtime-boundary|session-diagnostics-boundary
这些狭窄配置是用于隔离运行单个质量分片的教学/迭代钩子。
在拉取请求中,网络运行时分片从快速差异扫描开始。敏感
socket 导入/调用和 proxy-policy 令牌、对其查询/配置/测试夹具的编辑,以及
对 Codex 传输的更改会在同一 PR 作业中选择完整 CodeQL 分析。
受监控的非测试源缺失或空补丁也会选择完整分析;
元数据获取或解析失败会停止分片选择,而不是静默跳过它。
已知的普通差异保持快速路径。完整路径在分析之前运行语义查询测试,
包括对配置的 packages/net-policy/src 目录的覆盖,
以及保留精确的 owner/function 允许项和测试路径排除项。
完整分析会在任何 SARIF 发现或 SARIF 输出缺失时使作业失败;
敏感差异是路由信号,而不是发现。
| 类别 | 表面 |
|---|---|
/codeql-critical-quality/core-auth-secrets |
身份验证、密钥、沙箱、cron 和网关安全边界代码 |
/codeql-critical-quality/config-boundary |
配置架构、迁移、归一化和 IO 契约 |
/codeql-critical-quality/gateway-runtime-boundary |
网关协议架构和服务器方法契约 |
/codeql-critical-quality/channel-runtime-boundary |
核心通道和捆绑通道插件实现契约 |
/codeql-critical-quality/agent-runtime-boundary |
命令执行、模型/提供商调度、自动回复调度和队列,以及 ACP 控制平面运行时契约 |
/codeql-critical-quality/mcp-process-runtime-boundary |
MCP 服务器和工具桥接、进程监督辅助功能以及出站交付契约 |
/codeql-critical-quality/memory-runtime-boundary |
内存宿主 SDK、内存运行时外观、内存 Plugin SDK 别名、内存运行时激活胶水代码和 memory doctor 命令 |
/codeql-critical-quality/network-runtime-boundary |
网络策略包、原始 socket 和代理捕获运行时、SSH 隧道、网关锁、JSONL socket 以及推送传输表面 |
/codeql-critical-quality/session-diagnostics-boundary |
回复队列内部、会话交付队列、出站会话绑定/交付辅助功能、诊断事件/日志包表面以及 session doctor CLI 契约 |
| 类别 | 表面 |
|---|---|
/codeql-critical-quality/plugin-sdk-reply-runtime |
Plugin SDK 入站回复分发、回复负载/分块/运行时辅助函数、频道回复选项、投递队列以及会话/线程绑定辅助函数 |
/codeql-critical-quality/provider-runtime-boundary |
模型目录规范化、提供商身份验证与发现、提供商运行时注册、提供商默认值/目录,以及 Web/搜索/抓取/嵌入注册表 |
/codeql-critical-quality/ui-control-plane |
控制 UI 引导、本地持久化、网关控制流以及任务控制平面运行时契约 |
/codeql-critical-quality/web-media-runtime-boundary |
核心 Web 抓取/搜索、媒体 IO、媒体理解、图像生成以及媒体生成运行时契约 |
/codeql-critical-quality/plugin-boundary |
加载器、注册表、公共表面以及 Plugin SDK 入口点契约 |
/codeql-critical-quality/plugin-sdk-package-contract |
已发布包侧 Plugin SDK 源码和插件包契约辅助函数 |
质量与安全保持分离,以便质量发现可以被计划、度量、禁用或扩展,而不会掩盖安全信号。Swift、Python 和捆绑插件的 CodeQL 扩展应仅在窄配置文件具有稳定运行时和信号后,作为范围限定或分片后续工作重新加入。
维护工作流¶
PR CI 清扫器¶
PR CI Sweeper 每小时在第 7 分钟检查最近的拉取请求。它通过有界的关闭/重新打开周期修复缺失的
pull_request CI 和 GitHub startup_failure 运行,并在开始基础设施恢复时发出警告。草稿、最近更新
或存在冲突的 PR,以及启用自动合并的 PR 保持不变。关联的
排队中、运行中、失败或已取消的 CI 会阻止恢复:取消并不能
证明提供商失败或测试从未执行,因此清扫器永远不会
自动重新执行这些工作流。
评论自动化¶
评论作业在获取托管 runner 之前拒绝已知的无操作。Maintainer
Command Reactions 仅在使用其默认命令列表时跳过没有 / 的评论;任何非空的 MAINTAINER_COMMAND_REACTIONS 覆盖都会保留完整匹配器,
包括没有斜杠的命令。Auto response 会跳过由 Bot 创建且 Barnacle 已忽略的 issue 评论,以及其作者关联
已豁免的目标。其编辑准入保留标题、正文和 PR 基础变更。
PR 上下文检查会省略策略中已知的 bot 和特权作者豁免。
Labeler 保留标题/基础 PR 编辑,并跳过未更改标题的 issue 编辑。这些决策发生在检出和 runner 分配之前。
Auto response、Labeler、PR 上下文检查和 ClawSweeper 仅在作业准入后获取并发 槽位。跳过的事件不能替代有用的待处理 工作。Labeler 为每个 PR 和 issue 使用独立分组,手动回填 单独串行化;PR 上下文检查会取消同一 PR 上已被取代的检查。 ClawSweeper 保留其现有的逐项取消规则和所有标签/评论 接收,仅跳过明确为空的元数据编辑。Security Review 会省略仅 PR 文本编辑,同时保留基础/权限变更、head 变更和 审批撤销;其按 head 的评审串行化保持不可取消。
依赖项审计¶
Dependency Audit 每天在 UTC 07:23 运行生产 lockfile 审计,并在手动
分发时运行。它与 PR CI 保持分离,并在发现项、不可用的
公告或无效数据时失败。这个红色分诊信号不是必需的 PR 检查,
也从不阻止合并。请在 main 上跟进依赖项升级。
每个依赖项图作为一个请求提交;
发布检查保持其产品和工具图分离。
发布 CI 和此严格审计都会在作业摘要中发布结果、包数量、 持续时间、时间戳和有界失败原因。已完成的 npm 检查仅覆盖 npm 批量公告,而非每个上游公告源。
分诊负责人是 @steipete,于 2026-09-03 在
#137960 中设置。没有 .github/CODEOWNERS
规则覆盖 .github/workflows/dependency-audit.yml,因此这一行是该所有权的唯一
记录。
调查失败的定时运行,并重新运行严格工作流以确认
恢复:
GitHub 会将定时运行通知发送给工作流创建者或最新的 cron 编辑器,具体取决于该账户的 Actions 通知设置。接管所有权时请保持这些 通知启用;摘要提及不会发送警报。参见 GitHub 的工作流通知规则。
要在本地复现,请运行
node scripts/pre-commit/pnpm-audit-prod.mjs --audit-level=high。添加 --ci
会选择更短的 30 秒诊断预算,但保留退出码:0 表示
没有匹配发现项,1 表示发现项或错误,2 表示覆盖不完整。
此直接诊断命令和每日 Dependency Audit 保留这些
非零退出码。普通的拉取请求、推送和定时 CI 会跳过审计。
CI 仅对以 workflow_dispatch ID 开头的
full-release-validation- 或 release-native-android- 运行它;每个非零审计退出码
都会变成退出码为 0 的警告。可选的 pnpm-audit-prod pre-commit
钩子使用相同的仅警告包装器并保留审计输出。依赖项
公告不能阻止 CI、本地提交或发布。单独的发布
pnpm deps:vuln:gate 仍会阻止已知恶意软件;那里的漏洞公告
仍保持为警告。
Docs Sync 发布仓库¶
Docs Sync Publish Repo 会在 openclaw/docs 中组装英文、ClawHub 以及保留的翻译页面。在每次最终 rebase 之后、推送之前,它会使用 npm ci 安装发布者现有的 npm lock,并检查生成的文档树。推送重试会复用该安装,除非发布者 manifest 或 lock 发生变化。检查器原生运行在 Node 24 上;不会安装独立的检查器依赖图或 TypeScript loader。
一次性 Actions 验证缓存会按仓库相对路径和完整原始内容哈希记录成功的页面检查。检查器和辅助代码变更、Node/运行时变更,或请求/已安装的 npm lock 变更会使复用失效。缺失或损坏的缓存数据会触发完整检查;已删除页面会从下一次成功缓存中修剪。docs.json 每次都会检查,包括在热运行中。只有成功的主分支工作流会在发布仓库之外保存工件。检查器保留其 Markdown/MDX 格式检测、poison-text 检查和组件缩进检查;它不会替代站点渲染器或跨页面链接验证。
Docs Agent¶
Docs Agent 工作流会保持现有文档与最近已落地变更保持一致。它没有纯定时计划。已选择加入的完整 main-push CI 运行可以允许自动写入;每小时 main-tier CI 不可以。在 OPENCLAW_CI_ON_PUSH 未设置时,使用显式的非 bot Docs Agent dispatch 来运行它。一个只读作业会在允许可写入作业之前,验证规范 CI 工作流、精确的已完成运行尝试、当前 main SHA、成功的 aggregate 以及成功的 revision-confirmation 步骤。对于 main-tier 运行、仅安全推送、失败的完整 CI,以及对其他目标或缩小范围的验证,该 producer 步骤会缺失/跳过。普通 bot 推送仍被排除。
只有被允许的写入作业占用不可取消的 docs 并发槽位,因此被跳过的推送不会挤占待处理且符合条件的自动或手动工作。工作流运行调用会重新检查 main 新鲜度,并检查最多 100 个最近运行的精确尝试作业证据。排队中或活动中的写入作业,或最近实际运行了 agent 的尝试,都计入一小时节奏。已取消和已跳过的工作流、被拒绝的验证,以及完成但跳过 agent 的 writer 门控不计入。当被允许时,agent 会从上一个成功写入作业(其 agent 步骤成功)的源 SHA 审查到当前 main。
失败的 agent 尝试可能会在一小时内限制另一次尝试,但不会推进审查基线。如果无法读取历史证据,门控会在运行 agent 之前失败。
合并后重复 PR¶
Duplicate PRs After Merge 工作流是用于合并后重复清理的手动维护者工作流。它默认执行 dry-run,并且仅在 apply=true 时关闭明确列出的 PR。在修改 GitHub 之前,它会验证已落地 PR 已合并,并且每个重复 PR 要么共享一个被引用的 issue,要么存在重叠的变更 hunk。
gh workflow run duplicate-after-merge.yml \
-f landed_pr=70532 \
-f duplicate_prs='70530,70592' \
-f apply=true
更新迁移¶
Update Migration 每周日 03:17 UTC 以及手动 dispatch 时运行扩展的已发布升级基线集。它同时保留 plugin-deps-cleanup 和 legacy-operator-state,不包含 provider secrets。其独立的不可取消 schedule 组会合并待处理运行,并且不能取消手动验证。有关运行时基线解析、按基线分组、每周 78–90 runner-minute 计划额度以及成功升级要求,请参阅 包验收套件配置文件。Runner 注册预算 将每周突发与 PR 和 main 准入分开计算。
ClawSweeper 活动转发¶
.github/workflows/clawsweeper-dispatch.yml 是从 OpenClaw 仓库活动到 ClawSweeper 的目标端桥接。它不会检出或执行不受信任的 pull request 代码。该工作流使用 CLAWSWEEPER_APP_PRIVATE_KEY 创建 GitHub App token,然后向 openclaw/clawsweeper 发送紧凑的 repository_dispatch payload。
Dispatch API 调用最多重试五次速率限制失败,并使用二次退避。其他 API 错误会立即停止,重试耗尽后保留最终 API 退出码。Dispatch 调用方在失败时发出警告并继续,而不是报告成功的 dispatch。
该工作流有三个通道:
clawsweeper_item用于精确的 issue 和 pull request 审查请求;clawsweeper_comment用于 issue 评论中显式的 ClawSweeper 命令;github_activity用于 ClawSweeper agent 可能检查的一般 GitHub 活动。
github_activity 通道仅转发规范化元数据:event type、action、actor、repository、item number、URL、title、state,以及存在时的评论或审查短摘录。它有意避免转发完整 webhook body。openclaw/clawsweeper 中的接收工作流是 .github/workflows/github-activity.yml,它会将规范化事件发布到 OpenClaw Gateway hook,供 ClawSweeper agent 使用。
Main 推送仍然是 github_activity 观察。它们不会生成托管的按 commit 报告或 commit Check Runs。
一般活动是观察,而不是默认投递。ClawSweeper agent 会在其 prompt 中接收 Discord 目标,并且仅当事件令人意外、可操作、有风险或在运维上有用时,才应发布到 #clawsweeper。常规打开、编辑、bot churn、重复 webhook 噪声和正常审查流量应产生 NO_REPLY。
在整个路径中,将 GitHub 标题、评论、正文、审查文本、分支名称和 commit message 视为不受信任的数据。它们是用于摘要和分诊的输入,而不是工作流或 agent 运行时的指令。
Barnacle 将带有 bug 标签的 issue 视为验证候选,而不是不活动关闭候选。它可以添加 stale 标签,这会 dispatch 一次精确的 ClawSweeper 审查,但它不能关闭该 issue。ClawSweeper 随后可以应用有证据支持的解决;在当前 main 上已证明的修复会作为已完成关闭,而当前或结论不明确的 bug 保持打开。stale 工作流还会审计最近的关闭事件,并在 Barnacle 身份将 bug 作为 not_planned 关闭时失败。
相关¶
本页原文 Markdown:在 AtomGit 查看·内容源自开源项目 cl/openclaw