OpenClaw’ın üç genel kullanıma açık yayın kanalı vardır: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.
- stable: varsayılan olarak npm
betakanalına veya açıkça istendiğinde npmlatestkanalına yayımlanan etiketli sürümler - beta: npm
betakanalına yayımlanan ön sürüm etiketleri - dev:
maindalının hareketli başı
Sürüm adlandırma
- Kararlı yayın sürümü:
YYYY.M.D- Git etiketi:
vYYYY.M.D
- Git etiketi:
- Kararlı düzeltme yayın sürümü:
YYYY.M.D-N- Git etiketi:
vYYYY.M.D-N
- Git etiketi:
- Beta ön sürüm sürümü:
YYYY.M.D-beta.N- Git etiketi:
vYYYY.M.D-beta.N
- Git etiketi:
- Ayı veya günü başına sıfır ekleyerek yazmayın
latest, geçerli yükseltilmiş kararlı npm yayını anlamına gelirbeta, geçerli beta kurulum hedefi anlamına gelir- Kararlı ve kararlı düzeltme sürümleri varsayılan olarak npm
betakanalına yayımlanır; yayın operatörleri açıkçalatesthedefleyebilir veya incelenmiş bir beta derlemesini daha sonra yükseltebilir - Her kararlı OpenClaw sürümü npm paketini ve macOS uygulamasını birlikte gönderir; beta sürümleri normalde önce npm/paket yolunu doğrular ve yayımlar; Mac uygulaması derleme/imzalama/noter onayı, açıkça istenmediği sürece kararlı sürüme ayrılır
Yayın sıklığı
- Yayınlar önce beta üzerinden ilerler
- Kararlı sürüm, yalnızca en son beta doğrulandıktan sonra gelir
- Bakımcılar normalde yayınları geçerli
maindalından oluşturulan birrelease/YYYY.M.Ddalından keser; böylece yayın doğrulaması ve düzeltmelerimainüzerindeki yeni geliştirmeyi engellemez - Bir beta etiketi gönderilmiş veya yayımlanmışsa ve düzeltme gerekiyorsa, bakımcılar
eski beta etiketini silmek veya yeniden oluşturmak yerine sonraki
-beta.Netiketini keser - Ayrıntılı yayın prosedürü, onaylar, kimlik bilgileri ve kurtarma notları yalnızca bakımcılara açıktır
Yayın operatörü kontrol listesi
Bu kontrol listesi yayın akışının genel yapısıdır. Özel kimlik bilgileri, imzalama, noter onayı, dist-tag kurtarma ve acil geri alma ayrıntıları yalnızca bakımcılara açık yayın çalışma kılavuzunda kalır.- Geçerli
maindalından başlayın: en son değişiklikleri çekin, hedef commit’in gönderildiğini ve geçerlimainCI durumunun ondan dal oluşturmak için yeterince yeşil olduğunu doğrulayın. - Üstteki
CHANGELOG.mdbölümünü gerçek commit geçmişinden/changelogile yeniden yazın, girdileri kullanıcı odaklı tutun, commit’leyin, gönderin ve dallanmadan önce bir kez daha rebase/pull yapın. - Yayın uyumluluk kayıtlarını
src/plugins/compat/registry.tsvesrc/commands/doctor/shared/deprecation-compat.tsiçinde gözden geçirin. Süresi dolmuş uyumluluğu yalnızca yükseltme yolu kapsanmaya devam ettiğinde kaldırın veya neden bilinçli olarak taşındığını kaydedin. - Geçerli
maindalındanrelease/YYYY.M.Doluşturun; normal yayın işini doğrudanmainüzerinde yapmayın. - Amaçlanan etiket için gereken her sürüm konumunu yükseltin, ardından
pnpm release:prepçalıştırın. Bu komut Plugin sürümlerini, Plugin envanterini, yapılandırma şemasını, paketlenmiş kanal yapılandırma metaverisini, yapılandırma belgeleri temelini, Plugin SDK dışa aktarımlarını ve Plugin SDK API temelini doğru sırayla yeniler. Etiketlemeden önce oluşan üretilmiş sapmaları commit’leyin. Ardından yerel deterministik ön kontrolü çalıştırın:pnpm check:test-types,pnpm check:architecture,pnpm build && pnpm ui:buildvepnpm release:check. OpenClaw NPM Releaseişinipreflight_only=trueile çalıştırın. Bir etiket var olmadan önce, yalnızca doğrulama amaçlı ön kontrol için tam 40 karakterlik yayın dalı SHA’sına izin verilir. Başarılıpreflight_run_iddeğerini saklayın.- Yayın dalı, etiket veya tam commit SHA’sı için
Full Release Validationile tüm ön yayın testlerini başlatın. Bu, dört büyük yayın test kutusu için tek manuel giriş noktasıdır: Vitest, Docker, QA Lab ve Package. - Doğrulama başarısız olursa yayın dalında düzeltin ve düzeltmeyi kanıtlayan en küçük başarısız dosyayı, kanalı, workflow job’ını, paket profilini, sağlayıcıyı veya model izin listesini yeniden çalıştırın. Tam şemsiyeyi yalnızca değişen yüzey önceki kanıtı geçersiz kıldığında yeniden çalıştırın.
- Beta için
vYYYY.M.D-beta.Netiketleyin, ardından eşleşenrelease/YYYY.M.DdalındanOpenClaw Release Publishçalıştırın. Bu işpnpm plugins:sync:checkdoğrular, yayımlanabilir tüm Plugin paketlerini npm’e ve aynı seti paralel olarak ClawHub’a gönderir, ardından Plugin npm yayını başarılı olur olmaz hazırlanmış OpenClaw npm ön kontrol yapıtını eşleşen dist-tag ile yükseltir. OpenClaw npm yayın alt işi başarılı olduktan sonra, tam eşleşenCHANGELOG.mdbölümünden eşleşen GitHub release/prerelease sayfasını oluşturur veya günceller. npmlatestkanalına yayımlanan kararlı sürümler GitHub latest release olur; npmbetakanalında tutulan kararlı bakım sürümleri GitHublatest=falseile oluşturulur. OpenClaw npm yayımlanırken ClawHub yayımlaması hâlâ çalışıyor olabilir, ancak yayın yayımlama workflow’u alt çalışma kimliklerini hemen yazdırır. Varsayılan olarak ClawHub’ı gönderdikten sonra beklemez; bu nedenle OpenClaw npm kullanılabilirliği daha yavaş ClawHub onayları veya kayıt işleri tarafından engellenmez. ClawHub’ın workflow tamamlanmasını engellemesi gerektiğindewait_for_clawhub=trueayarlayın. ClawHub yolu geçici CLI bağımlılık kurulum hatalarını yeniden dener, bir önizleme hücresi aksasa bile önizlemeden geçen Plugin’leri yayımlar ve kısmi yayınların görünür ve yeniden denenebilir kalması için beklenen her Plugin sürümü için kayıt doğrulamasıyla sona erer. Yayından sonra GitHub prerelease’i, npmbetadist-tag’lerini, npm bütünlüğünü, yayımlanmış kurulum yolunu, ClawHub tam sürümlerini, ClawHub yapıtlarını ve alt workflow sonuçlarını tek komuttan doğrulamak içinpnpm release:verify-beta -- YYYY.M.D-beta.N --openclaw-npm-run <run-id> --plugin-npm-run <run-id> --plugin-clawhub-run <run-id>çalıştırın. ClawHub yan işi yalnızca yeniden denenebilir işlerde başarısız olduysa ve yerinde yeniden çalıştırılması gerekiyorsa--rerun-failed-clawhubekleyin. Ardından yayımlanmışopenclaw@YYYY.M.D-beta.Nveyaopenclaw@betapaketine karşı yayın sonrası paket kabulünü çalıştırın. Gönderilmiş veya yayımlanmış bir ön sürümün düzeltmeye ihtiyacı varsa sonraki eşleşen ön sürüm numarasını kesin; eski ön sürümü silmeyin veya yeniden yazmayın. - Kararlı sürüm için yalnızca incelenmiş beta veya yayın adayı gerekli doğrulama kanıtına sahip olduktan
sonra devam edin. Kararlı npm yayını da başarılı ön kontrol yapıtını
preflight_run_idile yeniden kullanarakOpenClaw Release Publishüzerinden geçer; kararlı macOS yayın hazırlığı ayrıca paketlenmiş.zip,.dmg,.dSYM.zipvemainüzerindeki güncellenmişappcast.xmlgerektirir. Özel macOS yayın workflow’u, yayın varlıkları doğrulandıktan sonra imzalı appcast’i otomatik olarak herkese açıkmaindalına yayımlar; dal koruması doğrudan göndermeyi engellerse bir appcast PR’ı açar veya günceller. - Yayından sonra npm yayın sonrası doğrulayıcısını, yayın sonrası kanal kanıtına ihtiyacınız olduğunda isteğe bağlı bağımsız yayımlanmış-npm Telegram E2E’yi, gerektiğinde dist-tag yükseltmesini çalıştırın, oluşturulan GitHub release sayfasını doğrulayın ve yayın duyurusu adımlarını çalıştırın.
Yayın ön kontrolü
- Sürüm ön uçuşundan önce
pnpm check:test-typesçalıştırın; böylece test TypeScript’i daha hızlı yerelpnpm checkgeçidi dışında da kapsanır - Sürüm ön uçuşundan önce
pnpm check:architectureçalıştırın; böylece daha kapsamlı içe aktarma döngüsü ve mimari sınır denetimleri daha hızlı yerel geçit dışında yeşil olur pnpm release:checköncesindepnpm build && pnpm ui:buildçalıştırın; böylece beklenendist/*sürüm yapıtları ve Control UI paketi, paket doğrulama adımı için mevcut olur- Kök sürüm artırmasından sonra ve etiketlemeden önce
pnpm release:prepçalıştırın. Bu komut, sürüm/yapılandırma/API değişikliğinden sonra sıkça sapma gösteren tüm deterministik sürüm üreticilerini çalıştırır: plugin sürümleri, plugin envanteri, temel yapılandırma şeması, paketlenen kanal yapılandırma meta verileri, yapılandırma dokümantasyonu başlangıç değeri, plugin SDK dışa aktarımları ve plugin SDK API başlangıç değeri.pnpm release:check, bu korumaları denetim modunda yeniden çalıştırır ve paket sürüm denetimlerini çalıştırmadan önce bulduğu tüm üretilmiş sapma hatalarını tek geçişte raporlar. - Sürüm onayından önce manuel
Full Release Validationiş akışını çalıştırarak tüm ön sürüm test kutularını tek bir giriş noktasından başlatın. Bir dal, etiket veya tam commit SHA kabul eder, manuelCItetikler ve kurulum smoke, paket kabulü, çapraz OS paket denetimleri, QA Lab paritesi, Matrix ve Telegram hatları içinOpenClaw Release Checkstetikler. Kararlı/varsayılan çalıştırmalar, kapsamlı canlı/E2E ve Docker sürüm yolu bekletmesinirun_release_soak=truearkasında tutar;release_profile=fullbekletmeyi zorunlu kılar.release_profile=fullvererun_group=allile, sürüm denetimlerinden gelenrelease-package-under-testyapıtına karşı paket Telegram E2E’yi de çalıştırır. Bir beta yayımladıktan sonra, sürüm denetimleri, Package Acceptance ve paket Telegram E2E genelinde gönderilmiş npm paketini sürüm tarball’ını yeniden oluşturmadan yeniden kullanmak içinrelease_package_specsağlayın. Telegram’ın sürüm doğrulamasının geri kalanından farklı bir yayımlanmış paket kullanması gerektiğinde yalnızcanpm_telegram_package_specsağlayın. Package Acceptance’ın sürüm paketi belirtiminden farklı bir yayımlanmış paket kullanması gerektiğindepackage_acceptance_package_specsağlayın. Özel kanıt raporunun, Telegram E2E’yi zorlamadan doğrulamanın yayımlanmış bir npm paketiyle eşleştiğini kanıtlaması gerektiğindeevidence_package_specsağlayın. Örnek:gh workflow run full-release-validation.yml --ref main -f ref=release/YYYY.M.D - Sürüm çalışması devam ederken bir paket adayı için yan kanal kanıtı istediğinizde manuel
Package Acceptanceiş akışını çalıştırın.openclaw@beta,openclaw@latestveya kesin bir sürüm içinsource=npm; geçerliworkflow_refdonanımıyla güvenilir birpackage_refdalı/etiketi/SHA’sını paketlemek içinsource=ref; gerekli SHA-256 ile bir HTTPS tarball içinsource=url; ya da başka bir GitHub Actions çalıştırması tarafından yüklenen tarball içinsource=artifactkullanın. İş akışı adayıpackage-under-testolarak çözümler, Docker E2E sürüm zamanlayıcısını bu tarball’a karşı yeniden kullanır ve aynı tarball’a karşıtelegram_mode=mock-openaiveyatelegram_mode=live-frontierile Telegram QA çalıştırabilir. Seçilen Docker hatlarıpublished-upgrade-survivoriçerdiğinde, paket yapıtı adaydır vepublished_upgrade_survivor_baselineyayımlanmış başlangıç değerini seçer.update-restart-auth, aday paketi hem kurulu CLI hem de package-under-test olarak kullanır; böylece aday güncelleme komutunun yönetilen yeniden başlatma yolunu çalıştırır. Örnek: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 published_upgrade_survivor_baseline=openclaw@2026.4.26 -f telegram_mode=mock-openaiYaygın profiller:smoke: kurulum/kanal/ajan, gateway ağı ve yapılandırma yeniden yükleme hatlarıpackage: OpenWebUI veya canlı ClawHub olmadan yapıt-yerel paket/güncelleme/yeniden başlatma/plugin hatlarıproduct: paket profiline ek olarak MCP kanalları, cron/alt ajan temizliği, OpenAI web araması ve OpenWebUIfull: OpenWebUI ile Docker sürüm yolu parçalarıcustom: odaklı bir yeniden çalıştırma için kesindocker_lanesseçimi
- Yalnızca sürüm adayı için tam normal CI kapsamına ihtiyaç duyduğunuzda manuel
CIiş akışını doğrudan çalıştırın. Manuel CI tetiklemeleri değişiklik kapsamlandırmasını atlar ve Linux Node parçalarını, paketlenen-plugin parçalarını, kanal sözleşmelerini, Node 22 uyumluluğunu,check,check-additional, build smoke, dokümantasyon denetimlerini, Python skills, Windows, macOS, Android ve Control UI i18n hatlarını zorunlu kılar. Örnek:gh workflow run ci.yml --ref release/YYYY.M.D - Sürüm telemetrisini doğrularken
pnpm qa:otel:smokeçalıştırın. QA-lab’i yerel bir OTLP/HTTP alıcısı üzerinden çalıştırır ve Opik, Langfuse veya başka bir harici toplayıcı gerektirmeden dışa aktarılan iz span adlarını, sınırlandırılmış öznitelikleri ve içerik/tanımlayıcı redaksiyonunu doğrular. - Her etiketli sürümden önce
pnpm release:checkçalıştırın - Etiket mevcut olduktan sonra mutasyon yapan yayımlama dizisi için
OpenClaw Release Publishçalıştırın. Bunurelease/YYYY.M.Düzerinden (veya main’den erişilebilir bir etiket yayımlarkenmainüzerinden) tetikleyin, sürüm etiketini ve başarılı OpenClaw npmpreflight_run_iddeğerini iletin ve odaklı bir onarım çalıştırmıyorsanız varsayılan plugin yayımlama kapsamınıall-publishableolarak bırakın. İş akışı plugin npm yayımlamasını, plugin ClawHub yayımlamasını ve OpenClaw npm yayımlamasını sıralı hale getirir; böylece çekirdek paket, dışsallaştırılmış plugin’lerinden önce yayımlanmaz. - Sürüm denetimleri artık ayrı bir manuel iş akışında çalışır:
OpenClaw Release Checks OpenClaw Release Checks, sürüm onayından önce QA Lab mock parite hattını, hızlı canlı Matrix profilini ve Telegram QA hattını da çalıştırır. Canlı hatlarqa-live-sharedortamını kullanır; Telegram ayrıca Convex CI kimlik bilgisi kiralamalarını kullanır. Tam Matrix taşıma, medya ve E2EE envanterini paralel istediğinizde manuelQA-Lab - All Lanesiş akışınımatrix_profile=allvematrix_shards=trueile çalıştırın.- Çapraz OS kurulum ve yükseltme çalışma zamanı doğrulaması, yeniden kullanılabilir iş akışını doğrudan çağıran genel
OpenClaw Release ChecksveFull Release Validationkapsamındadır:.github/workflows/openclaw-cross-os-release-checks-reusable.yml - Bu ayrım bilinçlidir: gerçek npm sürüm yolunu kısa, deterministik ve yapıt odaklı tutar; daha yavaş canlı denetimler ise yayımlamayı durdurmamak veya engellememek için kendi hattında kalır
- Sır taşıyan sürüm denetimleri
Full Release Validationüzerinden ya damain/sürüm iş akışı ref’inden tetiklenmelidir; böylece iş akışı mantığı ve sırlar kontrollü kalır OpenClaw Release Checks, çözümlenen commit bir OpenClaw dalından veya sürüm etiketinden erişilebilir olduğu sürece dal, etiket veya tam commit SHA kabul ederOpenClaw NPM Releaseyalnızca doğrulama ön uçuşu, itilmiş bir etiket gerektirmeden geçerli tam 40 karakterlik iş akışı dalı commit SHA’sını da kabul eder- Bu SHA yolu yalnızca doğrulama içindir ve gerçek yayımlamaya yükseltilemez
- SHA modunda iş akışı yalnızca paket meta verisi denetimi için
v<package.json version>sentezler; gerçek yayımlama hâlâ gerçek bir sürüm etiketi gerektirir - Her iki iş akışı da gerçek yayımlama ve yükseltme yolunu GitHub tarafından barındırılan çalıştırıcılarda tutarken, mutasyon yapmayan doğrulama yolu daha büyük Blacksmith Linux çalıştırıcılarını kullanabilir
- Bu iş akışı
OPENCLAW_LIVE_TEST=1 OPENCLAW_LIVE_CACHE_TEST=1 pnpm test:live:cachekomutunu hemOPENAI_API_KEYhem deANTHROPIC_API_KEYiş akışı sırlarını kullanarak çalıştırır - npm sürüm ön uçuşu artık ayrı sürüm denetimleri hattını beklemez
- Bir sürüm adayını yerelde etiketlemeden önce
RELEASE_TAG=vYYYY.M.D-beta.N pnpm release:fast-pretag-checkçalıştırın. Yardımcı, GitHub yayımlama iş akışı başlamadan önce yaygın onay engelleyici hataları yakalayan sırayla hızlı sürüm korumalarını, plugin npm/ClawHub sürüm denetimlerini, derlemeyi, UI derlemesini verelease:openclaw:npm:checkkomutunu çalıştırır. - Onaydan önce
RELEASE_TAG=vYYYY.M.D node --import tsx scripts/openclaw-npm-release-check.tskomutunu (veya eşleşen beta/düzeltme etiketini) çalıştırın - npm yayımlamasından sonra, yayımlanmış registry kurulum yolunu yeni bir geçici önek içinde doğrulamak için
node --import tsx scripts/openclaw-npm-postpublish-verify.ts YYYY.M.Dkomutunu (veya eşleşen beta/düzeltme sürümünü) çalıştırın - Bir beta yayımlamasından sonra, paylaşılan kiralanmış Telegram kimlik bilgisi havuzunu kullanarak yayımlanmış npm paketine karşı kurulu paket onboarding’ini, Telegram kurulumunu ve gerçek Telegram E2E’yi doğrulamak için
OPENCLAW_NPM_TELEGRAM_PACKAGE_SPEC=openclaw@YYYY.M.D-beta.N OPENCLAW_NPM_TELEGRAM_CREDENTIAL_SOURCE=convex OPENCLAW_NPM_TELEGRAM_CREDENTIAL_ROLE=ci pnpm test:docker:npm-telegram-liveçalıştırın. Yerel maintainer tek seferlik çalıştırmaları Convex değişkenlerini atlayabilir ve üçOPENCLAW_QA_TELEGRAM_*ortam kimlik bilgisini doğrudan iletebilir. - Bir maintainer makinesinden tam yayımlama sonrası beta smoke çalıştırmak için
pnpm release:beta-smoke -- --beta betaNkullanın. Yardımcı, Parallels npm güncelleme/yeni hedef doğrulamasını çalıştırır,NPM Telegram Beta E2Etetikler, kesin iş akışı çalıştırmasını yoklar, yapıtı indirir ve Telegram raporunu yazdırır. - Maintainer’lar aynı yayımlama sonrası denetimi GitHub Actions üzerinden manuel
NPM Telegram Beta E2Eiş akışıyla çalıştırabilir. Bu iş akışı bilinçli olarak yalnızca manueldir ve her merge işleminde çalışmaz. - Maintainer sürüm otomasyonu artık ön uçuş-sonra-yükseltme kullanır:
- gerçek npm yayımlaması başarılı bir npm
preflight_run_iddeğerini geçmelidir - gerçek npm yayımlaması, başarılı ön uçuş çalıştırmasıyla aynı
mainveyarelease/YYYY.M.Ddalından tetiklenmelidir - kararlı npm sürümleri varsayılan olarak
betakullanır - kararlı npm yayımlaması, iş akışı girdisi üzerinden açıkça
latesthedefleyebilir - token tabanlı npm dist-tag mutasyonu artık güvenlik nedeniyle
openclaw/releases-private/.github/workflows/openclaw-npm-dist-tags.ymliçinde yer alır; çünkü genel repo OIDC-only yayımlamayı korurkennpm dist-tag addhâlâNPM_TOKENgerektirir - genel
macOS Releaseyalnızca doğrulama içindir; bir etiket yalnızca bir sürüm dalında bulunuyor ancak iş akışımainüzerinden tetikleniyorsapublic_release_branch=release/YYYY.M.Dayarlayın - gerçek özel mac yayımlaması başarılı özel mac
preflight_run_idvevalidate_run_iddeğerlerini geçmelidir - gerçek yayımlama yolları, yapıtları yeniden oluşturmak yerine hazırlanmış yapıtları yükseltir
- gerçek npm yayımlaması başarılı bir npm
YYYY.M.D-Ngibi kararlı düzeltme sürümleri için yayımlama sonrası doğrulayıcı, aynı geçici önek yükseltme yolunuYYYY.M.DsürümündenYYYY.M.D-Nsürümüne de denetler; böylece sürüm düzeltmeleri eski global kurulumları sessizce temel kararlı yükte bırakamaz- npm sürüm ön uçuşu, tarball hem
dist/control-ui/index.htmlhem de boş olmayan birdist/control-ui/assets/yükü içermedikçe kapalı başarısız olur; böylece boş bir tarayıcı panosunu yeniden göndermeyiz - Yayımlama sonrası doğrulama, yayımlanmış plugin giriş noktalarının ve paket meta verilerinin kurulu registry düzeninde mevcut olduğunu da denetler. Eksik plugin çalışma zamanı yükleri gönderen bir sürüm, postpublish doğrulayıcısında başarısız olur ve
latestsürümüne yükseltilemez. pnpm test:install:smoke, aday güncelleme tarball’ı üzerinde npm paketunpackedSizebütçesini de zorunlu kılar; böylece installer e2e, yanlışlıkla oluşan paket şişmesini sürüm yayımlama yolundan önce yakalar- Sürüm çalışması CI planlamasına, extension zamanlama manifestlerine veya extension test matrislerine dokunduysa, sürüm notlarının eski bir CI düzenini açıklamaması için onaydan önce
.github/workflows/plugin-prerelease.ymliçinden planner-ownedplugin-prerelease-extension-shardmatris çıktılarını yeniden üretin ve gözden geçirin - Kararlı macOS sürüm hazır oluşu, güncelleyici yüzeylerini de içerir:
- GitHub sürümü paketlenmiş
.zip,.dmgve.dSYM.zipile sonuçlanmalıdır - yayımlamadan sonra
mainüzerindekiappcast.xmlyeni kararlı zip’e işaret etmelidir; özel macOS yayımlama iş akışı bunu otomatik olarak commit eder veya doğrudan push engellendiğinde bir appcast PR açar - paketlenmiş uygulama, hata ayıklama olmayan bir bundle id, boş olmayan bir Sparkle feed URL’si ve bu sürüm için kanonik Sparkle build tabanına eşit ya da ondan yüksek bir
CFBundleVersionkorumalıdır
- GitHub sürümü paketlenmiş
Sürüm test kutuları
Full Release Validation, operatörlerin tüm ön sürüm testlerini tek bir giriş
noktasından başlatma yoludur. Hızla değişen bir dalda sabitlenmiş commit kanıtı
için, her alt workflow’un hedef SHA’ya sabitlenmiş geçici bir daldan çalışması
amacıyla yardımcıyı kullanın:
release-ci/<sha>-... dalını gönderir, bu daldan ref=<sha> ile
Full Release Validation başlatır, her alt workflow headSha değerinin hedefle
eşleştiğini doğrular, ardından geçici dalı siler. Bu, yanlışlıkla daha yeni bir
main alt çalıştırmasını kanıtlamayı önler.
Sürüm dalı veya etiket doğrulaması için, bunu güvenilen main workflow
ref’inden çalıştırın ve sürüm dalını ya da etiketini ref olarak geçirin:
target_ref=<release-ref> ile manuel CI
başlatır, OpenClaw Release Checks başlatır, pakete dönük kontroller için
üst release-package-under-test artifact’ı hazırlar ve release_profile=full
olup rerun_group=all olduğunda ya da release_package_spec veya
npm_telegram_package_spec ayarlandığında bağımsız paket Telegram E2E
başlatır. Ardından OpenClaw Release Checks, kurulum smoke, çapraz işletim sistemi sürüm kontrolleri, soak
etkinken canlı/E2E Docker sürüm yolu kapsamı, Telegram paket QA ile Package
Acceptance, QA Lab eşliği, canlı Matrix ve canlı Telegram’a yayılır. Tam bir
çalıştırma yalnızca Full Release Validation
özetinde normal_ci ve release_checks başarılı görünüyorsa kabul edilebilir.
full/all modunda npm_telegram alt çalıştırması da başarılı olmalıdır; full/all
dışında, yayımlanmış bir release_package_spec veya npm_telegram_package_spec
sağlanmadıkça atlanır. Son doğrulayıcı özeti her alt çalıştırma için en yavaş
iş tablolarını içerir, böylece sürüm yöneticisi log indirmeden mevcut kritik
yolu görebilir.
Tam aşama matrisi, kesin workflow iş adları, stable ile full profil farkları,
artifact’lar ve odaklı yeniden çalıştırma tutamaçları için
Tam sürüm doğrulaması bölümüne bakın.
Alt workflow’lar, hedef ref daha eski bir sürüm dalını veya etiketini gösterse
bile Full Release Validation çalıştıran güvenilen ref’ten, normalde --ref main üzerinden
başlatılır. Ayrı bir Full Release Validation workflow-ref girdisi yoktur;
güvenilen harness’ı workflow çalıştırma ref’ini seçerek belirleyin.
Hareketli main üzerinde kesin commit kanıtı için --ref main -f ref=<sha>
kullanmayın; ham commit SHA’ları workflow dispatch ref’i olamaz, bu nedenle
sabitlenmiş geçici dalı oluşturmak için pnpm ci:full-release --sha <sha>
kullanın.
Canlı/provider kapsamını seçmek için release_profile kullanın:
minimum: en hızlı sürüm açısından kritik OpenAI/core canlı ve Docker yolustable: sürüm onayı için minimuma ek olarak stable provider/backend kapsamıfull: stable’a ek olarak geniş danışma provider/medya kapsamı
stable ile run_release_soak=true kullanın. Bu tarama, son dört
stable paketin yanı sıra sabitlenmiş 2026.4.23 ve 2026.5.2 temel çizgilerini
ve daha eski 2026.4.15 kapsamını kapsar; yinelenen temel çizgiler kaldırılır
ve her temel çizgi kendi Docker runner işine bölünür. full,
run_release_soak=true anlamına gelir.
OpenClaw Release Checks, hedef ref’i bir kez release-package-under-test
olarak çözmek için güvenilen workflow ref’ini kullanır ve soak çalıştığında bu
artifact’ı çapraz işletim sistemi, Package Acceptance ve sürüm yolu Docker
kontrollerinde yeniden kullanır. Bu, pakete dönük tüm kutuları aynı baytlarda
tutar ve tekrarlanan paket derlemelerini önler.
Beta zaten npm’deyse, release_package_spec=openclaw@YYYY.M.D-beta.N ayarlayın;
böylece sürüm kontrolleri gönderilmiş paketi bir kez indirir, derleme kaynak
SHA’sını dist/build-info.json içinden çıkarır ve bu artifact’ı çapraz işletim
sistemi, Package Acceptance, sürüm yolu Docker ve paket Telegram hatları için
yeniden kullanır.
Çapraz işletim sistemi OpenAI kurulum smoke’u, repo/kuruluş değişkeni
ayarlandığında OPENCLAW_CROSS_OS_OPENAI_MODEL kullanır; aksi halde
openai/gpt-5.4 kullanır, çünkü bu hat en yavaş varsayılan modeli kıyaslamak
yerine paket kurulumunu, onboarding’i, gateway başlatmayı ve tek bir canlı ajan
turunu kanıtlar. Daha geniş canlı provider matrisi, modele özgü kapsamın yeridir.
Sürüm aşamasına göre bu varyantları kullanın:
Verify full validation üst işini
yeniden çalıştırın.
Sınırlı kurtarma için şemsiyeye rerun_group geçirin. all gerçek sürüm adayı
çalıştırmasıdır, ci yalnızca normal CI altını çalıştırır, plugin-prerelease
yalnızca sürüme özel plugin altını çalıştırır, release-checks her sürüm
kutusunu çalıştırır ve daha dar sürüm grupları install-smoke, cross-os,
live-e2e, package, qa, qa-parity, qa-live ve npm-telegramdır.
Odaklı npm-telegram yeniden çalıştırmaları release_package_spec veya
npm_telegram_package_spec gerektirir; release_profile=full ile full/all
çalıştırmaları release-checks paket artifact’ını kullanır. Odaklı çapraz işletim
sistemi yeniden çalıştırmaları cross_os_suite_filter=windows/packaged-upgrade
veya başka bir işletim sistemi/suite filtresi ekleyebilir. QA release-check
başarısızlıkları danışma niteliğindedir; yalnızca QA başarısızlığı sürüm
doğrulamasını engellemez.
Vitest
Vitest kutusu manuelCI alt workflow’udur. Manuel CI, changed kapsamını bilerek
atlar ve sürüm adayı için normal test grafiğini zorunlu kılar: Linux Node
parçaları, paketlenmiş Plugin parçaları, kanal sözleşmeleri, Node 22 uyumluluğu,
check, check-additional, build smoke, doküman kontrolleri, Python skills,
Windows, macOS, Android ve Control UI i18n.
Bu kutuyu “kaynak ağacı tam normal test suite’ini geçti mi?” sorusunu yanıtlamak
için kullanın. Bu, sürüm yolu ürün doğrulamasıyla aynı değildir. Saklanacak
kanıtlar:
- başlatılan
CIçalıştırma URL’sini gösterenFull Release Validationözeti - kesin hedef SHA üzerinde yeşil
CIçalıştırması - regresyonları incelerken CI işlerinden başarısız veya yavaş parça adları
- bir çalıştırmanın performans analizine ihtiyaç duyduğu durumlarda
.artifacts/vitest-shard-timings.jsongibi Vitest zamanlama artifact’ları
Docker
Docker kutusu,openclaw-live-and-e2e-checks-reusable.yml üzerinden
OpenClaw Release Checks içinde ve sürüm modu install-smoke workflow’unda
yer alır. Sürüm adayını yalnızca kaynak düzeyi testler yerine paketlenmiş Docker
ortamları üzerinden doğrular.
Sürüm Docker kapsamı şunları içerir:
- yavaş Bun global kurulum smoke’u etkin olan tam kurulum smoke’u
- hedef SHA’ya göre kök Dockerfile smoke imajı hazırlama/yeniden kullanımı; QR, root/gateway ve installer/Bun smoke işleri ayrı install-smoke parçaları olarak çalışır
- depo E2E hatları
- sürüm yolu Docker parçaları:
core,package-update-openai,package-update-anthropic,package-update-core,plugins-runtime-plugins,plugins-runtime-services,plugins-runtime-install-a,plugins-runtime-install-b,plugins-runtime-install-c,plugins-runtime-install-d,plugins-runtime-install-e,plugins-runtime-install-f,plugins-runtime-install-gveplugins-runtime-install-h - istendiğinde
plugins-runtime-servicesparçası içinde OpenWebUI kapsamı - bölünmüş paketlenmiş plugin kurulum/kaldırma hatları
bundled-plugin-install-uninstall-0ilebundled-plugin-install-uninstall-23arası - sürüm kontrolleri canlı suite’leri içerdiğinde canlı/E2E provider suite’leri ve Docker canlı model kapsamı
.artifacts/docker-tests/ dizinini hat logları, summary.json,
failures.json, aşama zamanlamaları, zamanlayıcı plan JSON’u ve yeniden
çalıştırma komutlarıyla birlikte yükler. Odaklı kurtarma için tüm sürüm
parçalarını yeniden çalıştırmak yerine yeniden kullanılabilir canlı/E2E
workflow’unda docker_lanes=<lane[,lane]> kullanın. Oluşturulan yeniden
çalıştırma komutları, kullanılabilir olduğunda önceki package_artifact_run_id
ve hazırlanmış Docker imajı girdilerini içerir; böylece başarısız bir hat aynı
tarball’ı ve GHCR imajlarını yeniden kullanabilir.
QA Lab
QA Lab kutusu daOpenClaw Release Checks parçasıdır. Vitest ve Docker paket
mekaniklerinden ayrı olarak ajan davranışı ve kanal düzeyi sürüm kapısıdır.
Sürüm QA Lab kapsamı şunları içerir:
- ajan eşlik paketiyle OpenAI aday hattını Opus 4.6 temel çizgisiyle karşılaştıran mock eşlik hattı
qa-live-sharedortamını kullanan hızlı canlı Matrix QA profili- Convex CI kimlik bilgisi kiralamalarını kullanan canlı Telegram QA hattı
- sürüm telemetrisinin açık yerel kanıta ihtiyaç duyduğu durumlarda
pnpm qa:otel:smoke
Paket
Paket kutusu kurulabilir ürün kapısıdır.Package Acceptance ve
scripts/resolve-openclaw-package-candidate.mjs çözücüsü tarafından desteklenir.
Çözücü, adayı Docker E2E tarafından tüketilen package-under-test tarball’ına
normalleştirir, paket envanterini doğrular, paket sürümünü ve SHA-256 değerini
kaydeder ve workflow harness ref’ini paket kaynak ref’inden ayrı tutar.
Desteklenen aday kaynakları:
source=npm:openclaw@beta,openclaw@latestveya kesin bir OpenClaw sürüm versionsource=ref: seçilenworkflow_refharness’ı ile güvenilen birpackage_refdalını, etiketini veya tam commit SHA’sını paketlesource=url: gereklipackage_sha256ile bir HTTPS.tgzindirsource=artifact: başka bir GitHub Actions çalıştırması tarafından yüklenen.tgzdosyasını yeniden kullan
OpenClaw Release Checks, Package Acceptance’ı source=artifact, hazırlanmış sürüm paket artifaktı, suite_profile=custom, docker_lanes=doctor-switch update-channel-switch skill-install update-corrupt-plugin upgrade-survivor published-upgrade-survivor update-restart-auth plugins-offline plugin-update, telegram_mode=mock-openai ile çalıştırır. Package Acceptance; geçiş, güncelleme, yapılandırılmış kimlik doğrulama güncellemesi yeniden başlatması, canlı ClawHub Skills kurulumu, eski Plugin bağımlılığı temizliği, çevrimdışı Plugin fikstürleri, Plugin güncellemesi ve Telegram paket QA kapsamını aynı çözümlenmiş tarball üzerinde tutar. Engelleyici sürüm denetimleri varsayılan en son yayımlanmış paket temelini kullanır; run_release_soak=true veya release_profile=full, 2026.4.23 sürümünden latest sürümüne kadar tüm kararlı npm’de yayımlanmış temellere ve bildirilen sorun fikstürlerine genişler. Zaten gönderilmiş bir aday için Package Acceptance’ı source=npm ile, yayımlamadan önce SHA destekli yerel npm tarball için source=ref/source=artifact ile kullanın. Bu, daha önce Parallels gerektiren paket/güncelleme kapsamının çoğu için GitHub yerelindeki alternatiftir. İşletim sistemine özgü onboarding, yükleyici ve platform davranışı için çapraz işletim sistemi sürüm denetimleri hâlâ önemlidir, ancak paket/güncelleme ürün doğrulaması Package Acceptance’ı tercih etmelidir.
Güncelleme ve Plugin doğrulaması için kanonik kontrol listesi
Testing updates and plugins sayfasıdır. Bir
Plugin kurulumu/güncellemesi, doctor temizliği veya yayımlanmış paket geçiş değişikliğini hangi yerel, Docker, Package Acceptance ya da sürüm denetimi kulvarının kanıtladığına karar verirken bunu kullanın.
Her kararlı 2026.4.23+ paketinden kapsamlı yayımlanmış güncelleme geçişi,
Full Release CI’ın parçası değil, ayrı bir manuel Update Migration iş akışıdır.
Eski package-acceptance toleransı bilinçli olarak süreyle sınırlanmıştır. 2026.4.25 sürümüne kadar paketler, npm’e zaten yayımlanmış metadata boşlukları için uyumluluk yolunu kullanabilir: tarball’da eksik özel QA envanter girdileri, eksik gateway install --wrapper, tarball’dan türetilmiş git fikstüründe eksik yama dosyaları, eksik kalıcı update.channel, eski Plugin kurulum kaydı konumları, eksik marketplace kurulum kaydı kalıcılığı ve plugins update sırasında yapılandırma metadata geçişi. Yayımlanmış 2026.4.26 paketi, zaten gönderilmiş yerel derleme metadata damga dosyaları için uyarı verebilir. Daha sonraki paketler modern paket sözleşmelerini karşılamalıdır; aynı boşluklar sürüm doğrulamasını başarısız kılar.
Sürüm sorusu gerçek bir kurulabilir paketle ilgili olduğunda daha geniş Package Acceptance profilleri kullanın:
smoke: hızlı paket kurulumu/kanal/agent, Gateway ağı ve yapılandırma yeniden yükleme kulvarlarıpackage: kurulum/güncelleme/yeniden başlatma/Plugin paket sözleşmeleri ve canlı ClawHub Skills kurulum kanıtı; bu, sürüm denetimi varsayılanıdırproduct:packageartı MCP kanalları, cron/subagent temizliği, OpenAI web araması ve OpenWebUIfull: OpenWebUI ile Docker sürüm yolu parçalarıcustom: odaklı yeniden çalıştırmalar için tamdocker_laneslistesi
telegram_mode=mock-openai veya
telegram_mode=live-frontier etkinleştirin. İş akışı çözümlenmiş
package-under-test tarball’ını Telegram kulvarına geçirir; bağımsız
Telegram iş akışı, yayım sonrası denetimler için yayımlanmış bir npm spesifikasyonunu hâlâ kabul eder.
Sürüm yayımlama otomasyonu
OpenClaw Release Publish, normal değişiklik yapan yayımlama giriş noktasıdır. Sürümün ihtiyaç duyduğu sırayla trusted-publisher iş akışlarını düzenler:
- Sürüm etiketini checkout yapar ve commit SHA’sını çözümler.
- Etiketin
mainveyarelease/*üzerinden erişilebilir olduğunu doğrular. pnpm plugins:sync:checkçalıştırır.publish_scope=all-publishableveref=<release-sha>ilePlugin NPM Releasetetikler.- Aynı scope ve SHA ile
Plugin ClawHub Releasetetikler. - Sürüm etiketi, npm dist-tag ve kaydedilmiş
preflight_run_idileOpenClaw NPM Releasetetikler.
latest sürümüne kararlı yükseltme açıkça belirtilir:
Plugin NPM Release ve Plugin ClawHub Release iş akışlarını yalnızca odaklı onarım veya yeniden yayımlama işleri için kullanın. Seçili bir Plugin onarımı için
plugin_publish_scope=selected ve plugins=@openclaw/name değerlerini
OpenClaw Release Publish iş akışına geçirin ya da OpenClaw paketinin yayımlanmaması gerektiğinde alt iş akışını doğrudan tetikleyin.
NPM iş akışı girdileri
OpenClaw NPM Release şu operatör kontrollü girdileri kabul eder:
tag:v2026.4.2,v2026.4.2-1veyav2026.4.2-beta.1gibi zorunlu sürüm etiketi;preflight_only=trueolduğunda yalnızca doğrulama preflight’ı için mevcut tam 40 karakterlik iş akışı dalı commit SHA’sı da olabilirpreflight_only: yalnızca doğrulama/derleme/paket içintrue, gerçek yayımlama yolu içinfalsepreflight_run_id: gerçek yayımlama yolunda zorunludur; böylece iş akışı başarılı preflight çalışmasından hazırlanmış tarball’ı yeniden kullanırnpm_dist_tag: yayımlama yolu için npm hedef etiketi; varsayılanıbeta
OpenClaw Release Publish şu operatör kontrollü girdileri kabul eder:
tag: zorunlu sürüm etiketi; zaten mevcut olmalıdırpreflight_run_id: başarılıOpenClaw NPM Releasepreflight çalışma kimliği;publish_openclaw_npm=trueolduğunda zorunludurnpm_dist_tag: OpenClaw paketi için npm hedef etiketiplugin_publish_scope: varsayılanıall-publishable;selecteddeğerini yalnızca odaklı onarım işleri için kullanınplugins:plugin_publish_scope=selectedolduğunda virgülle ayrılmış@openclaw/*paket adlarıpublish_openclaw_npm: varsayılanıtrue; yalnızca iş akışını sadece Plugin onarım düzenleyicisi olarak kullanırkenfalseyapınwait_for_clawhub: varsayılanıfalse; böylece npm kullanılabilirliği ClawHub sidecar tarafından engellenmez; yalnızca iş akışı tamamlanmasının ClawHub tamamlanmasını da içermesi gerektiğindetrueyapın
OpenClaw Release Checks şu operatör kontrollü girdileri kabul eder:
ref: doğrulanacak dal, etiket veya tam commit SHA. Gizli içeren denetimler, çözümlenmiş commit’in bir OpenClaw dalından veya sürüm etiketinden erişilebilir olmasını gerektirir.run_release_soak: kararlı/varsayılan sürüm denetimlerinde kapsamlı canlı/E2E, Docker sürüm yolu ve all-since upgrade-survivor soak kapsamını seçer.release_profile=fulltarafından zorunlu olarak açılır.
- Kararlı ve düzeltme etiketleri
betaveyalatestetiketlerinden birine yayımlanabilir - Beta ön sürüm etiketleri yalnızca
betaetiketine yayımlanabilir OpenClaw NPM Releaseiçin tam commit SHA girdisine yalnızcapreflight_only=trueolduğunda izin verilirOpenClaw Release ChecksveFull Release Validationher zaman yalnızca doğrulamadır- Gerçek yayımlama yolu, preflight sırasında kullanılan aynı
npm_dist_tagdeğerini kullanmalıdır; iş akışı yayımlamadan önce bu metadata’nın devam ettiğini doğrular
Kararlı npm sürüm sırası
Kararlı bir npm sürümü çıkarırken:preflight_only=trueileOpenClaw NPM Releaseçalıştırın- Bir etiket mevcut olmadan önce, preflight iş akışının yalnızca doğrulama amaçlı kuru çalıştırması için mevcut tam iş akışı dalı commit SHA’sını kullanabilirsiniz
- Normal önce beta akışı için
npm_dist_tag=betaseçin veya yalnızca bilinçli olarak doğrudan kararlı yayımlama istediğinizdelatestseçin - Tek bir manuel iş akışından normal CI artı canlı prompt cache, Docker, QA Lab,
Matrix ve Telegram kapsamı istediğinizde sürüm dalı, sürüm etiketi veya tam commit SHA üzerinde
Full Release Validationçalıştırın - Bilinçli olarak yalnızca deterministik normal test grafiğine ihtiyacınız varsa, bunun yerine sürüm ref’i üzerinde manuel
CIiş akışını çalıştırın - Başarılı
preflight_run_iddeğerini kaydedin - Aynı
tag, aynınpm_dist_tagve kaydedilmişpreflight_run_idileOpenClaw Release Publishçalıştırın; OpenClaw npm paketini yükseltmeden önce dışsallaştırılmış Plugin’leri npm ve ClawHub’a yayımlar - Sürüm
betaüzerinde yayımlandıysa, bu kararlı sürümübetaetiketindenlatestetiketine yükseltmek için özelopenclaw/releases-private/.github/workflows/openclaw-npm-dist-tags.ymliş akışını kullanın - Sürüm bilinçli olarak doğrudan
latestetiketine yayımlandıysa vebetaaynı kararlı derlemeyi hemen izlemeliyse, her iki dist-tag’i de kararlı sürüme yönlendirmek için aynı özel iş akışını kullanın veya zamanlanmış kendi kendini iyileştiren senkronizasyonununbetaetiketini daha sonra taşımasına izin verin
NPM_TOKEN gerektirirken, herkese açık repo yalnızca OIDC yayımlamayı korur.
Bu, doğrudan yayımlama yolunu ve önce beta yükseltme yolunu hem belgelenmiş hem de operatörün görebileceği durumda tutar.
Bir maintainer yerel npm kimlik doğrulamasına geri dönmek zorundaysa, tüm 1Password
CLI (op) komutlarını yalnızca ayrılmış bir tmux oturumu içinde çalıştırın. op komutunu ana agent kabuğundan doğrudan çağırmayın; bunu tmux içinde tutmak prompt’ları, uyarıları ve OTP işlemeyi gözlemlenebilir kılar ve yinelenen host uyarılarını önler.
Herkese açık referanslar
.github/workflows/full-release-validation.yml.github/workflows/package-acceptance.yml.github/workflows/openclaw-npm-release.yml.github/workflows/openclaw-release-checks.yml.github/workflows/openclaw-cross-os-release-checks-reusable.ymlscripts/resolve-openclaw-package-candidate.mjsscripts/openclaw-npm-release-check.tsscripts/package-mac-dist.shscripts/make_appcast.sh
openclaw/maintainers/release/README.md
konumunda kullanır.