CI-конвеєр

Documentation Index

Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

Огляд pipeline

​

Порядок fail-fast

1. preflight вирішує, які лінії взагалі існують. Логіка docs-scope і changed-scope є кроками всередині цього завдання, а не окремими завданнями.
2. security-scm-fast, security-dependency-audit, security-fast, check, check-additional, check-docs і skills-python швидко падають без очікування важчих artifact і platform matrix jobs.
3. build-artifacts перекривається зі швидкими Linux lanes, щоб downstream consumers могли стартувати одразу після готовності shared build.
4. Важчі platform і runtime lanes розгортаються після цього: checks-fast-core, checks-fast-contracts-channels, checks-node-core-test, checks, checks-windows, macos-node, macos-swift і android.

​

Область і routing

• Редагування CI workflow перевіряють Node CI graph плюс workflow linting, але самі по собі не змушують запускати Windows, Android або macOS native builds; ці platform lanes залишаються обмеженими змінами platform source.
• Редагування лише CI routing, вибрані дешеві core-test fixture edits і вузькі plugin contract helper/test-routing edits використовують швидкий Node-only manifest path: preflight, security і одне завдання checks-fast-core. Цей path пропускає build artifacts, Node 22 compatibility, channel contracts, full core shards, bundled-plugin shards і additional guard matrices, коли зміна обмежена routing або helper surfaces, які fast task перевіряє напряму.
• Windows Node checks обмежені Windows-specific process/path wrappers, npm/pnpm/UI runner helpers, package manager config і CI workflow surfaces, які виконують цю lane; непов’язані source, plugin, install-smoke і test-only changes залишаються на Linux Node lanes.

​

Передавання активності ClawSweeper

• clawsweeper_item для точних запитів на review issue і pull request;
• clawsweeper_comment для явних команд ClawSweeper у коментарях issue;
• clawsweeper_commit_review для запитів commit-level review на push у main;
• github_activity для загальної GitHub activity, яку агент ClawSweeper може inspect.

​

Ручні запуски

gh workflow run ci.yml --ref release/YYYY.M.D
gh workflow run ci.yml --ref main -f target_ref=<branch-or-sha> -f include_android=true
gh workflow run full-release-validation.yml --ref main -f ref=<branch-or-sha>

​

Ранери

​

Локальні еквіваленти

pnpm changed:lanes                            # inspect the local changed-lane classifier for origin/main...HEAD
pnpm check:changed                            # smart local check gate: changed typecheck/lint/guards by boundary lane
pnpm check                                    # fast local gate: prod tsgo + sharded lint + parallel fast guards
pnpm check:test-types
pnpm check:timed                              # same gate with per-stage timings
pnpm build:strict-smoke
pnpm check:architecture
pnpm test:gateway:watch-regression
pnpm test                                     # vitest tests
pnpm test:changed                             # cheap smart changed Vitest targets
pnpm test:channels
pnpm test:contracts:channels
pnpm check:docs                               # docs format + lint + broken links
pnpm build                                    # build dist when CI artifact/build-smoke lanes matter
pnpm ci:timings                               # summarize the latest origin/main push CI run
pnpm ci:timings:recent                        # compare recent successful main CI runs
node scripts/ci-run-timings.mjs <run-id>      # summarize wall time, queue time, and slowest jobs
node scripts/ci-run-timings.mjs --latest-main # ignore issue/comment noise and choose origin/main push CI
node scripts/ci-run-timings.mjs --recent 10   # compare recent successful main CI runs
pnpm test:perf:groups --full-suite --allow-failures --output .artifacts/test-perf/baseline-before.json
pnpm test:perf:groups:compare .artifacts/test-perf/baseline-before.json .artifacts/test-perf/after-agent.json
pnpm perf:kova:summary --report .artifacts/kova/reports/mock-provider/report.json --output .artifacts/kova/summary.md

​

Продуктивність OpenClaw

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_gpt54=true
gh workflow run openclaw-performance.yml --ref main -f target_ref=v2026.5.2 -f profile=diagnostic -f repeat=3

• mock-provider: діагностичні сценарії Kova проти середовища виконання локальної збірки з детермінованою фейковою OpenAI-compatible auth.
• mock-deep-profile: CPU/heap/trace профілювання для startup, gateway і hotspots agent-turn.
• live-gpt54: реальний agent turn OpenAI openai/gpt-5.4, пропускається, коли OPENAI_API_KEY недоступний.

​

Повна валідація релізу

gh workflow run openclaw-release-publish.yml \
  --ref release/YYYY.M.D \
  -f tag=vYYYY.M.D-beta.N \
  -f preflight_run_id=<successful-openclaw-npm-preflight-run-id> \
  -f npm_dist_tag=beta

pnpm ci:full-release --sha <full-sha>

• minimum залишає найшвидші критичні для релізу лінії OpenAI/ядра.
• stable додає стабільний набір провайдерів/бекендів.
• full запускає широку консультативну матрицю провайдерів/медіа.

​

Live та E2E шарди

• native-live-src-agents
• native-live-src-gateway-core
• завдання native-live-src-gateway-profiles, відфільтровані за провайдером
• native-live-src-gateway-backends
• native-live-test
• native-live-extensions-a-k
• native-live-extensions-l-n
• native-live-extensions-openai
• native-live-extensions-o-z-other
• native-live-extensions-xai
• розділені шарди медіа для аудіо/відео та шарди музики, відфільтровані за провайдером

​

Приймання пакета

​

Завдання

1. resolve_package виконує checkout workflow_ref, визначає одного кандидата пакета, записує .artifacts/docker-e2e-package/openclaw-current.tgz, записує .artifacts/docker-e2e-package/package-candidate.json, завантажує обидва як артефакт package-under-test і виводить джерело, workflow ref, package ref, версію, SHA-256 і профіль у підсумку кроку GitHub.
2. docker_acceptance викликає openclaw-live-and-e2e-checks-reusable.yml із ref=workflow_ref і package_artifact_name=package-under-test. Повторно використовуваний workflow завантажує цей артефакт, перевіряє інвентар tarball, за потреби готує Docker-образи з дайджестом пакета й запускає вибрані Docker-лінії проти цього пакета замість пакування checkout workflow. Коли профіль вибирає кілька цільових docker_lanes, повторно використовуваний workflow готує пакет і спільні образи один раз, а потім розгалужує ці лінії як паралельні цільові Docker-завдання з унікальними артефактами.
3. package_telegram опційно викликає NPM Telegram Beta E2E. Воно запускається, коли telegram_mode не дорівнює none, і встановлює той самий артефакт package-under-test, коли приймання пакета визначило один; автономний dispatch Telegram усе ще може встановити опубліковану npm-специфікацію.
4. summary завершує workflow помилкою, якщо визначення пакета, Docker-приймання або опційна лінія Telegram зазнали збою.

​

Джерела кандидатів

• source=npm приймає лише openclaw@beta, openclaw@latest або точну релізну версію OpenClaw, як-от openclaw@2026.4.27-beta.2. Використовуйте це для приймання опублікованих попередніх/стабільних релізів.
• source=ref пакує довірену гілку, тег або повний SHA коміту package_ref. Резолвер отримує гілки/теги OpenClaw, перевіряє, що вибраний коміт досяжний з історії гілок репозиторію або релізного тегу, встановлює залежності у від’єднаному worktree і пакує його за допомогою scripts/package-openclaw-for-docker.mjs.
• source=url завантажує HTTPS .tgz; package_sha256 є обов’язковим.
• source=artifact завантажує один .tgz з artifact_run_id і artifact_name; package_sha256 є опційним, але його варто надати для артефактів, поширених зовні.

​

Профілі наборів

• smoke — npm-onboard-channel-agent, gateway-network, config-reload
• package — npm-onboard-channel-agent, doctor-switch, update-channel-switch, skill-install, update-corrupt-plugin, upgrade-survivor, published-upgrade-survivor, update-restart-auth, plugins-offline, plugin-update
• product — package плюс mcp-channels, cron-mcp-cleanup, openai-web-search-minimal, openwebui
• full — повні фрагменти релізного шляху Docker з OpenWebUI
• custom — точні docker_lanes; обов’язково, коли suite_profile=custom

​

Вікна сумісності legacy

• відомі private QA записи в dist/postinstall-inventory.json можуть указувати на файли, пропущені в tarball;
• doctor-switch може пропускати підвипадок persistence gateway install --wrapper, коли пакет не надає цей прапорець;
• update-channel-switch може обрізати відсутні pnpm patchedDependencies із fake git fixture, похідної від tarball, і може логувати відсутній persisted update.channel;
• plugin smokes можуть читати legacy розташування install-record або приймати відсутню persistence marketplace install-record;
• plugin-update може дозволяти міграцію metadata конфігурації, водночас усе ще вимагаючи, щоб install record і поведінка no-reinstall лишалися незмінними.

​

Приклади

# Validate the current beta package with product-level coverage.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=npm \
  -f package_spec=openclaw@beta \
  -f suite_profile=product \
  -f telegram_mode=mock-openai

# Pack and validate a release branch with the current harness.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=ref \
  -f package_ref=release/YYYY.M.D \
  -f suite_profile=package \
  -f telegram_mode=mock-openai

# Validate a tarball URL. SHA-256 is mandatory for source=url.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=url \
  -f package_url=https://example.com/openclaw-current.tgz \
  -f package_sha256=<64-char-sha256> \
  -f suite_profile=smoke

# Reuse a tarball uploaded by another Actions run.
gh workflow run package-acceptance.yml \
  --ref main \
  -f workflow_ref=main \
  -f source=artifact \
  -f artifact_run_id=<run-id> \
  -f artifact_name=package-under-test \
  -f suite_profile=custom \
  -f docker_lanes='install-e2e plugin-update'

​

Install smoke

• Швидкий шлях запускається для pull requests, що зачіпають поверхні Docker/package, зміни пакета/manifest вбудованого Plugin або поверхні core plugin/channel/gateway/Plugin SDK, які перевіряють Docker smoke jobs. Зміни лише source у вбудованому Plugin, edits лише тестів і docs-only edits не резервують Docker workers. Швидкий шлях один раз збирає образ root Dockerfile, перевіряє CLI, запускає agents delete shared-workspace CLI smoke, запускає container gateway-network e2e, перевіряє build arg вбудованого extension і запускає обмежений Docker profile вбудованого Plugin під 240-секундним aggregate command timeout (Docker run кожного сценарію обмежується окремо).
• Повний шлях зберігає QR package install і installer Docker/update coverage для nightly scheduled runs, manual dispatches, workflow-call release checks і pull requests, які справді зачіпають installer/package/Docker surfaces. У full mode install-smoke готує або повторно використовує один target-SHA GHCR root Dockerfile smoke image, а потім запускає QR package install, root Dockerfile/gateway smokes, installer/update smokes і fast bundled-plugin Docker E2E як окремі jobs, щоб installer work не чекав за root image smokes.

​

Локальний Docker E2E

• bare Node/Git runner для ліній installer/update/plugin-dependency;
• functional image, який встановлює той самий tarball у /app для звичайних functionality lanes.

​

Налаштовувані параметри

​

Багаторазовий live/E2E workflow

​

Чанки release-path

• OPENCLAW_DOCKER_ALL_PROFILE=release-path
• OPENCLAW_DOCKER_ALL_CHUNK=core | package-update-openai | package-update-anthropic | package-update-core | plugins-runtime-plugins | plugins-runtime-services | plugins-runtime-install-a..h

pnpm test:docker:rerun <run-id>      # download Docker artifacts and print combined/per-lane targeted rerun commands
pnpm test:docker:timings <summary>   # slow-lane and phase critical-path summaries

​

Передреліз Plugin

​

QA Lab

• Workflow QA-Lab - All Lanes запускається щоночі на main і під час ручної диспетчеризації; він розгортає mock parity-лінію, live Matrix-лінію та live Telegram і Discord-лінії як паралельні завдання. Live-завдання використовують середовище qa-live-shared, а Telegram/Discord використовують Convex leases.

​

CodeQL

​

Категорії безпеки

​

Платформоспецифічні security shards

• CodeQL Android Critical Security — запланований Android security shard. Збирає Android app вручну для CodeQL на найменшому Blacksmith Linux runner, прийнятому workflow sanity. Завантажує під /codeql-critical-security/android.
• CodeQL macOS Critical Security — щотижневий/ручний macOS security shard. Збирає macOS app вручну для CodeQL на Blacksmith macOS, фільтрує результати dependency build з uploaded SARIF і завантажує під /codeql-critical-security/macos. Залишається поза щоденними defaults, тому що macOS build домінує runtime навіть у чистому стані.

​

Категорії Critical Quality

profile=all|agent-runtime-boundary|config-boundary|core-auth-secrets|channel-runtime-boundary|gateway-runtime-boundary|memory-runtime-boundary|mcp-process-runtime-boundary|plugin-boundary|plugin-sdk-package-contract|plugin-sdk-reply-runtime|provider-runtime-boundary|session-diagnostics-boundary

​

Робочі процеси обслуговування

​

Агент документації

​

Агент продуктивності тестів

​

Дублікати PR після merge

gh workflow run duplicate-after-merge.yml \
  -f landed_pr=70532 \
  -f duplicate_prs='70530,70592' \
  -f apply=true

​

Локальні check gates і changed routing

• production-зміни core запускають typecheck core prod і core test, а також core lint/guards;
• test-only зміни core запускають лише typecheck core test плюс core lint;
• production-зміни extensions запускають typecheck extension prod і extension test плюс extension lint;
• test-only зміни extensions запускають typecheck extension test плюс extension lint;
• публічні зміни Plugin SDK або plugin-contract розширюються до typecheck extensions, бо extensions залежать від цих core-контрактів (Vitest extension sweeps лишаються явною тестовою роботою);
• version bumps лише release metadata запускають targeted version/config/root-dependency checks;
• невідомі root/config зміни fail safe до всіх check lanes.

​

Валідація Testbox

pnpm crabbox:run -- --help | sed -n '1,120p'

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "env CI=1 NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm check:changed"

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "env CI=1 NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm test <path-or-filter>"

pnpm crabbox:run -- --provider blacksmith-testbox \
  --blacksmith-org openclaw \
  --blacksmith-workflow .github/workflows/ci-check-testbox.yml \
  --blacksmith-job check \
  --blacksmith-ref main \
  --idle-timeout 90m \
  --ttl 240m \
  --timing-json \
  --shell -- \
  "env CI=1 NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm test"

blacksmith testbox list --all
blacksmith testbox status --id <tbx_id>
blacksmith testbox stop --id <tbx_id>

pnpm crabbox:run -- --provider blacksmith-testbox --id <tbx_id> --no-sync --timing-json --shell -- "pnpm test <path-or-filter>"
pnpm crabbox:stop -- <tbx_id>

CRABBOX_CAPACITY_REGIONS=eu-west-1,eu-west-2,eu-central-1,us-east-1,us-west-2 \
  pnpm crabbox:warmup -- --provider aws --class standard --market on-demand --idle-timeout 90m
pnpm crabbox:hydrate -- --id <cbx_id-or-slug>
pnpm crabbox:run -- --id <cbx_id-or-slug> --timing-json --shell -- "env NODE_OPTIONS=--max-old-space-size=4096 OPENCLAW_TEST_PROJECTS_PARALLEL=6 OPENCLAW_VITEST_MAX_WORKERS=1 OPENCLAW_VITEST_NO_OUTPUT_TIMEOUT_MS=900000 pnpm check:changed"
pnpm crabbox:stop -- <cbx_id-or-slug>

​

Пов’язане

• Огляд встановлення
• Канали розробки