Testler

• Tam test kiti (paketler, canlı, Docker): Test

• Güncelleme ve Plugin paketi doğrulaması: Güncellemeleri ve Pluginleri test etme

• Rutin yerel test sırası:

  1. Değişiklik kapsamlı Vitest kanıtı için pnpm test:changed.
  2. Tek dosya, dizin veya açık hedef için pnpm test <path-or-filter>.
  3. Yalnızca tam yerel Vitest paketine bilerek ihtiyaç duyduğunuzda pnpm test.

• pnpm test:force: Varsayılan kontrol portunu tutan kalmış Gateway işlemlerini sonlandırır, ardından çalışan bir örnekle sunucu testleri çakışmasın diye tam Vitest paketini yalıtılmış bir Gateway portuyla çalıştırır. Önceki bir Gateway çalıştırması 18789 portunu dolu bıraktığında bunu kullanın.

• pnpm test:coverage: Birim paketini V8 kapsamıyla (vitest.unit.config.ts üzerinden) çalıştırır. Bu, tüm repo tüm dosya kapsamı değil, varsayılan birim hattı kapsam kapısıdır. Eşikler satırlar/fonksiyonlar/ifadeler için %70 ve dallar için %55'tir. coverage.all false olduğundan ve varsayılan hat, kapsam içeriklerini kardeş kaynak dosyaları olan hızlı olmayan birim testleriyle sınırlandırdığından, kapı rastlantısal olarak yüklediği her geçişli import yerine bu hattın sahip olduğu kaynağı ölçer.

• pnpm test:coverage:changed: Birim kapsamını yalnızca origin/main sonrasında değişen dosyalar için çalıştırır.

• pnpm test:changed: ucuz akıllı değişiklik testi çalıştırması. Doğrudan test düzenlemelerinden, kardeş *.test.ts dosyalarından, açık kaynak eşlemelerinden ve yerel import grafiğinden kesin hedefleri çalıştırır. Geniş/config/paket değişiklikleri, kesin testlere eşlenmedikçe atlanır.

• OPENCLAW_TEST_CHANGED_BROAD=1 pnpm test:changed: açık geniş değişiklik testi çalıştırması. Bir test harness/config/paket düzenlemesi Vitest'in daha geniş değişiklik testi davranışına geri düşmeliyse bunu kullanın.

• pnpm changed:lanes: origin/main karşısındaki diff tarafından tetiklenen mimari hatları gösterir.

• pnpm check:changed: CI dışında varsayılan olarak Crabbox/Testbox'a devreder, ardından uzak çocuk içinde origin/main karşısındaki diff için akıllı değişiklik kontrol kapısını çalıştırır. Etkilenen mimari hatlar için typecheck, lint ve guard komutlarını çalıştırır, ancak Vitest testlerini çalıştırmaz. Test kanıtı için pnpm test:changed veya açık pnpm test <target> kullanın.

• Codex worktree'leri ve bağlı/sparse checkout'lar: pnpm'in bağımlılıkları uzlaştırmayacağını doğrulamadığınız sürece doğrudan yerel pnpm test*, pnpm check* ve pnpm crabbox:run komutlarından kaçının. Çok küçük açık dosya kanıtı için node scripts/run-vitest.mjs <path-or-filter> kullanın; değişiklik kapıları veya geniş kanıt için pnpm'in Testbox içinde çalışması amacıyla node scripts/crabbox-wrapper.mjs run --provider blacksmith-testbox ... -- env OPENCLAW_CHECK_CHANGED_REMOTE_CHILD=1 OPENCLAW_CHANGED_LANES_RAW_SYNC=1 corepack pnpm check:changed kullanın.

• Testbox-through-Crabbox kanıtı: komut sonucu olarak wrapper'ın son exitCode değerini ve zamanlama JSON'unu kullanın. Yetkilendirilen Blacksmith GitHub Actions çalıştırması, başarılı bir SSH komutundan sonra cancelled gösterebilir çünkü Testbox keepalive action dışından durdurulur; bunu test hatası saymadan önce wrapper özetini ve komut çıktısını doğrulayın.

• OPENCLAW_HEAVY_CHECK_LOCK_SCOPE=worktree <local-heavy-check command>: pnpm check:changed ve hedefli pnpm test ... gibi komutlarda heavy-check serileştirmesini Git ortak dizini yerine geçerli worktree içinde tutar. Bunu yalnızca yüksek kapasiteli yerel hostlarda, bağlı worktree'ler arasında bağımsız kontrolleri bilerek çalıştırdığınızda kullanın.

• pnpm test: açık dosya/dizin hedeflerini kapsamlı Vitest hatları üzerinden yönlendirir. Hedefsiz çalıştırmalar tam paket kanıtıdır: sabit shard grupları kullanır, yerel paralel yürütme için leaf config'lere genişler ve başlamadan önce beklenen yerel shard fanout'unu yazdırır. Extension grubu her zaman tek dev bir root-project işlemi yerine extension başına shard config'lerine genişler.

• Test wrapper çalıştırmaları kısa bir [test] passed|failed|skipped ... in ... özetiyle biter. Vitest'in kendi süre satırı shard başına ayrıntı olarak kalır.

• Paylaşılan OpenClaw test durumu: Bir test yalıtılmış HOME, OPENCLAW_STATE_DIR, OPENCLAW_CONFIG_PATH, config fixture, workspace, ajan dizini veya auth-profile deposuna ihtiyaç duyduğunda Vitest'ten src/test-utils/openclaw-test-state.ts kullanın.

• pnpm test:env-mutations:report: HOME, OPENCLAW_STATE_DIR, OPENCLAW_CONFIG_PATH, OPENCLAW_WORKSPACE_DIR veya ilgili OpenClaw env anahtarlarını doğrudan değiştiren testler ve harness'ler hakkında engellemeyen rapor. Paylaşılan test-state yardımcısına taşınacak adayları bulmak için kullanın.

• Control UI mocked E2E: Vite Control UI'yi başlatan ve mocked Gateway WebSocket'e karşı gerçek bir Chromium sayfasını süren Vitest + Playwright hattı için pnpm test:ui:e2e kullanın. Testler ui/src/**/*.e2e.test.ts içinde bulunur; paylaşılan mock'lar ve kontroller ui/src/test-helpers/control-ui-e2e.ts içinde bulunur. pnpm test:e2e bu hattı içerir. Codex worktree'lerinde, bağımlılıklar yüklendikten sonra çok küçük hedefli kanıt için node scripts/run-vitest.mjs run --config test/vitest/vitest.ui-e2e.config.ts --configLoader runner ui/src/ui/e2e/chat-flow.e2e.test.ts, daha geniş GUI kanıtı için Testbox/Crabbox tercih edin.

• İşlem E2E yardımcıları: Vitest işlem düzeyi E2E testi tek yerde çalışan bir Gateway, CLI env, log yakalama ve temizliğe ihtiyaç duyduğunda test/helpers/openclaw-test-instance.ts kullanın.

• TUI PTY testleri: hızlı fake-backend PTY hattı için node scripts/run-vitest.mjs run --config test/vitest/vitest.tui-pty.config.ts kullanın. Yalnızca harici model endpoint'ini mock'layan daha yavaş tui --local smoke için OPENCLAW_TUI_PTY_INCLUDE_LOCAL=1 veya pnpm tui:pty:test:watch --mode local kullanın. Ham ANSI snapshot'ları değil, kararlı görünen metni veya fixture çağrılarını assert edin.

• Docker/Bash E2E yardımcıları: scripts/lib/docker-e2e-image.sh kaynaklayan hatlar, container'a docker_e2e_test_state_shell_b64 <label> <scenario> geçirebilir ve bunu scripts/lib/openclaw-e2e-instance.sh ile decode edebilir; çok evli betikler docker_e2e_test_state_function_b64 geçirebilir ve her flow içinde openclaw_test_state_create <label> <scenario> çağırabilir. Daha düşük düzey çağırıcılar container içi shell snippet'i için scripts/lib/openclaw-test-state.mjs shell --label <name> --scenario <name> veya source edilebilir host env dosyası için node scripts/lib/openclaw-test-state.mjs -- create --label <name> --scenario <name> --env-file <path> --json kullanabilir. create öncesindeki --, daha yeni Node runtime'larının --env-file değerini Node flag'i olarak değerlendirmesini engeller. Gateway başlatan Docker/Bash hatları entrypoint çözümleme, mock OpenAI başlangıcı, Gateway foreground/background başlatma, readiness probe'ları, state env dışa aktarma, log dökümleri ve işlem temizliği için container içinde scripts/lib/openclaw-e2e-instance.sh kaynaklayabilir.

• Tam, extension ve include-pattern shard çalıştırmaları yerel zamanlama verilerini .artifacts/vitest-shard-timings.json içinde günceller; sonraki whole-config çalıştırmaları yavaş ve hızlı shard'ları dengelemek için bu zamanlamaları kullanır. Include-pattern CI shard'ları shard adını zamanlama anahtarına ekler; bu, filtrelenmiş shard zamanlamalarını whole-config zamanlama verisini değiştirmeden görünür tutar. Yerel zamanlama artefaktını yok saymak için OPENCLAW_TEST_PROJECTS_TIMINGS=0 ayarlayın.

• Seçili plugin-sdk ve commands test dosyaları artık yalnızca test/setup.ts tutan özel hafif hatlardan yönlendirilir; runtime ağırlıklı durumlar mevcut hatlarında kalır.

• Kardeş testleri olan kaynak dosyaları, daha geniş dizin glob'larına geri düşmeden önce o kardeşe eşlenir. src/channels/plugins/contracts/test-helpers, src/plugin-sdk/test-helpers ve src/plugins/contracts altındaki yardımcı düzenlemeleri, dependency yolu kesin olduğunda her shard'ı geniş çalıştırmak yerine import eden testleri çalıştırmak için yerel import grafiği kullanır.

• auto-reply artık üç özel config'e (core, top-level, reply) de ayrılır; böylece reply harness daha hafif top-level status/token/helper testlerine baskın gelmez.

• Temel Vitest config artık repo config'leri genelinde etkin olan paylaşılan yalıtılmamış runner ile birlikte varsayılan olarak pool: "threads" ve isolate: false kullanır.

• pnpm test:channels, vitest.channels.config.ts çalıştırır.

• pnpm test:extensions ve pnpm test extensions, tüm extension/Plugin shard'larını çalıştırır. Ağır kanal Plugin'leri, browser Plugin'i ve OpenAI özel shard'lar olarak çalışır; diğer Plugin grupları toplu kalır. Tek bir paketlenmiş Plugin hattı için pnpm test extensions/<id> kullanın.

• pnpm test:perf:imports: açık dosya/dizin hedefleri için kapsamlı hat yönlendirmesini kullanmaya devam ederken Vitest import süresi + import dökümü raporlamasını etkinleştirir.

• pnpm test:perf:imports:changed: aynı import profillemesi, ancak yalnızca origin/main sonrasında değişen dosyalar için.

• pnpm test:perf:changed:bench -- --ref <git-ref>, yönlendirilmiş changed-mode yolunu aynı commit'lenmiş git diff için native root-project çalıştırmasına karşı benchmark eder.

• pnpm test:perf:changed:bench -- --worktree, önce commit etmeden geçerli worktree değişiklik kümesini benchmark eder.

• pnpm test:perf:profile:main: Vitest ana thread'i için CPU profili yazar (.artifacts/vitest-main-profile).

• pnpm test:perf:profile:runner: birim runner için CPU + heap profilleri yazar (.artifacts/vitest-runner-profile).

• pnpm test:perf:groups --full-suite --allow-failures --output .artifacts/test-perf/baseline-before.json: her full-suite Vitest leaf config'i seri olarak çalıştırır ve gruplanmış süre verilerinin yanı sıra config başına JSON/log artefaktları yazar. Test Performance Agent bunu yavaş test düzeltmelerini denemeden önce baseline olarak kullanır.

• pnpm test:perf:groups:compare .artifacts/test-perf/baseline-before.json .artifacts/test-perf/after-agent.json: performans odaklı bir değişiklikten sonra gruplanmış raporları karşılaştırır.

• pnpm test:docker:timings <summary.json>, bir Docker all çalıştırmasından sonra yavaş Docker hatlarını inceler; aynı artefaktlardan ucuz hedefli yeniden çalıştırma komutlarını yazdırmak için pnpm test:docker:rerun <run-id|summary.json|failures.json> kullanın.

• Gateway entegrasyonu: OPENCLAW_TEST_INCLUDE_GATEWAY=1 pnpm test veya pnpm test:gateway ile opt-in.

• pnpm test:e2e: Repo E2E toplamını çalıştırır: gateway uçtan uca smoke testleri ve Control UI mocked browser E2E hattı.

• pnpm test:e2e:gateway: Gateway uçtan uca smoke testlerini çalıştırır (çoklu örnek WS/HTTP/node eşleştirmesi). vitest.e2e.config.ts içinde uyarlamalı worker'larla varsayılan olarak threads + isolate: false kullanır; OPENCLAW_E2E_WORKERS=<n> ile ayarlayın ve ayrıntılı loglar için OPENCLAW_E2E_VERBOSE=1 ayarlayın.

• pnpm test:live: Sağlayıcı live testlerini (minimax/zai) çalıştırır. Atlamayı kaldırmak için API anahtarları ve LIVE=1 (veya sağlayıcıya özel *_LIVE_TEST=1) gerekir.

• pnpm test:docker:all: Paylaşılan canlı test imajını derler, OpenClaw'ı bir kez npm tarball'ı olarak paketler, yalın bir Node/Git çalıştırıcı imajı ile bu tarball'ı /app içine yükleyen işlevsel bir imajı derler/yeniden kullanır, ardından ağırlıklı bir zamanlayıcı üzerinden OPENCLAW_SKIP_DOCKER_BUILD=1 ile Docker smoke kulvarlarını çalıştırır. Yalın imaj (OPENCLAW_DOCKER_E2E_BARE_IMAGE) yükleyici/güncelleme/Plugin bağımlılığı kulvarları için kullanılır; bu kulvarlar kopyalanmış depo kaynakları kullanmak yerine önceden derlenmiş tarball'ı bağlar. İşlevsel imaj (OPENCLAW_DOCKER_E2E_FUNCTIONAL_IMAGE) normal derlenmiş uygulama işlevselliği kulvarları için kullanılır. scripts/package-openclaw-for-docker.mjs, tek yerel/CI paket paketleyicisidir ve Docker tüketmeden önce tarball'ı ve dist/postinstall-inventory.json dosyasını doğrular. Docker kulvar tanımları scripts/lib/docker-e2e-scenarios.mjs içinde bulunur; planlayıcı mantığı scripts/lib/docker-e2e-plan.mjs içinde bulunur; scripts/test-docker-all.mjs seçilen planı yürütür. node scripts/test-docker-all.mjs --plan-json, derleme yapmadan veya Docker çalıştırmadan seçilen kulvarlar, imaj türleri, paket/canlı imaj ihtiyaçları, durum senaryoları ve kimlik bilgisi kontrolleri için zamanlayıcıya ait CI planını üretir. OPENCLAW_DOCKER_ALL_PARALLELISM=<n> süreç yuvalarını kontrol eder ve varsayılanı 10'dur; OPENCLAW_DOCKER_ALL_TAIL_PARALLELISM=<n> sağlayıcıya duyarlı kuyruk havuzunu kontrol eder ve varsayılanı 10'dur. Ağır kulvar sınırları varsayılan olarak OPENCLAW_DOCKER_ALL_LIVE_LIMIT=9, OPENCLAW_DOCKER_ALL_NPM_LIMIT=5 ve OPENCLAW_DOCKER_ALL_SERVICE_LIMIT=7 olur; sağlayıcı sınırları varsayılan olarak OPENCLAW_DOCKER_ALL_LIVE_CLAUDE_LIMIT=4, OPENCLAW_DOCKER_ALL_LIVE_CODEX_LIMIT=4 ve OPENCLAW_DOCKER_ALL_LIVE_GEMINI_LIMIT=4 üzerinden sağlayıcı başına bir ağır kulvar olur. Daha büyük ana makineler için OPENCLAW_DOCKER_ALL_WEIGHT_LIMIT veya OPENCLAW_DOCKER_ALL_DOCKER_LIMIT kullanın. Düşük paralellikli bir ana makinede bir kulvar etkili ağırlık veya kaynak sınırını aşarsa yine de boş bir havuzdan başlayabilir ve kapasiteyi serbest bırakana kadar tek başına çalışır. Yerel Docker daemon oluşturma fırtınalarından kaçınmak için kulvar başlangıçları varsayılan olarak 2 saniye aralıklandırılır; OPENCLAW_DOCKER_ALL_START_STAGGER_MS=<ms> ile geçersiz kılın. Çalıştırıcı varsayılan olarak Docker ön kontrollerini yapar, eski OpenClaw E2E konteynerlerini temizler, her 30 saniyede etkin kulvar durumunu üretir, uyumlu kulvarlar arasında sağlayıcı CLI araç önbelleklerini paylaşır, geçici canlı sağlayıcı hatalarını varsayılan olarak bir kez yeniden dener (OPENCLAW_DOCKER_ALL_LIVE_RETRIES=<n>) ve sonraki çalıştırmalarda en uzundan ilk sıraya dizim için kulvar sürelerini .artifacts/docker-tests/lane-timings.json içinde saklar. Docker çalıştırmadan kulvar manifestini yazdırmak için OPENCLAW_DOCKER_ALL_DRY_RUN=1, durum çıktısını ayarlamak için OPENCLAW_DOCKER_ALL_STATUS_INTERVAL_MS=<ms> veya süre yeniden kullanımını devre dışı bırakmak için OPENCLAW_DOCKER_ALL_TIMINGS=0 kullanın. Yalnızca deterministik/yerel kulvarlar için OPENCLAW_DOCKER_ALL_LIVE_MODE=skip veya yalnızca canlı sağlayıcı kulvarları için OPENCLAW_DOCKER_ALL_LIVE_MODE=only kullanın; paket diğer adları pnpm test:docker:local:all ve pnpm test:docker:live:all şeklindedir. Yalnızca canlı modu, sağlayıcı kovalarının Claude, Codex ve Gemini işlerini birlikte paketleyebilmesi için ana ve kuyruk canlı kulvarlarını en uzundan ilk sıraya tek bir havuzda birleştirir. Çalıştırıcı, OPENCLAW_DOCKER_ALL_FAIL_FAST=0 ayarlanmadığı sürece ilk hatadan sonra yeni havuzlanmış kulvarları zamanlamayı durdurur ve her kulvarın OPENCLAW_DOCKER_ALL_LANE_TIMEOUT_MS ile geçersiz kılınabilen 120 dakikalık yedek zaman aşımı vardır; seçili canlı/kuyruk kulvarları daha sıkı kulvar başına sınırlar kullanır. CLI arka uç Docker kurulum komutlarının OPENCLAW_LIVE_CLI_BACKEND_SETUP_TIMEOUT_SECONDS (varsayılan 180) üzerinden kendi zaman aşımı vardır. Kulvar başına günlükler, summary.json, failures.json ve aşama süreleri .artifacts/docker-tests/<run-id>/ altına yazılır; yavaş kulvarları incelemek için pnpm test:docker:timings <summary.json> ve ucuz hedefli yeniden çalıştırma komutlarını yazdırmak için pnpm test:docker:rerun <run-id|summary.json|failures.json> kullanın.

• pnpm test:docker:browser-cdp-snapshot: Chromium destekli bir kaynak E2E konteyneri derler, ham CDP ile yalıtılmış bir Gateway başlatır, browser doctor --deep çalıştırır ve CDP rol anlık görüntülerinin bağlantı URL'leri, imleçle öne çıkarılmış tıklanabilir öğeler, iframe başvuruları ve çerçeve üst verileri içerdiğini doğrular.

• pnpm test:docker:skill-install: Paketlenmiş OpenClaw tarball'ını yalın bir Docker çalıştırıcısına yükler, skills.install.allowUploadedArchives ayarını devre dışı bırakır, canlı ClawHub aramasından güncel bir Skills slug'ı çözer, bunu openclaw skills install üzerinden yükler ve SKILL.md, .clawhub/origin.json, .clawhub/lock.json ile skills info --json çıktısını doğrular.

• CLI arka uç canlı Docker yoklamaları odaklanmış kulvarlar olarak çalıştırılabilir; örneğin pnpm test:docker:live-cli-backend:claude, pnpm test:docker:live-cli-backend:claude:resume veya pnpm test:docker:live-cli-backend:claude:mcp. Gemini için eşleşen :resume ve :mcp diğer adları vardır.

• pnpm test:docker:openwebui: Docker içinde OpenClaw + Open WebUI başlatır, Open WebUI üzerinden oturum açar, /api/models kontrol eder, ardından /api/chat/completions üzerinden gerçek bir vekilli sohbet çalıştırır. Kullanılabilir bir canlı model anahtarı gerektirir, harici bir Open WebUI imajı çeker ve normal unit/e2e paketleri gibi CI'da kararlı olması beklenmez.

• pnpm test:docker:mcp-channels: Önceden tohumlanmış bir Gateway konteyneri ve openclaw mcp serve başlatan ikinci bir istemci konteyneri başlatır; ardından yönlendirilmiş konuşma keşfini, transkript okumalarını, ek üst verilerini, canlı olay kuyruğu davranışını, giden gönderim yönlendirmesini ve gerçek stdio köprüsü üzerinden Claude tarzı kanal + izin bildirimlerini doğrular. Claude bildirimi doğrulaması, smoke testin köprünün gerçekten ne ürettiğini yansıtması için ham stdio MCP çerçevelerini doğrudan okur.

• pnpm test:docker:upgrade-survivor: Paketlenmiş OpenClaw tarball'ını kirli bir eski kullanıcı fixture'ı üzerine yükler, canlı sağlayıcı veya kanal anahtarları olmadan paket güncellemesini ve etkileşimsiz doctor'ı çalıştırır, ardından bir local loopback Gateway başlatır ve agent'ların, kanal yapılandırmasının, Plugin izin listelerinin, çalışma alanı/oturum dosyalarının, eski miras Plugin bağımlılığı durumunun, başlatmanın ve RPC durumunun korunduğunu denetler.

• pnpm test:docker:published-upgrade-survivor: Varsayılan olarak openclaw@latest yükler, canlı sağlayıcı veya kanal anahtarları olmadan gerçekçi mevcut kullanıcı dosyaları tohumlar, bu taban çizgisini gömülü bir openclaw config set komut tarifiyle yapılandırır, yayımlanmış bu kurulumu paketlenmiş OpenClaw tarball'ına günceller, etkileşimsiz doctor çalıştırır, .artifacts/upgrade-survivor/summary.json yazar, ardından bir local loopback Gateway başlatır ve yapılandırılmış amaçların, çalışma alanı/oturum dosyalarının, eski Plugin yapılandırmasının ve miras bağımlılık durumunun, başlatmanın, /healthz, /readyz ve RPC durumunun korunduğunu veya temiz biçimde onarıldığını denetler. Tek bir taban çizgisini OPENCLAW_UPGRADE_SURVIVOR_BASELINE_SPEC ile geçersiz kılın, openclaw@2026.5.2 openclaw@2026.4.23 openclaw@2026.4.15 gibi OPENCLAW_UPGRADE_SURVIVOR_BASELINE_SPECS ile tam bir yerel matrisi genişletin veya OPENCLAW_UPGRADE_SURVIVOR_SCENARIOS=reported-issues ile senaryo fixture'ları ekleyin; bildirilen sorunlar kümesi, yapılandırılmış harici OpenClaw Plugin'lerinin yükseltme sırasında otomatik olarak yüklendiğini doğrulamak için configured-plugin-installs ve yalnızca kaynak Plugin gölgelerinin başlatmayı bozmasını önlemek için stale-source-plugin-shadow içerir. Package Acceptance bunları published_upgrade_survivor_baseline, published_upgrade_survivor_baselines ve published_upgrade_survivor_scenarios olarak sunar ve tam paket belirtimlerini Docker kulvarlarına teslim etmeden önce last-stable-4 veya all-since-2026.4.23 gibi meta taban çizgisi belirteçlerini çözer.

• pnpm test:docker:update-migration: Published-upgrade survivor harness'ını, varsayılan olarak openclaw@2026.4.23 noktasından başlayarak temizlik ağırlıklı plugin-deps-cleanup senaryosunda çalıştırır. Ayrı Update Migration workflow'u bu kulvarı baselines=all-since-2026.4.23 ile genişletir; böylece .23 ve sonrasındaki yayımlanmış her kararlı paket adaya güncellenir ve Full Release CI dışında yapılandırılmış Plugin bağımlılığı temizliğini kanıtlar.

• pnpm test:docker:plugins: Yerel yol, file:, yükseltilmiş bağımlılıkları olan npm registry paketleri, git hareketli başvuruları, ClawHub fixture'ları, marketplace güncellemeleri ve Claude paketini etkinleştirme/inceleme için yükleme/güncelleme smoke testlerini çalıştırır.

Yerel PR kapısı

Yerel PR land/gate kontrolleri için şunu çalıştırın:

• pnpm check:changed
• pnpm check
• pnpm check:test-types
• pnpm build
• pnpm test
• pnpm check:docs

pnpm test yüklü bir host üzerinde aralıklı hata verirse, bunu regresyon olarak ele almadan önce bir kez yeniden çalıştırın, ardından pnpm test <path/to/test> ile izole edin. Bellek kısıtlı hostlar için şunu kullanın:

• OPENCLAW_VITEST_MAX_WORKERS=1 pnpm test
• OPENCLAW_VITEST_FS_MODULE_CACHE_PATH=/tmp/openclaw-vitest-cache pnpm test:changed

Model gecikme benchmark'ı (yerel anahtarlar)

Betik: scripts/bench-model.ts

Kullanım:

• pnpm tsx scripts/bench-model.ts --runs 10
• İsteğe bağlı env: MINIMAX_API_KEY, MINIMAX_BASE_URL, MINIMAX_MODEL, ANTHROPIC_API_KEY
• Varsayılan prompt: "Reply with a single word: ok. No punctuation or extra text."

Son çalıştırma (2025-12-31, 20 çalıştırma):

• minimax medyan 1279ms (min 1114, maks 2431)
• opus medyan 2454ms (min 1224, maks 3170)

CLI başlangıç benchmark'ı

Betik: scripts/bench-cli-startup.ts

Kullanım:

• pnpm test:startup:bench
• pnpm test:startup:bench:smoke
• pnpm test:startup:bench:save
• pnpm test:startup:bench:update
• pnpm test:startup:bench:check
• pnpm tsx scripts/bench-cli-startup.ts
• pnpm tsx scripts/bench-cli-startup.ts --runs 12
• pnpm tsx scripts/bench-cli-startup.ts --preset real
• pnpm tsx scripts/bench-cli-startup.ts --preset real --case status --case gatewayStatus --runs 3
• pnpm tsx scripts/bench-cli-startup.ts --preset real --case tasksJson --case tasksListJson --case tasksAuditJson --runs 3
• pnpm tsx scripts/bench-cli-startup.ts --entry openclaw.mjs --entry-secondary dist/entry.js --preset all
• pnpm tsx scripts/bench-cli-startup.ts --preset all --output .artifacts/cli-startup-bench-all.json
• pnpm tsx scripts/bench-cli-startup.ts --preset real --case gatewayStatusJson --output .artifacts/cli-startup-bench-smoke.json
• pnpm tsx scripts/bench-cli-startup.ts --preset real --cpu-prof-dir .artifacts/cli-cpu
• pnpm tsx scripts/bench-cli-startup.ts --json

Ön ayarlar:

• startup: --version, --help, health, health --json, status --json, status
• real: health, status, status --json, sessions, sessions --json, tasks --json, tasks list --json, tasks audit --json, agents list --json, gateway status, gateway status --json, gateway health --json, config get gateway.port
• all: iki ön ayarın ikisi de

Çıktı her komut için sampleCount, ortalama, p50, p95, min/maks, exit-code/sinyal dağılımı ve maks RSS özetlerini içerir. İsteğe bağlı --cpu-prof-dir / --heap-prof-dir, zamanlama ve profil yakalama aynı harness'i kullansın diye her çalıştırma için V8 profilleri yazar.

Kaydedilmiş çıktı konvansiyonları:

• pnpm test:startup:bench:smoke, hedeflenen smoke yapıtını .artifacts/cli-startup-bench-smoke.json konumuna yazar
• pnpm test:startup:bench:save, runs=5 ve warmup=1 kullanarak tam paket yapıtını .artifacts/cli-startup-bench-all.json konumuna yazar
• pnpm test:startup:bench:update, runs=5 ve warmup=1 kullanarak depoya işlenmiş baseline fixture'ını test/fixtures/cli-startup-bench.json konumunda yeniler

Depoya işlenmiş fixture:

• test/fixtures/cli-startup-bench.json
• pnpm test:startup:bench:update ile yenileyin
• Güncel sonuçları fixture ile pnpm test:startup:bench:check kullanarak karşılaştırın

Gateway başlangıç benchmark'ı

Betik: scripts/bench-gateway-startup.ts

Benchmark varsayılan olarak dist/entry.js konumundaki derlenmiş CLI girişini kullanır; package-script komutlarını kullanmadan önce pnpm build çalıştırın. Bunun yerine kaynak runner'ı ölçmek için --entry scripts/run-node.mjs geçin ve bu sonuçları derlenmiş giriş baseline'larından ayrı tutun.

Kullanım:

• pnpm test:startup:gateway -- --runs 5 --warmup 1
• pnpm test:startup:gateway -- --case default --runs 10 --warmup 1
• pnpm test:startup:gateway -- --case skipChannels --case fiftyPlugins --runs 5
• node --import tsx scripts/bench-gateway-startup.ts --case default --runs 5 --output .artifacts/gateway-startup.json
• node --import tsx scripts/bench-gateway-startup.ts --case default --runs 3 --cpu-prof-dir .artifacts/gateway-startup-cpu

Case kimlikleri:

• default: normal Gateway başlangıcı.
• skipChannels: kanal başlangıcı atlanmış Gateway başlangıcı.
• oneInternalHook: yapılandırılmış bir internal hook.
• allInternalHooks: tüm internal hook'lar.
• fiftyPlugins: 50 manifest plugin'i.
• fiftyStartupLazyPlugins: 50 startup-lazy manifest plugin'i.

Çıktı ilk süreç çıktısını, /healthz, /readyz, HTTP dinleme log zamanını, Gateway hazır log zamanını, CPU zamanını, CPU çekirdek oranını, maks RSS'i, heap'i, başlangıç izleme metriklerini, event-loop gecikmesini ve Plugin arama tablosu ayrıntı metriklerini içerir. Betik, alt Gateway ortamında OPENCLAW_GATEWAY_STARTUP_TRACE=1 etkinleştirir.

/healthz değerini liveness olarak okuyun: HTTP sunucusu yanıt verebilir. /readyz değerini kullanılabilir readiness olarak okuyun: başlangıç Plugin sidecar'ları, kanallar ve ready-critical post-attach işi tamamlanmıştır. Gateway başlangıç hook'ları asenkron gönderilir ve readiness garantisinin parçası değildir. Hazır log zamanı, Gateway'in dahili hazır log zaman damgasıdır; süreç tarafı ilişkilendirme için yararlıdır ancak harici /readyz probe'unun yerine geçmez.

Değişiklikleri karşılaştırırken JSON çıktısı veya --output kullanın. --cpu-prof-dir seçeneğini yalnızca izleme çıktısı import, compile veya yalnızca faz zamanlamalarıyla açıklanamayan CPU-bound işe işaret ettikten sonra kullanın. Kaynak runner sonuçlarını derlenmiş dist/entry.js sonuçlarıyla aynı baseline olarak karşılaştırmayın.

Gateway yeniden başlatma benchmark'ı

Betik: scripts/bench-gateway-restart.ts

Yeniden başlatma benchmark'ı yalnızca macOS ve Linux üzerinde desteklenir. Süreç içi yeniden başlatmalar için SIGUSR1 kullanır ve Windows üzerinde hemen başarısız olur.

Benchmark varsayılan olarak dist/entry.js konumundaki derlenmiş CLI girişini kullanır; package-script komutlarını kullanmadan önce pnpm build çalıştırın. Bunun yerine kaynak runner'ı ölçmek için --entry scripts/run-node.mjs geçin ve bu sonuçları derlenmiş giriş baseline'larından ayrı tutun.

Kullanım:

• pnpm test:restart:gateway -- --case skipChannels --runs 1 --restarts 5
• pnpm test:restart:gateway -- --case default --runs 3 --restarts 3 --warmup 1
• pnpm test:restart:gateway -- --case skipChannelsAcpxProbe --case skipChannelsNoAcpxProbe --runs 1 --restarts 5
• node --import tsx scripts/bench-gateway-restart.ts --case fiftyPlugins --runs 1 --restarts 5 --output .artifacts/gateway-restart.json
• node --import tsx scripts/bench-gateway-restart.ts --json

Case kimlikleri:

• skipChannels: kanallar atlanmış yeniden başlatma.
• skipChannelsAcpxProbe: kanallar atlanmış ve ACPX başlangıç probe'u açık yeniden başlatma.
• skipChannelsNoAcpxProbe: kanallar atlanmış ve ACPX başlangıç probe'u kapalı yeniden başlatma.
• default: normal yeniden başlatma.
• fiftyPlugins: 50 manifest plugin'iyle yeniden başlatma.

Çıktı bir sonraki /healthz, bir sonraki /readyz, kesinti süresi, yeniden başlatma hazır zamanlaması, CPU, RSS, replacement süreç için başlangıç izleme metrikleri ve sinyal işleme, aktif iş boşaltma, kapatma fazları, bir sonraki başlangıç, hazır zamanlaması ve bellek anlık görüntüleri için yeniden başlatma izleme metriklerini içerir. Betik, alt Gateway ortamında OPENCLAW_GATEWAY_STARTUP_TRACE=1 ve OPENCLAW_GATEWAY_RESTART_TRACE=1 etkinleştirir.

Bir değişiklik yeniden başlatma sinyallemesini, kapatma handler'larını, startup-after-restart, sidecar kapatmayı, servis devrini veya yeniden başlatma sonrası readiness'i etkilediğinde bu benchmark'ı kullanın. Gateway mekaniklerini kanal başlangıcından izole ederken skipChannels ile başlayın. default veya Plugin ağırlıklı case'leri yalnızca dar case yeniden başlatma yolunu açıkladıktan sonra kullanın.

İzleme metrikleri ilişkilendirme ipuçlarıdır, hüküm değildir. Bir yeniden başlatma değişikliği birden fazla örnekten, eşleşen sahip span'inden, /healthz ve /readyz davranışından ve kullanıcıya görünür yeniden başlatma sözleşmesinden değerlendirilmelidir.

Onboarding E2E (Docker)

Docker isteğe bağlıdır; bu yalnızca containerized onboarding smoke testleri için gereklidir.

Temiz bir Linux container'ında tam cold-start akışı:

scripts/e2e/onboard-docker.sh

Bu betik etkileşimli wizard'ı bir pseudo-tty üzerinden yürütür, config/workspace/session dosyalarını doğrular, ardından gateway'i başlatır ve openclaw health çalıştırır.

QR import smoke (Docker)

Bakımı yapılan QR runtime helper'ının desteklenen Docker Node runtime'ları altında yüklendiğinden emin olur (varsayılan Node 24, uyumlu Node 22):

pnpm test:docker:qr

İlgili

• Test Etme
• Canlı test etme
• Güncellemeleri ve plugin'leri test etme