Get started
İlk katılım sürecinin yeniden tasarımı
İlk katılım yeniden tasarımı uygulama planı
Yaşayan belge. Bu sayfa, koruyucu ilk katılım yeniden tasarımını uygulama düzeyinde izler ve her aşama tamamlandıkça güncellenir. Son aşama birleştirildiğinde bu sayfa, kullanıcıya yönelik ilk katılım kılavuzu olarak yeniden yazılır ve belge gezintisine eklenir. O zamana kadar kasıtlı olarak
docs.jsoniçinde yer almaz.
Ana hedef
Teknik bilgisi olmayan bir kullanıcı openclaw onboard yazar (veya uygulamayı açar) ve
tek bir etkileşimli varlık tarafından karşılanır: sistem koruyucusu OpenClaw ("koruyucu"
yalnızca dahili addır; kullanıcı her zaman "OpenClaw" adını görür). Bu varlık kullanıcının yapay zekâsını
bulur, sorular yerine duyurulan varsayılanlarla her şeyi kurar, aracısını görünür bir kimlik anıyla
doğurur ve sonrasında sistemin bakım sorumlusu olarak sonsuza kadar erişilebilir kalır.
Varsayılan olarak sihirli, tek bir onay sınırı, çıkmaz yol yok.
Tasarım ilkeleri (kararlaştırılmıştır, gelişigüzel yeniden tartışmayın):
- Kolayca geri alınabilen duyurulmuş varsayılanlar, ilerlemeyi engelleyen soruların yerini alır. Tek kesin gereksinim, çalışan çıkarımdır; diğer her şey bir tekliftir.
- Sıfırıncı soru onay sınırıdır: "Tam erişim" (önerilen), keşfin sessiz ve otomatik olduğu anlamına gelir; "Önce sor" ise yapay zekâ taraması, uygulama taraması ve bellek kaynağı taraması dâhil her keşfi tek bir açık evet onayının arkasında tutar ve hiç tarama yapmayan tamamen manuel bir yol sunar.
- Aşamalı zekâyla kullanıcı arayüzü olarak konuşma: koruyucu yüzeyi, herhangi bir yapay zekâ çalışmadan önce mevcuttur (betikli diyalog); bir rota doğrulandığı anda model destekli hâle gelir ve bunu görünür biçimde belirtir. Asla zekâ taklidi yapmaz: rota doğrulanmadan önce serbest metin girildiğinde nazikçe "önce beynimi çalışır hâle getireyim" yanıtını verir.
- Doğuş bir törendir: aynı ileti dizisinde avatar değişir, aracı kendine ad verir ve kendi yüzünü seçer. Koruyucu hiyerarşiyi bir kez öğretir: "sistem hakkında bana sor veya doğrudan aracına sor — o iletir."
- Güven, kaynağa göre kademelendirilir: resmî katalog girdileri önceden seçilebilir; üçüncü taraf ClawHub Skills öğeleri, model sıralamasından bağımsız olarak asla önceden seçilmez ve etiketleri, yayıncının kodunu yüklediklerini belirtir.
- Yapılandırılmış kurulumlar dokunulmazdır: ilk katılımın yeniden çalıştırılması bir doğrulama geçişidir. Kurulumu asla yeniden uygulamaz ve Gateway hizmetini asla yeniden başlatmaz.
- Terminal bir sorudan ziyade yedek seçenektir: bir Gateway erişilebilir olduğunda tarayıcı panosunu tercih edin; asla "terminal mi, tarayıcı mı?" diye sormayın.
- Zayıf modeller daraltılmış bir yüzey kullanır (otomatik
localModelLean) ve bu, araçlar, kod modu veya bağlam pencereleri terimleriyle değil, sade bir dille açıklanır.
Mevcut yayımlanmış akış (1-3. aşamalardan sonra)
Yeni bir macOS kurulumunda openclaw onboard, sorunsuz yol — toplam dört Enter:
- Güvenlik notu → onaylamak için bir Enter (kalıcı olarak kaydedilir; bir daha asla sorulmaz).
- Sıfırıncı soru: "Her şeyi nasıl kurmalıyım?" — Tam erişim (önerilen)
veya Önce sor.
wizard.accessModeolarak kalıcı hâle getirilir; yeniden çalıştırmalarda kaydedilmiş seçim varsayılan olur. Korumalı + "manuel olarak yapılandır", herhangi bir tarama yapmadan sağlayıcı seçiciye ulaşır ve bellek kaynağı taramasını da atlar. - Keşif gösterisi: kodlama CLI'larını, ortam anahtarlarını ve yerel çalışma zamanlarını algılar; kodlama aracıları bulunduğunda esprili bir bildirim gösterir; adayları sırayla canlı olarak test eder ve hataları sessizce tek bir özet satırında toplar (ayrıntılar "Diğer seçenekleri gör" arkasındadır). Çalışan ilk rota, tam seçiciye tek tuşla ulaşılabilen bir varsayılan olarak duyurulur; seçenekleri incelemek ve atlamak, çalışan rotayı korur.
- Bellek içe aktarma teklifi (Claude Code / Codex / Hermes); keşif reddedildiğinde atlanır.
- Yalnızca yeni kurulumlar: standart kurulum planı otomatik olarak uygulanır (çalışma alanı, Gateway hizmeti, oturumlar — etkileşimli "evet" seçeneğinin çalıştırdığı planın aynısı). Yapılandırılmış kurulumlar "zaten kurulu" yazdırır ve hizmete asla dokunmaz.
- Uygulama önerileri: doğrulanmış model tarafından resmî
kataloglar + ClawHub ile eşleştirilen yüklü uygulamalar; resmî kanal Plugin'leri
önceden işaretlenmiş olarak gelir, üçüncü taraf Skills öğeleri bir uyarı etiketiyle isteğe bağlıdır. Atlanabilir;
devre dışı bırakma anahtarı
wizard.appRecommendations. - Doğuş: bir Gateway erişilebilir olduğunda tarayıcıya aktarım açılır (GUI) veya
pano URL'si yazdırılır (başsız/SSH) ve Control UI'ın
bağlanması beklenir — "Pano bağlandı — tarayıcınızda devam ediliyor." Aksi durumda veya
--tuiile terminal TUI, önyükleme doğuş mesajıyla başlatılır ve aracı kendini tanıtır.
Uzak Gateway ilk katılımı, eski etkileşimli aktarımını
(handoffMode: "chat") korur; kurulum uzak Gateway üzerinde uygulanmalıdır.
Aşamalar
| # | Aşama | Yüzey | Durum |
|---|---|---|---|
| 1 | Yüklü uygulama Plugin önerileri (tarama, adaylar, yapay zekâ eşleştiricisi, sihirbaz adımı, device.apps Node komutu) |
klasik + yönlendirmeli CLI | birleştirildi (#109668) |
| 2 | CLI koruyucu omurgası (sıfırıncı soru, keşif gösterisi, otomatik uygulama + doğuş) | yönlendirmeli CLI | birleştirildi (a83ed13204f1) |
| 3 | Önce tarayıcıya aktarım (GUI oturumu algılama, pano bağlantısını bekleme, yedek seçenek olarak TUI) | CLI → web | birleştirildi (#110054) |
| 4 | Web koruyucu yüzeyi (seçenek kartları, openclaw.chat üzerinde türü belirlenmiş question alanı, sihirbaz adımı yansıtma, ilk çalıştırma aktarımı) |
Control UI | birleştirildi (#110141, #110242) |
| 5 | Doğuş ve önyükleme (tek seferlik semantiğe sahip öneri deposu, kendini adlandırma doğum dizisi, yeni kurulumdan sonra otomatik doğuş aktarımı; avatar kademeleri ertelendi) | aracı önyüklemesi | birleştirildi (#110173, #110331) |
| 6 | Koruyucu varlığı PR1 (sabitlenmiş kenar çubuğu girdisi, Ayarlar'da OpenClaw'a Sor, normal arayüz çerçevesinde bakım sorumlusu karşılaması; olay yorumları ve kanal çağrısı PR2'dir) | web + kanallar | birleştirildi (#110269) |
| 7 | Dayanıklılık (bozuk yapılandırmada koruyucuya erişim, kısmi yüzey kurtarma, otomatik doctor) | Gateway | takip çalışması |
Aşama başına uygulama notları
Aşama 1 — uygulama önerileri (PR #109668)
- Tarayıcı:
src/infra/installed-apps.ts(TCC gerektirmeyen macOS numaralandırması; sembolik bağlantılı.apppaketlerini izler). - Adaylar: resmî kataloglar + ClawHub araması, toplam 20s bütçe, çevrimdışıyken
yalnızca katalog adaylarına sorunsuz gerileme. Katalog girdileri, üst düzey
idiçermeyen paket manifestleridir — adaylar çözümlenmiş Plugin kimliğine göre anahtarlanır (gerçek paketlenmiş kataloglara karşı regresyon testi yapılmıştır; bir zamanlarentry.idile anahtarlama tüm kataloğu tek girdide birleştirip tüm resmî önerileri düşürüyordu). - Yapay zekâ eşleştiricisi: doğrulanmış rotada tek bir tamamlama
(
src/system-agent/setup-app-recommendations.ts); elle düzenlenmiş paket kimliği eşlemesi yoktur — model, tesadüfi ad çakışmalarını reddeder. Çıktı, çözümlenmiş modelin kendimaxTokensbütçesiyle sınırlanır (açık bir sınır geçirilmediğinde akış katmanı bunu uygular). - Tedarik zinciri koruması: ClawHub listeleme metni yayıncı tarafından kontrol edilir ve eşleştirici istemine ulaşır; dolayısıyla bir listeleme kendisini "önerilen" olarak tanıtabilir. Yalnızca resmî katalog girdileri önceden seçilebilir; ClawHub Skills öğeleri her zaman açıkça işaretlenmelidir ve "üçüncü taraf ClawHub Skill öğesi; yayıncısının kodunu yükler" şeklinde etiketlenir.
- Node komutu
device.apps(TS Node ana bilgisayarı, Android zarf uyumluluğu); paylaşım varsayılan olarak kapalıdır; Gateway devre dışı bırakma anahtarıwizard.appRecommendations. - Sunum, klasik sihirbaz ve yönlendirmeli koruyucu akışında
(
src/wizard/setup.app-recommendations.ts) yer alır; önyükleme sonuna yeniden hedefleme 5. aşamada kalır (hizmet zaten enjekte edilebilir bir envanter kaynağı alır). Tek seferlik semantik (yalnızca kabul edilene kadar teklif etme, kaydedilmiş tarama) de 5. aşama deposuyla gelir; bugün yeniden çalıştırıldığında tekrar teklif edilir. - Ayrıca düzeltildi: özel
completeSetupInferenceistemleri artık 32 token'lık doğrulama sondası çıktı sınırını devralmaz (SETUP_INFERENCE_TEST_MAX_TOKENSyalnızca "OK yanıtı ver" sondasına uygulanır).
Aşama 2 — CLI koruyucu omurgası (PR #109841)
src/commands/onboard-guided.tsiçinde akışın yeniden düzenlenmesi; uzak Gateway ilk katılımı,handoffMode: "chat"aracılığıyla eski sohbet aktarımını korur.- Sıfırıncı soru
wizard.accessMode("full" | "guarded") değerini kalıcılaştırır; yeniden çalıştırmalar varsayılan olarak kaydedilmiş seçimi kullanır (varsayılanı kabul etmek, korumalı ayarı asla sessizce tam erişime düşüremez). Korumalı + manuel,listManualSetupInferenceOptionskullanır (yalnızca yapılandırma/manifestler, sondalama yoktur) ve bellek kaynağı taramasını atlar. - Keşif: sessiz hata toplama (tek özet satırı; ayrıntılar "Diğer seçenekleri gör" arkasındadır), kodlama aracısı bildirimi, duyurulmuş rota varsayılanı. Bildirimdeki oturum sayıları, düşük maliyetli bir oturum sayımı bağlantısı bulunana kadar ertelenmiştir (yalnızca nitel ifade).
- Yeni kurulumlar:
applySystemAgentSetup(belirlenimci etkileşimli "evet"), ardından önyükleme mesajıyla başlatılanlaunchTuiCliüzerinden doğuş. Yapılandırılmış kurulumlar (önceden mevcut model veya Gateway yapılandırması — sihirbaz zaman damgaları hiçbir şeyi kanıtlamaz; configure/doctor ile paylaşılır): yalnızca doğrulama — uygulama yok, Gateway hizmetini yeniden başlatma yok. Uygulama hatası, etkileşimli sohbete geri döner.
Aşama 3 — önce tarayıcıya aktarım (PR #110054, birleştirildi)
src/commands/onboard-browser-handoff.tsyalnızca grafik oturumu algılamasını (SSH_CONNECTION/SSH_TTY; Linux'taDISPLAY/WAYLAND_DISPLAY) ve 60 saniyelik GUI / 300 saniyelik SSH beklemesini yönetir. Yönlendirmeli ilk katılım şu anda devri yalnızca macOS'ta etkinleştirir;--tuive diğer platformlar terminal çıkış yolunu korur. Linux/Windows desteği sonraki bir çalışmadır.- Pano bağlantıları, klasik sonlandırmayla aynı
resolveAdvertisedControlUiLinks,resolveLocalControlUiProbeLinksvebuildOnboardingControlUiUrlyardımcılarını kullanır. Tarayıcı başlatma, paylaşılanopenUrlyardımcısını kullanır. - Hazır olma durumu, mevcut
system-presenceRPC'sini yapılandırılmış paylaşılan gizli anahtarı sunan CLI modunda bir geri döngü istemcisi olarak yoklar — bu, heropenclawkomutunun kullandığı güvenilir yoldur. Ham paylaşımlı kimlik doğrulamalı bir Control UI istemcisi, SecretRef gateway'lerinde "cihaz kimliği gerekli" hatasıyla reddedilir. Erişilebilirlik ön kontrolü, bekleme döngüsüyle aynı hedefi (ve gizli anahtarı) çözümler; böylece geçit ile bekleme, kimlik doğrulama konusunda asla çelişemez. Devir yalnızca, bağlı biropenclaw-control-ui/webchatvarlık satırı başlatma öncesi temel çizgiye göre yeniyse tamamlanır (zaten açık olan bir pano bunu tamamlayamaz). gateway.controlUi.enabled: false, herhangi bir URL gösterilmeden önce kısa devre yapar.- Yalıtılmış, aynı yapılandırmaya sahip bir gateway üzerinde uçtan uca kanıtlandı: URL'yi yazdırma → gerçek tarayıcı bağlantısı → "Pano bağlandı — tarayıcınızda devam ediliyor" → terminal çıkış yolu yok. Daha önceki "token uyuşmazlığı" beklemesi bir test düzeneği artefaktıydı — aşağıdaki test çalışma kılavuzuna bakın.
Aşama 4 — web sorumlusu yüzeyi (birleştirildi: #110141, #110242)
openclaw.chatüzerinde, seçenek kartı bileşenini kullanan/custodiansayfası (2-4 kart, en fazla bir önerilen, her zaman atlanabilir);?onboarding=1üzerinden ilk katılım çerçevesi; model kurulumu ilk çalıştırma tamamlaması buraya devreder.- Yapılandırılmış sorular,
SystemAgentChatResultüzerinde türü belirlenmiş ve eklemeli birquestionalanıdır (seçenek başınareplymetni; düzyazı macOS uygulaması/TUI için her zaman bağımsızdır). Üreticiler: her iki ilk katılım karşılama çeşidi ve 2-4 kapalı seçenekli barındırılan sihirbaz seçme/onaylama adımları — gerçek kanal sihirbazları kart olarak işlenir. PR1'deki dize işaretleyici geçici çözümü silindi. - Oturum sahipliği, gateway URL'si + sunulan her kimlik bilgisiyle (token, parola, bootstrap token'ı, saklanan cihaz token'ı — geçici hello kesintileri boyunca kalıcı) sınırlandırılır; başarısız kullanıcı sıraları asla yeniden oynatılamaz; hassas girdi olduğu gibi gönderilir ve transkriptte maskelenir.
Aşama 5 — çıkış ve bootstrap (birleştirildi: #110173, #110331)
- Sorumlu, adsız bir ajan oluşturur (araç çağrısı); ajanın bootstrap süreci
kendi adını belirleyerek açılır. PR1, seremoniyi üç adımla sınırlandırılmış olarak sunar (ad → öz
satırı → beceriler sorusu) ve kendi çizdiği avatar/görüntü üretme basamaklarını
(model tarafından oluşturulan adaylar → hazır işaretler → logoyu koru) sonraki bir çalışmaya erteler. Aynı
ileti dizisi, avatar değişimi; pençe işareti sorumluya ayrılmış kalır. Üzerinde
anlaşılan kimlik iki kez kalıcılaştırılır:
IDENTITY.md/SOUL.mdiçine (ajanın okuduğu) veopenclaw agents set-identityaracılığıyla (kanalların ve UI'ın gösterdiği). - Öneriler (aşama 1 hizmeti, tek seferlik anlam bilgisiyle saklanan tarama),
bootstrap dosyası kaldırılmadan önceki son bootstrap adımı olarak sunulur: "asgari küme
mi, azami kolaylık mı?" Bootstrap, saklanan teklifi
openclaw onboard recommendations --jsonaracılığıyla okur (yalnızca opak kurulum kimlikleri) ve seçim işlendikten sonra onaylar; böylece bir daha asla sormaz. Kanal bağlama düğmeleri kanal başına kurulum çalışma kılavuzları taşır; ajan kimlik bilgilerini konuşarak toplar ve yapılandırma yazma işlemlerini sorumluya aktarır ("OpenClaw'a soruluyor…" kurallı ifadedir). - Kendi kendine öğrenme duyurulmaz, sorulur ve beceri atölyesi onayı işlevini de görür; ClawHub'ın sürüm güveni, tarama, doğrulama ve bütünlük kontrollerini, ayrıca yayıncı kodu uyarısını açıklayın — asla her sürümün imzalı olduğunu ima etmeyin.
- Otomatik çıkış yayımlandı: yeni bir kurulum yapılandırması uygulandığında çıkış duyurulur ve
devir gerçekleştirilir (terminal TUI / gateway istemcileri için
open-agent); web sayfası, "Uyan, dostum!" taslağı önceden doldurulmuş olarak ajan sohbetine ulaşır. Devir, yalnızca yazma sonrası doğrulama temizse tetiklenir. Silme sonrasında sıfır ajan olduğunda otomatik işlem yerine seçenek sunulması, sonraki iyileştirme olarak kalır.
Aşama 6 — sorumlu varlığı (PR1 birleştirildi: #110269; yorum/çağırma PR2'de)
- PR1'de yayımlandı: varsayılan olarak sabitlenmiş "OpenClaw" kenar çubuğu girdisi (yeni profiller;
mevcut kullanıcılar kayıtlı sabitlemelerini korur ve özelleştirme/More üzerinden erişir), ilk Settings girdisi olarak "OpenClaw'a
Sor" ve bakım görevlisi selamlamasını isteyen normal çerçeveli
/custodianziyaretleri (ilk katılım karşılama çeşidi yok); Exit setup yalnızca ilk katılım modunda işlenir. Yerleşik satır içi Settings bölmesi, paylaşılan konuşma görünümü çıkarımı gerektirir (sonraki çalışma). - Clippy karşıtı güvenlik sınırlarına sahip olay tepkili yorumlar: yalnızca önemli veya başarısız değişiklikler, istenmediği sürece Settings ziyareti başına en fazla bir kez. Aynı olay bağlantı noktası, sorumluyu daha sonra bozulmuş kimlik doğrulamanın veya çalışmayan kanalların sesi hâline getirir.
- Kanallar: günlük kullanımda görünmez (ajan aktarır); açık çağırmayla ve aynı ileti dizisindeki ajan devre dışı olaylarında, platformun izin verdiği yerlerde kendi adı ve pençe avatarıyla erişilebilir.
- Kurulumda zayıf model algılandı:
localModelLeanotomatik olarak ayarlanır ve sorumlu, yükseltme teklifiyle birlikte bunu sade bir dille belirtir. - Sorumlu, dahili takma adını bilir ("bazıları bana sorumlu diyor — OpenClaw da olur") ve ajandan her zaman adıyla söz eder.
Aşama 7 — dayanıklılık (oluşturmadan önce sahip kararı gerekiyor)
İlk taslak — "yapılandırma ne kadar bozuk olursa olsun sorumluya erişilebilmelidir" — deponun güvenlik politikasıyla çelişiyor: kök kılavuz, yapılandırma yapısal olarak geçersiz olduğunda Gateway'in başlatmayı reddettiğini ve yalnızca SecretRef sahibi hatalarının yapılandırılmış-kullanılamaz yeteneklere indirgendiğini belirtir. Geçersiz yapılandırmadan herhangi bir yüzey sunmak, bir uygulama ayrıntısı değil, politika değişikliğidir. İki kapsamdan birini seçin:
- Seçenek A (önerilen, politikayla uyumlu): CLI tarafında otomatik doctor. Bir
gateway veya CLI başlatması bilinen şekilli geçersiz bir yapılandırmayla başarısız olduğunda CLI,
openclaw doctor --fixçalıştırmayı teklif eder (veya onayla çalıştırır), ardından bir kez yeniden dener ve durumu açıkça bildirir. Gateway davranışı değişmez; sorumluya mevcut indirgenmiş SecretRef yolu ve terminal üzerinden erişilmeye devam edilir. - Seçenek B (açık sahip onayı + güvenlik incelemesi gerekir): gateway asgari yüzey modu. Yapısal olarak geçersiz yapılandırmada, yalnızca sorumlu konuşmasını ve doctor eylemlerini sunan sıkı şekilde kilitlenmiş bir yüzey başlatılır. Bu, kapalı kalarak hata verme başlatma sözleşmesini yeniden yazar ve herhangi bir koddan önce kendi giriş koruma yaklaşımını tanımlamalıdır.
4-6. aşamalardan kalan sonraki çalışmalar (izleniyor, zamanlanmadı): çıkış için avatar/görüntü üretme
basamakları; türü belirlenmiş question alanının macOS uygulamasında işlenmesi;
sorumlu için yerleşik satır içi Settings bölmesi (paylaşılan konuşma görünümü
çıkarımı gerekir); olay tepkili yorumlar ve kanal çağırma/ajan devre dışı kurtarma
(aşama 6 PR2); zayıf modeller için otomatik localModelLean; mevcut
kullanıcıların kayıtlı kenar çubuğu sabitlemelerinin OpenClaw girdisini benimseyip benimsememesi.
Test ve yayımlama çalışma kılavuzu (zorlukla edinildi; 4-6. aşamalardan önce okuyun)
-
OPENCLAW_STATE_DIR, Gateway hizmetini yalıtmaz. LaunchAgent etiketi (ai.openclaw.gateway) makine genelindedir: yalıtılmış bir durum diziniyle yapılan yeni kurulum ilk katılım testi, gerçek makinenin hizmetini YENİDEN YAZAR ve YENİDEN BAŞLATIR (sarmalayıcı betikler yalıtılmış dizinin içine yerleşir; o dizin temizlendiğinde bir sonraki hizmet başlangıcı bozulur). Her yeni kurulum testinden sonra gerçek ortamdanopenclaw gateway install --force && openclaw gateway restartile geri yükleyin ve plist'i doğrulayın. Ürün için sonraki çalışma: durum dizini kapsamlı hizmet etiketleri veya yabancı bir hizmeti algılayan ilk katılım. -
Güvenli uçtan uca düzenek: yalıtılmış yapılandırmayı bir
gatewaybölümüyle önceden doldurun (böylece ilk katılım yapılandırılmış kurulum yolunu izler ve hizmete asla dokunmaz) veopenclaw gateway runkomutunu boş bir bağlantı noktasında düz bir token ile normal bir ön plan işlemi olarak çalıştırın. Bu düzenek, gerçek bir tarayıcı bağlantısı dâhil olmak üzere 3. aşama döngüsünü kanıtladı. -
Kimlik doğrulama yolları yalnızca kimlik bilgilerine değil, istemci kimliğine göre de değişir. Varlık ve diğer operatör okumaları, aynı yapılandırmadaki kimlik bilgilerini kullanan CLI modunda bir geri döngü istemcisini kullanır. Token kimlik doğrulamalı gateway'ler paylaşılan gizli anahtarı gerektirir; SecretRef/none gateway'leri token olmadan güvenilir geri döngü kimlik doğrulamasına geri dönebilir. Control UI olarak tanımlanan bir tarayıcı istemcisi, cihaz kimliği veya güvenli bağlam geri döngü izni gerektirir. FARKLI bir yapılandırma sunan gateway'e karşı kimlik doğrulaması yapan bir sonda (LaunchAgent tuzağına bakın) "token uyuşmazlığı" hatasıyla başarısız olur — bu artefakt 3. aşamayı kısa süreliğine bekletti.
-
Tamamlama sondaları:
runSetupInferenceTest, doğrulama sondasını 32 çıktı token'ıyla sınırlar; özel istemler sınırı atlar ve modelin kendimaxTokensdeğeriyle sınırlandırılır. Akıl yürütme modelleri bu bütçeyi önce gizli akıl yürütmeyle tüketir — boş metinli bir sıra genellikle bütçenin orada tükendiği anlamına gelir. -
Ajanın yayımlanması, tam HEAD üzerinde barındırılan CI gerektirir. Ağır
CIiş akışı, kuruluş yükü altında gönderimlerde kuyruğa girmeyebilir; bakımcı geri dönüşü, PR dalında bir sürüm geçidi tetiklemesidir:bash gh workflow run ci.yml --ref <branch> -f target_ref=<head-sha> -f release_gate=true -f pull_request_number=<pr>Çalıştırma,
head_shaeşleşmesi için dal referansında olmalıdır ve başlıkCI release gate <sha>olur; bunuscripts/verify-pr-hosted-gates.mjskabul eder. Ardından her zamanki gibiscripts/prhazırlama/birleştirme işlemini yapın. -
CI'ın odaklanmış testlerin ötesinde zorunlu kıldığı geçitler: doküman haritası (herhangi bir doküman sayfası eklendikten sonra
pnpm docs:map:gen), oxlint (no-map-spread,max-lines— dosyaları bölün, asla bastırmayın),check:test-types, knip ölü kod denetimi (yalnızca üretimin tükettiği öğeleri dışa aktarın; testleri genel API'ler üzerinden yönlendirin) ve canlı test parçası sınıflandırıcısı (test/scripts/test-live-shard.test.ts, tüm yeni*.live.test.tsöğelerini listelemelidir).
Karar günlüğü
- Onay öncelikli değil, acil durdurma anahtarlı sihirli tarama (aşama 1; kalıcı çıktı, taramadan önce model ve ClawHub kullanımını açıklar ve sonuç notu bunu yineler).
- Node
device.appskomutunu içeren tam dikey akış (aşama 1). - Üçüncü taraf ClawHub Skills hiçbir zaman önceden seçilmez ve yayıncının kodunun yükleneceği belirtilir; resmî girdiler önceden işaretlenebilir (aşama 1, yayımlanmış güvenlik duruşu).
- Üç değil, iki erişim kartı; onay seçimin başına alınmıştır (aşama 2).
- Engelleyici bir düğme değil, duyuruyla otomatik çatlama (aşamalar 2/5).
- Öncelik tarayıcıda: terminalde çatlama yedek seçenektir, hiçbir zaman "terminal mi tarayıcı mı?" sorusu değildir (aşama 3).
- Gözetmen yalnızca web/CLI ile sınırlı kalmaz; kanalda bulunur (çağırma + kurtarma) (aşama 6).
- Çatlama, avatar değişimiyle aynı ileti dizisinde gerçekleşir; tamamlandıktan sonra uygulama normal kullanıcı arayüzüne geçer (aşama 5).
- Ayarlar yüzeyi "Ayarlar" adını korur; gözetmen bunun yerini almak yerine burada (ve kenar çubuğunda) bulunur (aşama 6).
- Seçenek kartları sınırlandırılmıştır: 2-4 seçenek, tam olarak bir önerilen seçenek ve her zaman atlanabilir; aynı bileşen ilk katılımı ve ajan soru aracını destekler (aşama 4).
- "OpenClaw'a soruluyor…" standart yetkilendirme kalıbıdır; ruhlar renk katabilir, araç anlatımı sade kalır (aşama 5).
- Kullanıcıya yönelik metin, zayıf model kırpmasını açıklarken hiçbir zaman "kod modu", "araçlar" veya "bağlam penceresi" ifadelerini kullanmaz (aşama 6).
Bilinen eksikler ve takip işleri
- LaunchAgent etiketi durum dizini kapsamına bağlı değildir (yukarıdaki test tuzağı; ayrıca gerçek bir çoklu örnek ürün eksiğidir).
- Önerilerin yalnızca bir kez sunulma semantiği ve saklanan tarama (aşama 5); yeniden çalıştırmalar şu anda tekrar sunar.
- Tarayıcıya aktarım yalnızca macOS'ta kullanılabilir; Linux/Windows desteği beklemededir.
- Oturum sayısı nüktesi niteldir; sayımlar için düşük maliyetli bir oturum sayma bağlantı noktası gerekir.
- Tarayıcıya aktarım normal panoya ulaşır; ilk katılım modu gözetmenine doğrudan bağlantı aşama 4 ile gelir.