chore(i18n): refresh tr translations
This commit is contained in:
openclaw-docs-i18n[bot]
parent
adfcba61e9
commit
63e5471b8a
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Bağlantı/kimlik doğrulama sorunlarınız var ve rehberli düzeltmeler istiyorsunuz
|
||||
- Güncelleme yaptınız ve temel bir doğrulama istiyorsunuz
|
||||
- Bağlantı/kimlik doğrulama sorunları yaşıyor ve yönlendirmeli düzeltmeler istiyorsunuz
|
||||
- Güncelleme yaptınız ve bir sağlama kontrolü istiyorsunuz
|
||||
summary: '`openclaw doctor` için CLI referansı (sağlık kontrolleri + rehberli onarımlar)'
|
||||
title: Doktor
|
||||
x-i18n:
|
||||
generated_at: "2026-04-30T09:12:14Z"
|
||||
generated_at: "2026-04-30T20:05:44Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 9985c84d23861dd9468a4659ee00519573fe6d540c436548da0a68067dbabc4c
|
||||
source_hash: 265d82a10da086cf89687886e491be018a720b70021e0b26bd8f39b25a907e14
|
||||
source_path: cli/doctor.md
|
||||
workflow: 16
|
||||
---
|
||||
@ -36,37 +36,38 @@ openclaw doctor --generate-gateway-token
|
||||
|
||||
- `--no-workspace-suggestions`: çalışma alanı belleği/arama önerilerini devre dışı bırak
|
||||
- `--yes`: sormadan varsayılanları kabul et
|
||||
- `--repair`: önerilen onarımları sormadan uygula
|
||||
- `--fix`: `--repair` için diğer ad
|
||||
- `--force`: gerektiğinde özel servis yapılandırmasının üzerine yazmak dahil agresif onarımları uygula
|
||||
- `--non-interactive`: istemler olmadan çalıştır; yalnızca güvenli geçişler
|
||||
- `--generate-gateway-token`: Gateway belirteci oluştur ve yapılandır
|
||||
- `--deep`: ek Gateway kurulumları için sistem servislerini tara
|
||||
- `--repair`: sormadan önerilen onarımları uygula
|
||||
- `--fix`: `--repair` için takma ad
|
||||
- `--force`: gerektiğinde özel hizmet yapılandırmasının üzerine yazma dahil agresif onarımları uygula
|
||||
- `--non-interactive`: istemler olmadan çalıştır; yalnızca güvenli migrasyonlar
|
||||
- `--generate-gateway-token`: bir Gateway token'ı oluştur ve yapılandır
|
||||
- `--deep`: ek Gateway kurulumları için sistem hizmetlerini tara
|
||||
|
||||
Notlar:
|
||||
|
||||
- Etkileşimli istemler (anahtarlık/OAuth düzeltmeleri gibi) yalnızca stdin bir TTY olduğunda ve `--non-interactive` ayarlanmadığında çalışır. Başsız çalıştırmalar (cron, Telegram, terminal yok) istemleri atlar.
|
||||
- Performans: etkileşimsiz `doctor` çalıştırmaları, başsız sağlık denetimleri hızlı kalsın diye istekli Plugin yüklemesini atlar. Etkileşimli oturumlar, bir denetim katkılarını gerektirdiğinde Plugin'leri yine tamamen yükler.
|
||||
- `--fix` (`--repair` için diğer ad) `~/.openclaw/openclaw.json.bak` konumuna bir yedek yazar ve bilinmeyen yapılandırma anahtarlarını kaldırıp her kaldırmayı listeler.
|
||||
- Durum bütünlüğü denetimleri artık oturumlar dizinindeki sahipsiz konuşma dökümü dosyalarını algılar. Bunları `.deleted.<timestamp>` olarak arşivlemek etkileşimli onay gerektirir; `--fix`, `--yes` ve başsız çalıştırmalar bunları yerinde bırakır.
|
||||
- Etkileşimli istemler (anahtar zinciri/OAuth düzeltmeleri gibi) yalnızca stdin bir TTY olduğunda ve `--non-interactive` **ayarlanmamışsa** çalışır. Başsız çalıştırmalar (cron, Telegram, terminal yok) istemleri atlar.
|
||||
- Performans: etkileşimli olmayan `doctor` çalıştırmaları, başsız sağlık denetimlerinin hızlı kalması için hevesli Plugin yüklemeyi atlar. Etkileşimli oturumlar, bir denetimin katkılarına ihtiyaç duyması halinde Plugin'leri yine de tamamen yükler.
|
||||
- `--fix` (`--repair` için takma ad), `~/.openclaw/openclaw.json.bak` konumuna bir yedek yazar ve bilinmeyen yapılandırma anahtarlarını kaldırıp her kaldırmayı listeler.
|
||||
- Durum bütünlüğü denetimleri artık oturumlar dizinindeki yetim transkript dosyalarını algılar. Bunları `.deleted.<timestamp>` olarak arşivlemek etkileşimli bir onay gerektirir; `--fix`, `--yes` ve başsız çalıştırmalar bunları yerinde bırakır.
|
||||
- Doctor ayrıca eski cron işi biçimleri için `~/.openclaw/cron/jobs.json` (veya `cron.store`) dosyasını tarar ve zamanlayıcının çalışma zamanında bunları otomatik normalleştirmesi gerekmeden önce yerinde yeniden yazabilir.
|
||||
- Doctor, paketlenmiş global kurulumlara yazmadan eksik paketli Plugin çalışma zamanı bağımlılıklarını onarır. Root sahipli npm kurulumları veya sıkılaştırılmış systemd birimleri için `OPENCLAW_PLUGIN_STAGE_DIR` değerini `/var/lib/openclaw/plugin-runtime-deps` gibi yazılabilir bir dizine ayarlayın; bu değer `/opt/openclaw/plugin-runtime-deps:/var/lib/openclaw/plugin-runtime-deps` gibi bir yol listesi de olabilir; önceki kökler salt okunur arama katmanlarıdır ve son kök onarım hedefidir.
|
||||
- Doctor, eksik Plugin kimliklerini `plugins.allow`/`plugins.entries` içinden, ayrıca eşleşen kopuk kanal yapılandırmasını, Heartbeat hedeflerini ve kanal model geçersiz kılmalarını, Plugin keşfi sağlıklıyken kaldırarak bayat Plugin yapılandırmasını onarır.
|
||||
- Doctor, etkilenen `plugins.entries.<id>` girdisini devre dışı bırakıp geçersiz `config` yükünü kaldırarak geçersiz Plugin yapılandırmasını karantinaya alır. Gateway başlatma zaten yalnızca o bozuk Plugin'i atlar, böylece diğer Plugin'ler ve kanallar çalışmaya devam edebilir.
|
||||
- Gateway yaşam döngüsü başka bir denetleyici tarafından yönetildiğinde `OPENCLAW_SERVICE_REPAIR_POLICY=external` ayarlayın. Doctor yine Gateway/servis sağlığını raporlar ve servis dışı onarımları uygular, ancak servis kurma/başlatma/yeniden başlatma/önyükleme ve eski servis temizliğini atlar.
|
||||
- Linux'ta doctor etkin olmayan ek Gateway benzeri systemd birimlerini yok sayar ve onarım sırasında çalışan bir systemd Gateway servisi için komut/giriş noktası meta verilerini yeniden yazmaz. Etkin başlatıcıyı bilinçli olarak değiştirmek istediğinizde önce servisi durdurun veya `openclaw gateway install --force` kullanın.
|
||||
- Doctor, eski düz Talk yapılandırmasını (`talk.voiceId`, `talk.modelId` ve benzerleri) otomatik olarak `talk.provider` + `talk.providers.<provider>` biçimine geçirir.
|
||||
- Tek fark nesne anahtarı sırası olduğunda tekrarlanan `doctor --fix` çalıştırmaları artık Talk normalleştirmesini raporlamaz/uygulamaz.
|
||||
- Doctor bir bellek araması hazır olma denetimi içerir ve gömme kimlik bilgileri eksik olduğunda `openclaw configure --section model` önerebilir.
|
||||
- Doctor, hiçbir komut sahibi yapılandırılmadığında uyarır. Komut sahibi, yalnızca sahibin çalıştırabileceği komutları çalıştırmasına ve tehlikeli eylemleri onaylamasına izin verilen insan operatör hesabıdır. DM eşleştirme yalnızca birinin botla konuşmasına izin verir; ilk sahip önyüklemesi var olmadan önce bir göndericiyi onayladıysanız `commands.ownerAllowFrom` değerini açıkça ayarlayın.
|
||||
- Korumalı alan modu etkinse ancak Docker kullanılamıyorsa doctor, çözümle birlikte yüksek sinyalli bir uyarı bildirir (`install Docker` veya `openclaw config set agents.defaults.sandbox.mode off`).
|
||||
- Doctor, paketlenmiş global kurulumlara yazmadan eksik paketli Plugin çalışma zamanı bağımlılıklarını onarır. Root sahipli npm kurulumları veya güçlendirilmiş systemd birimleri için `OPENCLAW_PLUGIN_STAGE_DIR` değerini `/var/lib/openclaw/plugin-runtime-deps` gibi yazılabilir bir dizine ayarlayın; ayrıca `/opt/openclaw/plugin-runtime-deps:/var/lib/openclaw/plugin-runtime-deps` gibi bir yol listesi de olabilir; burada önceki kökler salt okunur arama katmanları, son kök ise onarım hedefidir.
|
||||
- Doctor, Plugin keşfi sağlıklı olduğunda eksik Plugin kimliklerini `plugins.allow`/`plugins.entries` içinden kaldırarak, ayrıca eşleşen sarkan kanal yapılandırmasını, heartbeat hedeflerini ve kanal model geçersiz kılmalarını kaldırarak bayat Plugin yapılandırmasını onarır.
|
||||
- Doctor, etkilenen `plugins.entries.<id>` girdisini devre dışı bırakarak ve geçersiz `config` yükünü kaldırarak geçersiz Plugin yapılandırmasını karantinaya alır. Gateway başlatması zaten yalnızca bu hatalı Plugin'i atlar, böylece diğer Plugin'ler ve kanallar çalışmaya devam edebilir.
|
||||
- Gateway yaşam döngüsünü başka bir supervisor yönetiyorsa `OPENCLAW_SERVICE_REPAIR_POLICY=external` ayarlayın. Doctor yine de Gateway/hizmet sağlığını bildirir ve hizmet dışı onarımları uygular, ancak hizmet kurma/başlatma/yeniden başlatma/bootstrap ve eski hizmet temizliğini atlar.
|
||||
- Linux'ta doctor, etkin olmayan ek Gateway benzeri systemd birimlerini yok sayar ve onarım sırasında çalışan bir systemd Gateway hizmeti için komut/entrypoint meta verilerini yeniden yazmaz. Etkin başlatıcıyı bilinçli olarak değiştirmek istediğinizde önce hizmeti durdurun veya `openclaw gateway install --force` kullanın.
|
||||
- Doctor, eski düz Talk yapılandırmasını (`talk.voiceId`, `talk.modelId` ve benzerleri) otomatik olarak `talk.provider` + `talk.providers.<provider>` içine migre eder.
|
||||
- Yinelenen `doctor --fix` çalıştırmaları, tek fark nesne anahtarı sırası olduğunda artık Talk normalleştirmesini bildirmez/uygulamaz.
|
||||
- Doctor bir bellek arama hazır olma denetimi içerir ve embedding kimlik bilgileri eksik olduğunda `openclaw configure --section model` önerebilir.
|
||||
- Doctor, hiçbir komut sahibi yapılandırılmadığında uyarır. Komut sahibi, yalnızca sahip komutlarını çalıştırmasına ve tehlikeli eylemleri onaylamasına izin verilen insan operatör hesabıdır. DM eşleştirme yalnızca birinin botla konuşmasına izin verir; ilk sahip bootstrap'i var olmadan önce bir göndericiyi onayladıysanız `commands.ownerAllowFrom` değerini açıkça ayarlayın.
|
||||
- Doctor, Codex modu ajanlar yapılandırıldığında ve operatörün Codex home'unda kişisel Codex CLI varlıkları bulunduğunda uyarır. Yerel Codex app-server başlatmaları izole ajan başına home'lar kullanır, bu nedenle bilinçli olarak yükseltilmesi gereken varlıkların envanterini çıkarmak için `openclaw migrate codex --dry-run` kullanın.
|
||||
- Sandbox modu etkinse ancak Docker kullanılamıyorsa doctor, giderimle birlikte yüksek sinyalli bir uyarı bildirir (`install Docker` veya `openclaw config set agents.defaults.sandbox.mode off`).
|
||||
- `gateway.auth.token`/`gateway.auth.password` SecretRef tarafından yönetiliyorsa ve geçerli komut yolunda kullanılamıyorsa doctor salt okunur bir uyarı bildirir ve düz metin yedek kimlik bilgileri yazmaz.
|
||||
- Bir düzeltme yolunda kanal SecretRef incelemesi başarısız olursa doctor devam eder ve erken çıkmak yerine bir uyarı bildirir.
|
||||
- Telegram `allowFrom` kullanıcı adı otomatik çözümlemesi (`doctor --fix`), geçerli komut yolunda çözümlenebilir bir Telegram belirteci gerektirir. Belirteç incelemesi kullanılamıyorsa doctor bir uyarı bildirir ve o geçiş için otomatik çözümlemeyi atlar.
|
||||
- Bir düzeltme yolunda kanal SecretRef incelemesi başarısız olursa doctor erken çıkmak yerine devam eder ve bir uyarı bildirir.
|
||||
- Telegram `allowFrom` kullanıcı adı otomatik çözümlemesi (`doctor --fix`), geçerli komut yolunda çözümlenebilir bir Telegram token'ı gerektirir. Token incelemesi kullanılamıyorsa doctor bir uyarı bildirir ve o geçiş için otomatik çözümlemeyi atlar.
|
||||
|
||||
## macOS: `launchctl` env geçersiz kılmaları
|
||||
|
||||
Daha önce `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (veya `...PASSWORD`) çalıştırdıysanız, bu değer yapılandırma dosyanızın önüne geçer ve kalıcı “yetkisiz” hatalarına neden olabilir.
|
||||
Daha önce `launchctl setenv OPENCLAW_GATEWAY_TOKEN ...` (veya `...PASSWORD`) çalıştırdıysanız, bu değer yapılandırma dosyanızı geçersiz kılar ve kalıcı “yetkisiz” hatalarına neden olabilir.
|
||||
|
||||
```bash
|
||||
launchctl getenv OPENCLAW_GATEWAY_TOKEN
|
||||
|
||||
@ -1,24 +1,24 @@
|
||||
---
|
||||
read_when:
|
||||
- Hermes veya başka bir ajan sisteminden OpenClaw'a geçmek istiyorsunuz
|
||||
- Plugin'e ait bir geçiş sağlayıcısı ekliyorsunuz
|
||||
summary: '`openclaw migrate` için CLI referansı (başka bir ajan sisteminden durumu içe aktar)'
|
||||
title: Geçiş Yap
|
||||
- Hermes veya başka bir ajan sisteminden OpenClaw'a geçiş yapmak istiyorsunuz
|
||||
- Plugin'e ait bir migrasyon sağlayıcısı ekliyorsunuz
|
||||
summary: '`openclaw migrate` için CLI referansı (başka bir ajan sisteminden durumu içe aktarın)'
|
||||
title: Geçiş yap
|
||||
x-i18n:
|
||||
generated_at: "2026-04-30T09:13:38Z"
|
||||
generated_at: "2026-04-30T20:05:46Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: d3db14c16b8f9dcbf86a4f12558cf4e8555aa9a255637034fb804148996a225e
|
||||
source_hash: ffcd9e874bdaa0a5195e712d4fccd7b3d53034cb362c7f7462e9c7df72477b1a
|
||||
source_path: cli/migrate.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
# `openclaw migrate`
|
||||
|
||||
Bir Plugin’e ait taşıma sağlayıcısı üzerinden başka bir aracı sisteminden durum içe aktarın. Birlikte gelen sağlayıcılar [Claude](/tr/install/migrating-claude) ve [Hermes](/tr/install/migrating-hermes) desteği sunar; üçüncü taraf Plugin’ler ek sağlayıcılar kaydedebilir.
|
||||
Başka bir aracı sisteminden durumu Plugin'e ait bir geçiş sağlayıcısı aracılığıyla içe aktarın. Paketle birlikte gelen sağlayıcılar Codex CLI durumunu, [Claude](/tr/install/migrating-claude) ve [Hermes](/tr/install/migrating-hermes) için geçişi kapsar; üçüncü taraf plugin'ler ek sağlayıcılar kaydedebilir.
|
||||
|
||||
<Tip>
|
||||
Kullanıcıya yönelik adım adım anlatımlar için [Claude’dan Taşıma](/tr/install/migrating-claude) ve [Hermes’ten Taşıma](/tr/install/migrating-hermes) bölümlerine bakın. [taşıma merkezi](/tr/install/migrating) tüm yolları listeler.
|
||||
Kullanıcıya dönük adım adım kılavuzlar için [Claude'dan geçiş](/tr/install/migrating-claude) ve [Hermes'ten geçiş](/tr/install/migrating-hermes) bölümlerine bakın. [Geçiş merkezi](/tr/install/migrating) tüm yolları listeler.
|
||||
</Tip>
|
||||
|
||||
## Komutlar
|
||||
@ -26,8 +26,12 @@ Kullanıcıya yönelik adım adım anlatımlar için [Claude’dan Taşıma](/tr
|
||||
```bash
|
||||
openclaw migrate list
|
||||
openclaw migrate claude --dry-run
|
||||
openclaw migrate codex --dry-run
|
||||
openclaw migrate codex --skill gog-vault77-google-workspace
|
||||
openclaw migrate hermes --dry-run
|
||||
openclaw migrate hermes
|
||||
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
|
||||
openclaw migrate apply codex --yes
|
||||
openclaw migrate apply claude --yes
|
||||
openclaw migrate apply hermes --yes
|
||||
openclaw migrate apply hermes --include-secrets --yes
|
||||
@ -37,31 +41,34 @@ openclaw onboard --import-from hermes --import-source ~/.hermes
|
||||
```
|
||||
|
||||
<ParamField path="<provider>" type="string">
|
||||
Kayıtlı bir taşıma sağlayıcısının adı, örneğin `hermes`. Yüklü sağlayıcıları görmek için `openclaw migrate list` çalıştırın.
|
||||
Kayıtlı bir geçiş sağlayıcısının adı, örneğin `hermes`. Yüklü sağlayıcıları görmek için `openclaw migrate list` çalıştırın.
|
||||
</ParamField>
|
||||
<ParamField path="--dry-run" type="boolean">
|
||||
Planı oluştur ve durumu değiştirmeden çık.
|
||||
Planı oluşturun ve durumu değiştirmeden çıkın.
|
||||
</ParamField>
|
||||
<ParamField path="--from <path>" type="string">
|
||||
Kaynak durum dizinini geçersiz kıl. Hermes varsayılan olarak `~/.hermes` kullanır.
|
||||
Kaynak durum dizinini geçersiz kılın. Hermes varsayılan olarak `~/.hermes` kullanır.
|
||||
</ParamField>
|
||||
<ParamField path="--include-secrets" type="boolean">
|
||||
Desteklenen kimlik bilgilerini içe aktar. Varsayılan olarak kapalıdır.
|
||||
Desteklenen kimlik bilgilerini içe aktarın. Varsayılan olarak kapalıdır.
|
||||
</ParamField>
|
||||
<ParamField path="--overwrite" type="boolean">
|
||||
Plan çakışma bildirdiğinde uygulamanın mevcut hedefleri değiştirmesine izin ver.
|
||||
Plan çakışmalar bildirdiğinde apply işleminin mevcut hedefleri değiştirmesine izin verin.
|
||||
</ParamField>
|
||||
<ParamField path="--yes" type="boolean">
|
||||
Onay istemini atla. Etkileşimsiz modda zorunludur.
|
||||
Onay istemini atlayın. Etkileşimsiz modda gereklidir.
|
||||
</ParamField>
|
||||
<ParamField path="--skill <name>" type="string">
|
||||
Skills adı veya öğe kimliğiyle bir skill kopyalama öğesi seçin. Birden fazla skill taşımak için bayrağı tekrarlayın. Atlandığında, etkileşimli Codex geçişleri bir onay kutusu seçici gösterir ve etkileşimsiz geçişler planlanan tüm skill'leri korur.
|
||||
</ParamField>
|
||||
<ParamField path="--no-backup" type="boolean">
|
||||
Uygulama öncesi yedeklemeyi atla. Yerel OpenClaw durumu varsa `--force` gerektirir.
|
||||
Uygulama öncesi yedeklemeyi atlayın. Yerel OpenClaw durumu varsa `--force` gerektirir.
|
||||
</ParamField>
|
||||
<ParamField path="--force" type="boolean">
|
||||
Uygulama aksi halde yedeklemeyi atlamayı reddedeceğinde `--no-backup` ile birlikte zorunludur.
|
||||
Apply işlemi aksi halde yedeklemeyi atlamayı reddedecekken `--no-backup` ile birlikte gereklidir.
|
||||
</ParamField>
|
||||
<ParamField path="--json" type="boolean">
|
||||
Planı veya uygulama sonucunu JSON olarak yazdır. `--json` ile ve `--yes` olmadan, apply planı yazdırır ve durumu değiştirmez.
|
||||
Planı veya apply sonucunu JSON olarak yazdırın. `--json` ve `--yes` olmadan, apply planı yazdırır ve durumu değiştirmez.
|
||||
</ParamField>
|
||||
|
||||
## Güvenlik modeli
|
||||
@ -69,17 +76,17 @@ openclaw onboard --import-from hermes --import-source ~/.hermes
|
||||
`openclaw migrate` önce önizleme yapar.
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Uygulamadan önce önizleme">
|
||||
Sağlayıcı, herhangi bir şey değişmeden önce çakışmalar, atlanan öğeler ve hassas öğeler dahil olmak üzere maddelendirilmiş bir plan döndürür. JSON planları, uygulama çıktısı ve taşıma raporları API anahtarları, token’lar, yetkilendirme üstbilgileri, çerezler ve parolalar gibi gizli bilgiye benzeyen iç içe anahtarları maskeler.
|
||||
<Accordion title="Apply öncesi önizleme">
|
||||
Sağlayıcı, herhangi bir şey değişmeden önce çakışmalar, atlanan öğeler ve hassas öğeler dahil olmak üzere öğelendirilmiş bir plan döndürür. JSON planları, apply çıktısı ve geçiş raporları API anahtarları, token'lar, yetkilendirme üst bilgileri, çerezler ve parolalar gibi gizli bilgiye benzeyen iç içe anahtarları maskeler.
|
||||
|
||||
`openclaw migrate apply <provider>`, `--yes` ayarlanmadıkça durumu değiştirmeden önce planı önizler ve onay ister. Etkileşimsiz modda apply için `--yes` gerekir.
|
||||
`openclaw migrate apply <provider>`, `--yes` ayarlanmadığı sürece durumu değiştirmeden önce planı önizler ve istem gösterir. Etkileşimsiz modda apply `--yes` gerektirir.
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="Yedekler">
|
||||
Apply, taşımayı uygulamadan önce bir OpenClaw yedeği oluşturur ve doğrular. Henüz yerel OpenClaw durumu yoksa yedekleme adımı atlanır ve taşıma devam edebilir. Durum varken yedeklemeyi atlamak için hem `--no-backup` hem de `--force` geçirin.
|
||||
<Accordion title="Yedeklemeler">
|
||||
Apply, geçişi uygulamadan önce bir OpenClaw yedeği oluşturur ve doğrular. Henüz yerel OpenClaw durumu yoksa yedekleme adımı atlanır ve geçiş devam edebilir. Durum varken yedeklemeyi atlamak için hem `--no-backup` hem de `--force` iletin.
|
||||
</Accordion>
|
||||
<Accordion title="Çakışmalar">
|
||||
Planda çakışmalar olduğunda apply devam etmeyi reddeder. Planı gözden geçirin, ardından mevcut hedefleri değiştirmek kasıtlıysa `--overwrite` ile yeniden çalıştırın. Sağlayıcılar, üzerine yazılan dosyalar için taşıma raporu dizininde hâlâ öğe düzeyinde yedekler yazabilir.
|
||||
Planda çakışmalar olduğunda apply devam etmeyi reddeder. Planı gözden geçirin, ardından mevcut hedefleri değiştirmek kasıtlıysa `--overwrite` ile yeniden çalıştırın. Sağlayıcılar, geçiş raporu dizininde üzerine yazılan dosyalar için yine de öğe düzeyinde yedekler yazabilir.
|
||||
</Accordion>
|
||||
<Accordion title="Gizli bilgiler">
|
||||
Gizli bilgiler varsayılan olarak asla içe aktarılmaz. Desteklenen kimlik bilgilerini içe aktarmak için `--include-secrets` kullanın.
|
||||
@ -88,39 +95,73 @@ openclaw onboard --import-from hermes --import-source ~/.hermes
|
||||
|
||||
## Claude sağlayıcısı
|
||||
|
||||
Birlikte gelen Claude sağlayıcısı, varsayılan olarak Claude Code durumunu `~/.claude` konumunda algılar. Belirli bir Claude Code ana dizinini veya proje kökünü içe aktarmak için `--from <path>` kullanın.
|
||||
Paketle birlikte gelen Claude sağlayıcısı varsayılan olarak Claude Code durumunu `~/.claude` konumunda algılar. Belirli bir Claude Code ana dizinini veya proje kökünü içe aktarmak için `--from <path>` kullanın.
|
||||
|
||||
<Tip>
|
||||
Kullanıcıya yönelik adım adım anlatım için [Claude’dan Taşıma](/tr/install/migrating-claude) bölümüne bakın.
|
||||
Kullanıcıya dönük adım adım kılavuz için [Claude'dan geçiş](/tr/install/migrating-claude) bölümüne bakın.
|
||||
</Tip>
|
||||
|
||||
### Claude neleri içe aktarır
|
||||
|
||||
- Proje `CLAUDE.md` ve `.claude/CLAUDE.md` dosyalarını OpenClaw aracı çalışma alanına.
|
||||
- Kullanıcı `~/.claude/CLAUDE.md` içeriğini çalışma alanı `USER.md` dosyasına ekler.
|
||||
- Proje `.mcp.json`, Claude Code `~/.claude.json` ve Claude Desktop `claude_desktop_config.json` içindeki MCP sunucu tanımları.
|
||||
- MCP sunucu tanımlarını proje `.mcp.json`, Claude Code `~/.claude.json` ve Claude Desktop `claude_desktop_config.json` dosyalarından.
|
||||
- `SKILL.md` içeren Claude skill dizinleri.
|
||||
- OpenClaw skills’e dönüştürülen, yalnızca manuel çağrılan Claude komut Markdown dosyaları.
|
||||
- Yalnızca manuel çağırmayla OpenClaw skill'lerine dönüştürülen Claude komut Markdown dosyaları.
|
||||
|
||||
### Arşiv ve manuel inceleme durumu
|
||||
|
||||
Claude hook’ları, izinler, ortam varsayılanları, yerel bellek, yol kapsamlı kurallar, alt aracılar, önbellekler, planlar ve proje geçmişi taşıma raporunda korunur veya manuel inceleme öğeleri olarak bildirilir. OpenClaw hook’ları çalıştırmaz, geniş izin listelerini kopyalamaz veya OAuth/Desktop kimlik bilgisi durumunu otomatik olarak içe aktarmaz.
|
||||
Claude hook'ları, izinleri, ortam varsayılanları, yerel bellek, yol kapsamlı kurallar, alt aracılar, önbellekler, planlar ve proje geçmişi geçiş raporunda korunur veya manuel inceleme öğeleri olarak bildirilir. OpenClaw hook'ları çalıştırmaz, geniş izin listelerini kopyalamaz veya OAuth/Desktop kimlik bilgisi durumunu otomatik olarak içe aktarmaz.
|
||||
|
||||
## Codex sağlayıcısı
|
||||
|
||||
Paketle birlikte gelen Codex sağlayıcısı varsayılan olarak Codex CLI durumunu `~/.codex` konumunda ya da bu ortam değişkeni ayarlanmışsa
|
||||
`CODEX_HOME` konumunda algılar. Belirli bir Codex ana dizinini envantere almak için `--from <path>` kullanın.
|
||||
|
||||
OpenClaw Codex harness'a geçerken ve yararlı kişisel Codex CLI varlıklarını
|
||||
bilinçli biçimde yükseltmek istediğinizde bu sağlayıcıyı kullanın. Yerel Codex app-server
|
||||
başlatmaları aracı başına `CODEX_HOME` ve `HOME` dizinleri kullanır, bu nedenle varsayılan olarak
|
||||
kişisel Codex CLI durumunuzu okumaz.
|
||||
|
||||
Etkileşimli bir terminalde `openclaw migrate codex` çalıştırmak tam
|
||||
planı önizler, ardından son apply onayından önce skill kopyalama öğeleri için bir onay kutusu
|
||||
seçici açar. Tüm skill'ler seçili başlar; bu aracıya kopyalanmasını istemediğiniz
|
||||
herhangi bir skill'in seçimini kaldırın. Betikli veya kesin çalıştırmalar için her
|
||||
skill başına bir kez `--skill <name>` iletin, örneğin:
|
||||
|
||||
```bash
|
||||
openclaw migrate codex --dry-run --skill gog-vault77-google-workspace
|
||||
openclaw migrate apply codex --yes --skill gog-vault77-google-workspace
|
||||
```
|
||||
|
||||
### Codex neleri içe aktarır
|
||||
|
||||
- Codex'in `.system` önbelleği hariç, `$CODEX_HOME/skills` altındaki Codex CLI skill dizinleri.
|
||||
- Aracı başına sahiplik istediğinizde mevcut OpenClaw aracı çalışma alanına kopyalanan `$HOME/.agents/skills` altındaki kişisel AgentSkills.
|
||||
|
||||
### Manuel inceleme gerektiren Codex durumu
|
||||
|
||||
Codex yerel plugin'leri, `config.toml` ve yerel `hooks/hooks.json` otomatik olarak
|
||||
etkinleştirilmez. Plugin'ler MCP sunucuları, uygulamalar, hook'lar veya başka
|
||||
çalıştırılabilir davranışlar sunabilir; bu nedenle sağlayıcı bunları OpenClaw'a yüklemek yerine
|
||||
inceleme için bildirir. Yapılandırma ve hook dosyaları manuel inceleme için geçiş raporuna
|
||||
kopyalanır.
|
||||
|
||||
## Hermes sağlayıcısı
|
||||
|
||||
Birlikte gelen Hermes sağlayıcısı, varsayılan olarak durumu `~/.hermes` konumunda algılar. Hermes başka bir yerde bulunuyorsa `--from <path>` kullanın.
|
||||
Paketle birlikte gelen Hermes sağlayıcısı varsayılan olarak durumu `~/.hermes` konumunda algılar. Hermes başka bir yerdeyse `--from <path>` kullanın.
|
||||
|
||||
### Hermes neleri içe aktarır
|
||||
|
||||
- `config.yaml` içindeki varsayılan model yapılandırması.
|
||||
- `providers` ve `custom_providers` içindeki yapılandırılmış model sağlayıcıları ve özel OpenAI uyumlu uç noktalar.
|
||||
- `mcp_servers` veya `mcp.servers` içindeki MCP sunucu tanımları.
|
||||
- `config.yaml` içinden varsayılan model yapılandırması.
|
||||
- `providers` ve `custom_providers` içinden yapılandırılmış model sağlayıcıları ve özel OpenAI uyumlu uç noktalar.
|
||||
- `mcp_servers` veya `mcp.servers` içinden MCP sunucu tanımları.
|
||||
- `SOUL.md` ve `AGENTS.md` dosyalarını OpenClaw aracı çalışma alanına.
|
||||
- `memories/MEMORY.md` ve `memories/USER.md` içeriklerini çalışma alanı bellek dosyalarına ekler.
|
||||
- OpenClaw dosya belleği için bellek yapılandırması varsayılanları, ayrıca Honcho gibi harici bellek sağlayıcıları için arşiv veya manuel inceleme öğeleri.
|
||||
- `memories/MEMORY.md` ve `memories/USER.md` dosyalarını çalışma alanı bellek dosyalarına ekler.
|
||||
- OpenClaw dosya belleği için bellek yapılandırma varsayılanları, ayrıca Honcho gibi harici bellek sağlayıcıları için arşiv veya manuel inceleme öğeleri.
|
||||
- `skills/<name>/` altında `SKILL.md` dosyası içeren Skills.
|
||||
- `skills.config` içindeki skill başına yapılandırma değerleri.
|
||||
- `.env` içindeki desteklenen API anahtarları, yalnızca `--include-secrets` ile.
|
||||
- `skills.config` içinden skill başına yapılandırma değerleri.
|
||||
- `.env` içinden desteklenen API anahtarları, yalnızca `--include-secrets` ile.
|
||||
|
||||
### Desteklenen `.env` anahtarları
|
||||
|
||||
@ -128,7 +169,7 @@ Birlikte gelen Hermes sağlayıcısı, varsayılan olarak durumu `~/.hermes` kon
|
||||
|
||||
### Yalnızca arşivlenen durum
|
||||
|
||||
OpenClaw’ın güvenli biçimde yorumlayamadığı Hermes durumu manuel inceleme için taşıma raporuna kopyalanır, ancak canlı OpenClaw yapılandırmasına veya kimlik bilgilerine yüklenmez. Bu, OpenClaw’ın onu otomatik olarak yürütebileceği veya güvenebileceği izlenimini vermeden opak ya da güvenli olmayan durumu korur:
|
||||
OpenClaw'ın güvenle yorumlayamadığı Hermes durumu manuel inceleme için geçiş raporuna kopyalanır, ancak canlı OpenClaw yapılandırmasına veya kimlik bilgilerine yüklenmez. Bu, OpenClaw'ın bunu otomatik olarak çalıştırabileceğini veya güvenebileceğini varsaymadan opak ya da güvenli olmayan durumu korur:
|
||||
|
||||
- `plugins/`
|
||||
- `sessions/`
|
||||
@ -146,7 +187,7 @@ openclaw doctor
|
||||
|
||||
## Plugin sözleşmesi
|
||||
|
||||
Taşıma kaynakları Plugin’lerdir. Bir Plugin, sağlayıcı kimliklerini `openclaw.plugin.json` içinde bildirir:
|
||||
Geçiş kaynakları plugin'lerdir. Bir plugin, sağlayıcı kimliklerini `openclaw.plugin.json` içinde bildirir:
|
||||
|
||||
```json
|
||||
{
|
||||
@ -156,22 +197,22 @@ Taşıma kaynakları Plugin’lerdir. Bir Plugin, sağlayıcı kimliklerini `ope
|
||||
}
|
||||
```
|
||||
|
||||
Çalışma zamanında Plugin `api.registerMigrationProvider(...)` çağırır. Sağlayıcı `detect`, `plan` ve `apply` uygular. Core CLI düzenlemesini, yedekleme politikasını, istemleri, JSON çıktısını ve çakışma ön denetimini sahiplenir. Core, gözden geçirilmiş planı `apply(ctx, plan)` içine geçirir ve sağlayıcılar planı yalnızca uyumluluk için bu bağımsız değişken yoksa yeniden oluşturabilir.
|
||||
Çalışma zamanında plugin `api.registerMigrationProvider(...)` çağırır. Sağlayıcı `detect`, `plan` ve `apply` uygular. Çekirdek CLI orkestrasyonunu, yedekleme politikasını, istemleri, JSON çıktısını ve çakışma ön denetimini sahiplenir. Çekirdek gözden geçirilmiş planı `apply(ctx, plan)` içine iletir ve sağlayıcılar planı yalnızca uyumluluk için bu bağımsız değişken yoksa yeniden oluşturabilir.
|
||||
|
||||
Sağlayıcı Plugin’ler öğe oluşturma ve özet sayımları için `openclaw/plugin-sdk/migration`, ayrıca çakışma farkındalıklı dosya kopyaları, yalnızca arşiv rapor kopyaları, önbelleğe alınmış yapılandırma çalışma zamanı sarmalayıcıları ve taşıma raporları için `openclaw/plugin-sdk/migration-runtime` kullanabilir.
|
||||
Sağlayıcı plugin'leri öğe oluşturma ve özet sayımları için `openclaw/plugin-sdk/migration`, ayrıca çakışma farkındalıklı dosya kopyaları, yalnızca arşiv raporu kopyaları, önbelleğe alınmış config-runtime sarmalayıcıları ve geçiş raporları için `openclaw/plugin-sdk/migration-runtime` kullanabilir.
|
||||
|
||||
## Onboarding entegrasyonu
|
||||
|
||||
Onboarding, bir sağlayıcı bilinen bir kaynak algıladığında taşıma sunabilir. Hem `openclaw onboard --flow import` hem de `openclaw setup --wizard --import-from hermes` aynı Plugin taşıma sağlayıcısını kullanır ve uygulamadan önce yine bir önizleme gösterir.
|
||||
Onboarding, bir sağlayıcı bilinen bir kaynak algıladığında geçiş sunabilir. Hem `openclaw onboard --flow import` hem de `openclaw setup --wizard --import-from hermes` aynı plugin geçiş sağlayıcısını kullanır ve uygulamadan önce yine de bir önizleme gösterir.
|
||||
|
||||
<Note>
|
||||
Onboarding içe aktarmaları yeni bir OpenClaw kurulumu gerektirir. Zaten yerel durumunuz varsa önce yapılandırmayı, kimlik bilgilerini, oturumları ve çalışma alanını sıfırlayın. Mevcut kurulumlar için yedekleme artı üzerine yazma veya birleştirme içe aktarmaları özellik bayrağına bağlıdır.
|
||||
Onboarding içe aktarımları yeni bir OpenClaw kurulumu gerektirir. Zaten yerel durumunuz varsa önce yapılandırmayı, kimlik bilgilerini, oturumları ve çalışma alanını sıfırlayın. Yedekleme-artı-üzerine yazma veya birleştirme içe aktarımları mevcut kurulumlar için özellik kapısına tabidir.
|
||||
</Note>
|
||||
|
||||
## İlgili
|
||||
|
||||
- [Hermes’ten Taşıma](/tr/install/migrating-hermes): kullanıcıya yönelik adım adım anlatım.
|
||||
- [Claude’dan Taşıma](/tr/install/migrating-claude): kullanıcıya yönelik adım adım anlatım.
|
||||
- [Taşıma](/tr/install/migrating): OpenClaw’ı yeni bir makineye taşıyın.
|
||||
- [Doctor](/tr/gateway/doctor): bir taşımayı uyguladıktan sonra sağlık denetimi.
|
||||
- [Plugins](/tr/tools/plugin): Plugin kurulumu ve kaydı.
|
||||
- [Hermes'ten geçiş](/tr/install/migrating-hermes): kullanıcıya dönük adım adım kılavuz.
|
||||
- [Claude'dan geçiş](/tr/install/migrating-claude): kullanıcıya dönük adım adım kılavuz.
|
||||
- [Geçiş](/tr/install/migrating): OpenClaw'ı yeni bir makineye taşıyın.
|
||||
- [Doctor](/tr/gateway/doctor): geçiş uygulandıktan sonra sağlık denetimi.
|
||||
- [Plugins](/tr/tools/plugin): plugin kurulumu ve kaydı.
|
||||
|
||||
@ -1,33 +1,33 @@
|
||||
---
|
||||
read_when:
|
||||
- Aracı çalışma alanını veya dosya düzenini açıklamanız gerekiyor
|
||||
- Bir aracı çalışma alanını yedeklemek veya taşımak istiyorsunuz
|
||||
- Ajan çalışma alanını veya dosya düzenini açıklamanız gerekir
|
||||
- Bir ajan çalışma alanını yedeklemek veya taşımak istiyorsunuz
|
||||
sidebarTitle: Agent workspace
|
||||
summary: 'Aracı çalışma alanı: konum, düzen ve yedekleme stratejisi'
|
||||
title: Aracı çalışma alanı
|
||||
summary: 'Ajan çalışma alanı: konum, düzen ve yedekleme stratejisi'
|
||||
title: Ajan çalışma alanı
|
||||
x-i18n:
|
||||
generated_at: "2026-04-26T11:27:01Z"
|
||||
model: gpt-5.4
|
||||
generated_at: "2026-04-30T20:05:49Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 35d59d1f0dec05db30f9166a43bfa519d7299b08d093bbeb905d8f83e5cd022a
|
||||
source_hash: b1ccf74cbec3ff20f4c1c1ce52f099a7ca3365b2536b0aad6ff1d3a5fafcca0a
|
||||
source_path: concepts/agent-workspace.md
|
||||
workflow: 15
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
Çalışma alanı, aracının evidir. Dosya araçları ve çalışma alanı bağlamı için kullanılan tek çalışma dizinidir. Gizli tutun ve bellek gibi davranın.
|
||||
Çalışma alanı, ajanın evidir. Dosya araçları ve çalışma alanı bağlamı için kullanılan tek çalışma dizinidir. Onu özel tutun ve bellek gibi ele alın.
|
||||
|
||||
Bu, config, kimlik bilgileri ve oturumları saklayan `~/.openclaw/` dizininden ayrıdır.
|
||||
Bu, yapılandırma, kimlik bilgileri ve oturumları depolayan `~/.openclaw/` dizininden ayrıdır.
|
||||
|
||||
<Warning>
|
||||
Çalışma alanı **varsayılan cwd**’dir, katı bir sandbox değildir. Araçlar göreli yolları çalışma alanına göre çözer, ancak sandboxing etkin değilse mutlak yollar yine de ana makinede başka yerlere erişebilir. Yalıtım gerekiyorsa [`agents.defaults.sandbox`](/tr/gateway/sandboxing) (ve/veya aracı başına sandbox config’i) kullanın.
|
||||
Çalışma alanı **varsayılan cwd**'dir, katı bir sandbox değildir. Araçlar göreli yolları çalışma alanına göre çözer, ancak sandboxing etkin değilse mutlak yollar host üzerinde başka yerlere hâlâ erişebilir. Yalıtım gerekiyorsa [`agents.defaults.sandbox`](/tr/gateway/sandboxing) (ve/veya ajan başına sandbox yapılandırması) kullanın.
|
||||
|
||||
Sandboxing etkin olduğunda ve `workspaceAccess` değeri `"rw"` olmadığında, araçlar ana makine çalışma alanınızda değil, `~/.openclaw/sandboxes` altındaki bir sandbox çalışma alanında çalışır.
|
||||
Sandboxing etkinleştirildiğinde ve `workspaceAccess` `"rw"` değilse, araçlar host çalışma alanınızda değil, `~/.openclaw/sandboxes` altındaki bir sandbox çalışma alanında çalışır.
|
||||
</Warning>
|
||||
|
||||
## Varsayılan konum
|
||||
|
||||
- Varsayılan: `~/.openclaw/workspace`
|
||||
- `OPENCLAW_PROFILE` ayarlıysa ve `"default"` değilse, varsayılan `~/.openclaw/workspace-<profile>` olur.
|
||||
- `OPENCLAW_PROFILE` ayarlanmışsa ve `"default"` değilse varsayılan `~/.openclaw/workspace-<profile>` olur.
|
||||
- `~/.openclaw/openclaw.json` içinde geçersiz kılın:
|
||||
|
||||
```json5
|
||||
@ -40,7 +40,7 @@ Sandboxing etkin olduğunda ve `workspaceAccess` değeri `"rw"` olmadığında,
|
||||
}
|
||||
```
|
||||
|
||||
`openclaw onboard`, `openclaw configure` veya `openclaw setup`, çalışma alanını oluşturur ve eksikse bootstrap dosyalarını yerleştirir.
|
||||
`openclaw onboard`, `openclaw configure` veya `openclaw setup`, çalışma alanını oluşturur ve eksiklerse bootstrap dosyalarını yerleştirir.
|
||||
|
||||
<Note>
|
||||
Sandbox seed kopyaları yalnızca çalışma alanı içindeki normal dosyaları kabul eder; kaynak çalışma alanının dışına çözümlenen symlink/hardlink takma adları yok sayılır.
|
||||
@ -54,82 +54,83 @@ Sandbox seed kopyaları yalnızca çalışma alanı içindeki normal dosyaları
|
||||
|
||||
## Ek çalışma alanı klasörleri
|
||||
|
||||
Eski kurulumlar `~/openclaw` oluşturmuş olabilir. Birden fazla çalışma alanı dizinini ortalıkta tutmak, kafa karıştırıcı kimlik doğrulama veya durum kaymasına neden olabilir; çünkü aynı anda yalnızca bir çalışma alanı etkindir.
|
||||
Eski kurulumlar `~/openclaw` oluşturmuş olabilir. Etrafta birden çok çalışma alanı dizini tutmak kafa karıştırıcı auth veya durum kaymalarına yol açabilir, çünkü aynı anda yalnızca bir çalışma alanı aktiftir.
|
||||
|
||||
<Note>
|
||||
**Öneri:** tek bir etkin çalışma alanı tutun. Ek klasörleri artık kullanmıyorsanız arşivleyin veya Çöp’e taşıyın (örneğin `trash ~/openclaw`). Bilerek birden fazla çalışma alanı tutuyorsanız, `agents.defaults.workspace` değerinin etkin olanı işaret ettiğinden emin olun.
|
||||
**Öneri:** tek bir etkin çalışma alanı tutun. Ek klasörleri artık kullanmıyorsanız arşivleyin veya Çöp Kutusu'na taşıyın (örneğin `trash ~/openclaw`). Bilerek birden çok çalışma alanı tutuyorsanız `agents.defaults.workspace` değerinin etkin olana işaret ettiğinden emin olun.
|
||||
|
||||
`openclaw doctor`, ek çalışma alanı dizinleri algıladığında uyarı verir.
|
||||
`openclaw doctor`, ek çalışma alanı dizinleri algıladığında uyarır.
|
||||
</Note>
|
||||
|
||||
## Çalışma alanı dosya haritası
|
||||
|
||||
Bunlar, OpenClaw’ın çalışma alanı içinde beklediği standart dosyalardır:
|
||||
Bunlar OpenClaw'ın çalışma alanı içinde beklediği standart dosyalardır:
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="AGENTS.md — çalışma talimatları">
|
||||
Aracı için çalışma talimatları ve belleği nasıl kullanması gerektiği. Her oturumun başında yüklenir. Kurallar, öncelikler ve “nasıl davranmalı” ayrıntıları için iyi bir yerdir.
|
||||
<Accordion title="AGENTS.md — işletim talimatları">
|
||||
Ajan için işletim talimatları ve belleği nasıl kullanması gerektiği. Her oturumun başında yüklenir. Kurallar, öncelikler ve "nasıl davranılacağı" ayrıntıları için iyi bir yerdir.
|
||||
</Accordion>
|
||||
<Accordion title="SOUL.md — persona ve ton">
|
||||
Persona, ton ve sınırlar. Her oturumda yüklenir. Rehber: [SOUL.md kişilik rehberi](/tr/concepts/soul).
|
||||
Persona, ton ve sınırlar. Her oturumda yüklenir. Kılavuz: [SOUL.md kişilik kılavuzu](/tr/concepts/soul).
|
||||
</Accordion>
|
||||
<Accordion title="USER.md — kullanıcı kimdir">
|
||||
<Accordion title="USER.md — kullanıcının kim olduğu">
|
||||
Kullanıcının kim olduğu ve ona nasıl hitap edileceği. Her oturumda yüklenir.
|
||||
</Accordion>
|
||||
<Accordion title="IDENTITY.md — ad, hava, emoji">
|
||||
Aracının adı, havası ve emojisi. Bootstrap ritüeli sırasında oluşturulur/güncellenir.
|
||||
<Accordion title="IDENTITY.md — ad, tarz, emoji">
|
||||
Ajanın adı, tarzı ve emojisi. Bootstrap ritüeli sırasında oluşturulur/güncellenir.
|
||||
</Accordion>
|
||||
<Accordion title="TOOLS.md — yerel araç kuralları">
|
||||
Yerel araçlarınız ve kurallarınız hakkında notlar. Araç kullanılabilirliğini denetlemez; yalnızca rehberlik sağlar.
|
||||
Yerel araçlarınız ve kurallarınız hakkında notlar. Araç kullanılabilirliğini denetlemez; yalnızca rehberliktir.
|
||||
</Accordion>
|
||||
<Accordion title="HEARTBEAT.md — Heartbeat kontrol listesi">
|
||||
Heartbeat çalıştırmaları için isteğe bağlı küçük kontrol listesi. Token tüketimini önlemek için kısa tutun.
|
||||
</Accordion>
|
||||
<Accordion title="BOOT.md — başlangıç kontrol listesi">
|
||||
İsteğe bağlı başlangıç kontrol listesi; Gateway yeniden başlatıldığında otomatik çalışır ([internal hooks](/tr/automation/hooks) etkin olduğunda). Kısa tutun; giden iletiler için message aracını kullanın.
|
||||
Gateway yeniden başlatıldığında otomatik olarak çalıştırılan isteğe bağlı başlangıç kontrol listesi ([internal hooks](/tr/automation/hooks) etkin olduğunda). Kısa tutun; dışa gönderimler için message aracını kullanın.
|
||||
</Accordion>
|
||||
<Accordion title="BOOTSTRAP.md — ilk çalıştırma ritüeli">
|
||||
Tek seferlik ilk çalıştırma ritüeli. Yalnızca yepyeni bir çalışma alanı için oluşturulur. Ritüel tamamlandıktan sonra silin.
|
||||
Bir defalık ilk çalıştırma ritüeli. Yalnızca yepyeni bir çalışma alanı için oluşturulur. Ritüel tamamlandıktan sonra silin.
|
||||
</Accordion>
|
||||
<Accordion title="memory/YYYY-MM-DD.md — günlük bellek günlüğü">
|
||||
Günlük bellek günlüğü (günde bir dosya). Oturum başlangıcında bugün + düne ait dosyaların okunması önerilir.
|
||||
Günlük bellek günlüğü (günde bir dosya). Oturum başlangıcında bugün + dünü okumanız önerilir.
|
||||
</Accordion>
|
||||
<Accordion title="MEMORY.md — derlenmiş uzun vadeli bellek (isteğe bağlı)">
|
||||
Derlenmiş uzun vadeli bellek. Yalnızca ana, özel oturumda yüklenir (paylaşılan/grup bağlamlarında değil). İş akışı ve otomatik bellek boşaltma için [Memory](/tr/concepts/memory) sayfasına bakın.
|
||||
<Accordion title="MEMORY.md — düzenlenmiş uzun vadeli bellek (isteğe bağlı)">
|
||||
Düzenlenmiş uzun vadeli bellek. Yalnızca ana, özel oturumda yükleyin (paylaşılan/grup bağlamlarında değil). İş akışı ve otomatik bellek boşaltma için [Memory](/tr/concepts/memory) bölümüne bakın.
|
||||
</Accordion>
|
||||
<Accordion title="skills/ — çalışma alanı Skills’leri (isteğe bağlı)">
|
||||
Çalışma alanına özgü Skills’ler. O çalışma alanı için en yüksek öncelikli skill konumu. Ad çakıştığında proje aracı Skills’lerini, kişisel aracı Skills’lerini, yönetilen Skills’leri, paketlenmiş Skills’leri ve `skills.load.extraDirs` değerini geçersiz kılar.
|
||||
<Accordion title="skills/ — çalışma alanı Skills (isteğe bağlı)">
|
||||
Çalışma alanına özgü Skills. O çalışma alanı için en yüksek öncelikli skill konumu. Adlar çakıştığında proje ajanı skill'lerini, kişisel ajan skill'lerini, yönetilen skill'leri, paketlenmiş skill'leri ve `skills.load.extraDirs` değerini geçersiz kılar.
|
||||
</Accordion>
|
||||
<Accordion title="canvas/ — Canvas UI dosyaları (isteğe bağlı)">
|
||||
Node ekranları için Canvas UI dosyaları (örneğin `canvas/index.html`).
|
||||
Node gösterimleri için Canvas UI dosyaları (örneğin `canvas/index.html`).
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
<Note>
|
||||
Herhangi bir bootstrap dosyası eksikse, OpenClaw oturuma bir “eksik dosya” işaretçisi ekler ve devam eder. Büyük bootstrap dosyaları eklenirken kırpılır; sınırları `agents.defaults.bootstrapMaxChars` (varsayılan: 12000) ve `agents.defaults.bootstrapTotalMaxChars` (varsayılan: 60000) ile ayarlayın. `openclaw setup`, mevcut dosyaların üzerine yazmadan eksik varsayılanları yeniden oluşturabilir.
|
||||
Herhangi bir bootstrap dosyası eksikse OpenClaw oturuma bir "eksik dosya" işaretçisi enjekte eder ve devam eder. Büyük bootstrap dosyaları enjekte edildiğinde kırpılır; sınırları `agents.defaults.bootstrapMaxChars` (varsayılan: 12000) ve `agents.defaults.bootstrapTotalMaxChars` (varsayılan: 60000) ile ayarlayın. `openclaw setup`, mevcut dosyaların üzerine yazmadan eksik varsayılanları yeniden oluşturabilir.
|
||||
</Note>
|
||||
|
||||
## Çalışma alanında OLMAYANLAR
|
||||
|
||||
Bunlar `~/.openclaw/` altında bulunur ve çalışma alanı deposuna commit edilmemelidir:
|
||||
Bunlar `~/.openclaw/` altında bulunur ve çalışma alanı reposuna commit EDİLMEMELİDİR:
|
||||
|
||||
- `~/.openclaw/openclaw.json` (config)
|
||||
- `~/.openclaw/openclaw.json` (yapılandırma)
|
||||
- `~/.openclaw/agents/<agentId>/agent/auth-profiles.json` (model auth profilleri: OAuth + API anahtarları)
|
||||
- `~/.openclaw/agents/<agentId>/agent/codex-home/` (ajan başına Codex çalışma zamanı hesabı, yapılandırma, skills, plugins ve yerel thread durumu)
|
||||
- `~/.openclaw/credentials/` (kanal/sağlayıcı durumu ve eski OAuth içe aktarma verileri)
|
||||
- `~/.openclaw/agents/<agentId>/sessions/` (oturum transcript’leri + meta veriler)
|
||||
- `~/.openclaw/skills/` (yönetilen Skills)
|
||||
- `~/.openclaw/agents/<agentId>/sessions/` (oturum dökümleri + metadata)
|
||||
- `~/.openclaw/skills/` (yönetilen skills)
|
||||
|
||||
Oturumları veya config’i taşımanız gerekiyorsa, bunları ayrı kopyalayın ve sürüm denetiminin dışında tutun.
|
||||
Oturumları veya yapılandırmayı taşımanız gerekiyorsa bunları ayrı kopyalayın ve sürüm kontrolünün dışında tutun.
|
||||
|
||||
## Git yedeği (önerilir, özel)
|
||||
|
||||
Çalışma alanını özel bellek olarak değerlendirin. Yedeklenebilir ve kurtarılabilir olması için **özel** bir git deposuna koyun.
|
||||
Çalışma alanını özel bellek olarak ele alın. Yedeklenmesi ve kurtarılabilmesi için onu **özel** bir git reposuna koyun.
|
||||
|
||||
Bu adımları Gateway’in çalıştığı makinede yürütün (çalışma alanı orada bulunur).
|
||||
Bu adımları Gateway'in çalıştığı makinede çalıştırın (çalışma alanının bulunduğu yer orasıdır).
|
||||
|
||||
<Steps>
|
||||
<Step title="Depoyu başlatın">
|
||||
Git yüklüyse, yepyeni çalışma alanları otomatik olarak başlatılır. Bu çalışma alanı zaten bir depo değilse şunu çalıştırın:
|
||||
<Step title="Repoyu başlatın">
|
||||
Git yüklüyse yepyeni çalışma alanları otomatik olarak başlatılır. Bu çalışma alanı zaten bir repo değilse şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
cd ~/.openclaw/workspace
|
||||
@ -142,10 +143,10 @@ Bu adımları Gateway’in çalıştığı makinede yürütün (çalışma alan
|
||||
<Step title="Özel bir remote ekleyin">
|
||||
<Tabs>
|
||||
<Tab title="GitHub web UI">
|
||||
1. GitHub’da yeni bir **özel** depo oluşturun.
|
||||
1. GitHub üzerinde yeni bir **özel** repository oluşturun.
|
||||
2. README ile başlatmayın (merge çakışmalarını önler).
|
||||
3. HTTPS remote URL’sini kopyalayın.
|
||||
4. Remote’u ekleyin ve push edin:
|
||||
3. HTTPS remote URL'sini kopyalayın.
|
||||
4. Remote'u ekleyin ve push yapın:
|
||||
|
||||
```bash
|
||||
git branch -M main
|
||||
@ -160,10 +161,10 @@ Bu adımları Gateway’in çalıştığı makinede yürütün (çalışma alan
|
||||
```
|
||||
</Tab>
|
||||
<Tab title="GitLab web UI">
|
||||
1. GitLab’da yeni bir **özel** depo oluşturun.
|
||||
1. GitLab üzerinde yeni bir **özel** repository oluşturun.
|
||||
2. README ile başlatmayın (merge çakışmalarını önler).
|
||||
3. HTTPS remote URL’sini kopyalayın.
|
||||
4. Remote’u ekleyin ve push edin:
|
||||
3. HTTPS remote URL'sini kopyalayın.
|
||||
4. Remote'u ekleyin ve push yapın:
|
||||
|
||||
```bash
|
||||
git branch -M main
|
||||
@ -187,13 +188,13 @@ Bu adımları Gateway’in çalıştığı makinede yürütün (çalışma alan
|
||||
## Gizli bilgileri commit etmeyin
|
||||
|
||||
<Warning>
|
||||
Özel bir depoda bile, gizli bilgileri çalışma alanında saklamaktan kaçının:
|
||||
Özel bir repoda bile, gizli bilgileri çalışma alanında saklamaktan kaçının:
|
||||
|
||||
- API anahtarları, OAuth token’ları, parolalar veya özel kimlik bilgileri.
|
||||
- API anahtarları, OAuth token'ları, parolalar veya özel kimlik bilgileri.
|
||||
- `~/.openclaw/` altındaki herhangi bir şey.
|
||||
- Sohbetlerin ham dökümleri veya hassas ekler.
|
||||
- Sohbetlerin veya hassas eklerin ham dump'ları.
|
||||
|
||||
Hassas başvuruları saklamanız gerekiyorsa yer tutucular kullanın ve gerçek gizli bilgiyi başka yerde tutun (parola yöneticisi, ortam değişkenleri veya `~/.openclaw/`).
|
||||
Hassas referanslar saklamanız gerekiyorsa placeholder'lar kullanın ve gerçek sırrı başka bir yerde tutun (parola yöneticisi, ortam değişkenleri veya `~/.openclaw/`).
|
||||
</Warning>
|
||||
|
||||
Önerilen `.gitignore` başlangıcı:
|
||||
@ -209,23 +210,23 @@ Hassas başvuruları saklamanız gerekiyorsa yer tutucular kullanın ve gerçek
|
||||
## Çalışma alanını yeni bir makineye taşıma
|
||||
|
||||
<Steps>
|
||||
<Step title="Depoyu klonlayın">
|
||||
Depoyu istenen yola klonlayın (varsayılan `~/.openclaw/workspace`).
|
||||
<Step title="Repoyu clone edin">
|
||||
Repoyu istenen yola clone edin (varsayılan `~/.openclaw/workspace`).
|
||||
</Step>
|
||||
<Step title="Config’i güncelleyin">
|
||||
Bu yolu `~/.openclaw/openclaw.json` içinde `agents.defaults.workspace` olarak ayarlayın.
|
||||
<Step title="Yapılandırmayı güncelleyin">
|
||||
`~/.openclaw/openclaw.json` içinde `agents.defaults.workspace` değerini bu yola ayarlayın.
|
||||
</Step>
|
||||
<Step title="Eksik dosyaları yerleştirin">
|
||||
Eksik dosyaları yerleştirmek için `openclaw setup --workspace <path>` çalıştırın.
|
||||
<Step title="Eksik dosyaları seed edin">
|
||||
Eksik dosyaları seed etmek için `openclaw setup --workspace <path>` çalıştırın.
|
||||
</Step>
|
||||
<Step title="Oturumları kopyalayın (isteğe bağlı)">
|
||||
Oturumlara ihtiyacınız varsa, `~/.openclaw/agents/<agentId>/sessions/` dizinini eski makineden ayrı olarak kopyalayın.
|
||||
Oturumlara ihtiyacınız varsa eski makineden `~/.openclaw/agents/<agentId>/sessions/` dizinini ayrı olarak kopyalayın.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
## Gelişmiş notlar
|
||||
|
||||
- Çoklu aracı yönlendirme, aracı başına farklı çalışma alanları kullanabilir. Yönlendirme config’i için [Channel routing](/tr/channels/channel-routing) sayfasına bakın.
|
||||
- Çok ajanlı yönlendirme, ajan başına farklı çalışma alanları kullanabilir. Yönlendirme yapılandırması için [Channel routing](/tr/channels/channel-routing) bölümüne bakın.
|
||||
- `agents.defaults.sandbox` etkinse, ana olmayan oturumlar `agents.defaults.sandbox.workspaceRoot` altında oturum başına sandbox çalışma alanları kullanabilir.
|
||||
|
||||
## İlgili
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -1,141 +1,143 @@
|
||||
---
|
||||
read_when:
|
||||
- Paketle birlikte gelen Codex app-server düzeneğini kullanmak istiyorsunuz
|
||||
- Codex test düzeneği yapılandırma örneklerine ihtiyacınız var
|
||||
- Birlikte gelen Codex app-server test düzeneğini kullanmak istiyorsunuz
|
||||
- Codex çalıştırma ortamı yapılandırma örneklerine ihtiyacınız var
|
||||
- Yalnızca Codex dağıtımlarının PI'ye geri dönmek yerine başarısız olmasını istiyorsunuz
|
||||
summary: OpenClaw yerleşik ajan turlarını birlikte gelen Codex app-server düzeneği üzerinden çalıştırın
|
||||
summary: OpenClaw gömülü ajan turlarını birlikte gelen Codex app-server düzeneği üzerinden çalıştırın
|
||||
title: Codex çalışma düzeneği
|
||||
x-i18n:
|
||||
generated_at: "2026-04-30T09:34:15Z"
|
||||
generated_at: "2026-04-30T20:05:58Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: 93abb72e9590aad265e5b6b8691dd16314178c4d255679b4e53da33b792a6e6b
|
||||
source_hash: 335ec60cbdb76579db833eccb5151ffc5bcd28b370ca2e99587abdb578eeee4f
|
||||
source_path: plugins/codex-harness.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
Birlikte gelen `codex` Plugin'i, OpenClaw'ın yerleşik PI koşumu yerine Codex uygulama sunucusu üzerinden gömülü ajan turları çalıştırmasını sağlar.
|
||||
Birlikte gelen `codex` Plugin'i, OpenClaw'ın gömülü ajan turlarını yerleşik PI çalıştırıcısı yerine Codex uygulama sunucusu üzerinden çalıştırmasını sağlar.
|
||||
|
||||
Bunu, düşük seviyeli ajan oturumunun Codex tarafından yönetilmesini istediğinizde kullanın: model keşfi, yerel iş parçacığı sürdürme, yerel Compaction ve uygulama sunucusu yürütmesi. OpenClaw sohbet kanallarını, oturum dosyalarını, model seçimini, araçları, onayları, medya teslimini ve görünür transkript yansısını yönetmeye devam eder.
|
||||
Bunu, düşük seviyeli ajan oturumunu Codex'in yönetmesini istediğinizde kullanın: model keşfi, yerel iş parçacığı sürdürme, yerel Compaction ve uygulama sunucusu yürütmesi. OpenClaw hâlâ sohbet kanallarını, oturum dosyalarını, model seçimini, araçları, onayları, medya teslimini ve görünür döküm yansısını yönetir.
|
||||
|
||||
Kendinizi konumlandırmaya çalışıyorsanız,
|
||||
[Agent runtimes](/tr/concepts/agent-runtimes) ile başlayın. Kısa sürüm şudur:
|
||||
`openai/gpt-5.5` model başvurusu, `codex` çalışma zamanı, Telegram, Discord, Slack veya başka bir kanal ise iletişim yüzeyidir.
|
||||
Kendinizi konumlandırmaya çalışıyorsanız
|
||||
[Ajan çalışma zamanları](/tr/concepts/agent-runtimes) ile başlayın. Kısa sürüm şudur:
|
||||
`openai/gpt-5.5` model referansıdır, `codex` çalışma zamanıdır ve Telegram,
|
||||
Discord, Slack veya başka bir kanal iletişim yüzeyi olarak kalır.
|
||||
|
||||
## Bu Plugin'in değiştirdikleri
|
||||
## Bu Plugin neyi değiştirir
|
||||
|
||||
Birlikte gelen `codex` Plugin'i birkaç ayrı yetenek sağlar:
|
||||
|
||||
| Yetenek | Nasıl kullanırsınız | Ne yapar |
|
||||
| -------------------------------- | --------------------------------------------------- | ----------------------------------------------------------------------------- |
|
||||
| Yerel gömülü çalışma zamanı | `agentRuntime.id: "codex"` | OpenClaw gömülü ajan turlarını Codex uygulama sunucusu üzerinden çalıştırır. |
|
||||
| Yerel sohbet denetim komutları | `/codex bind`, `/codex resume`, `/codex steer`, ... | Bir mesajlaşma konuşmasından Codex uygulama sunucusu iş parçacıklarını bağlar ve denetler. |
|
||||
| Codex uygulama sunucusu sağlayıcısı/kataloğu | `codex` iç bileşenleri, koşum üzerinden sunulur | Çalışma zamanının uygulama sunucusu modellerini keşfetmesini ve doğrulamasını sağlar. |
|
||||
| Codex medya anlama yolu | `codex/*` görüntü modeli uyumluluk yolları | Desteklenen görüntü anlama modelleri için sınırlı Codex uygulama sunucusu turları çalıştırır. |
|
||||
| Yerel kanca aktarıcısı | Codex'e yerel olaylar etrafındaki Plugin kancaları | OpenClaw'ın desteklenen Codex'e yerel araç/sonlandırma olaylarını gözlemlemesini/engellemesini sağlar. |
|
||||
| Yetenek | Nasıl kullanırsınız | Ne yapar |
|
||||
| --------------------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------ |
|
||||
| Yerel gömülü çalışma zamanı | `agentRuntime.id: "codex"` | OpenClaw gömülü ajan turlarını Codex uygulama sunucusu üzerinden çalıştırır. |
|
||||
| Yerel sohbet denetim komutları | `/codex bind`, `/codex resume`, `/codex steer`, ... | Mesajlaşma konuşmasından Codex uygulama sunucusu iş parçacıklarını bağlar ve denetler. |
|
||||
| Codex uygulama sunucusu sağlayıcısı/kataloğu | `codex` iç bileşenleri, çalıştırıcı üzerinden sunulur | Çalışma zamanının uygulama sunucusu modellerini keşfetmesini ve doğrulamasını sağlar. |
|
||||
| Codex medya anlama yolu | `codex/*` görüntü modeli uyumluluk yolları | Desteklenen görüntü anlama modelleri için sınırlı Codex uygulama sunucusu turları çalıştırır. |
|
||||
| Yerel hook aktarıcısı | Codex'e yerel olaylar etrafındaki Plugin hook'ları | OpenClaw'ın desteklenen Codex'e yerel araç/sonlandırma olaylarını gözlemlemesini/engellemesini sağlar. |
|
||||
|
||||
Plugin'i etkinleştirmek bu yetenekleri kullanılabilir hale getirir. Şunları **yapmaz**:
|
||||
Plugin'i etkinleştirmek bu yetenekleri kullanılabilir kılar. Şunları **yapmaz**:
|
||||
|
||||
- her OpenAI modeli için Codex kullanmaya başlamak
|
||||
- `openai-codex/*` model başvurularını yerel çalışma zamanına dönüştürmek
|
||||
- `openai-codex/*` model referanslarını yerel çalışma zamanına dönüştürmek
|
||||
- ACP/acpx'i varsayılan Codex yolu yapmak
|
||||
- zaten PI çalışma zamanı kaydetmiş mevcut oturumları anında değiştirmek
|
||||
- OpenClaw kanal teslimini, oturum dosyalarını, kimlik doğrulama profili depolamayı veya
|
||||
ileti yönlendirmeyi değiştirmek
|
||||
- zaten bir PI çalışma zamanı kaydetmiş mevcut oturumları anında değiştirmek
|
||||
- OpenClaw kanal teslimini, oturum dosyalarını, auth-profile depolamasını veya
|
||||
ileti yönlendirmesini değiştirmek
|
||||
|
||||
Aynı Plugin, yerel `/codex` sohbet denetim komut yüzeyini de yönetir. Plugin etkinse ve kullanıcı sohbetten Codex iş parçacıklarını bağlamayı, sürdürmeyi, yönlendirmeyi, durdurmayı veya incelemeyi isterse, ajanlar ACP yerine `/codex ...` tercih etmelidir. ACP, kullanıcı ACP/acpx istediğinde veya ACP Codex bağdaştırıcısını test ettiğinde açık yedek seçenek olarak kalır.
|
||||
Aynı Plugin, yerel `/codex` sohbet denetim komut yüzeyini de yönetir. Plugin etkinse ve kullanıcı sohbetten Codex iş parçacıklarını bağlamayı, sürdürmeyi, yönlendirmeyi, durdurmayı veya incelemeyi isterse, ajanlar ACP yerine `/codex ...` tercih etmelidir. ACP, kullanıcı ACP/acpx istediğinde veya ACP Codex bağdaştırıcısını test ettiğinde açık geri dönüş olarak kalır.
|
||||
|
||||
Yerel Codex turları, genel uyumluluk katmanı olarak OpenClaw Plugin kancalarını korur. Bunlar işlem içi OpenClaw kancalarıdır; Codex `hooks.json` komut kancaları değildir:
|
||||
Yerel Codex turları, OpenClaw Plugin hook'larını genel uyumluluk katmanı olarak tutar. Bunlar süreç içi OpenClaw hook'larıdır, Codex `hooks.json` komut hook'ları değildir:
|
||||
|
||||
- `before_prompt_build`
|
||||
- `before_compaction`, `after_compaction`
|
||||
- `llm_input`, `llm_output`
|
||||
- `before_tool_call`, `after_tool_call`
|
||||
- `before_message_write` yansıtılmış transkript kayıtları için
|
||||
- `before_agent_finalize` Codex `Stop` aktarıcısı üzerinden
|
||||
- `before_message_write` yansıtılmış döküm kayıtları için
|
||||
- Codex `Stop` aktarıcısı üzerinden `before_agent_finalize`
|
||||
- `agent_end`
|
||||
|
||||
Plugin'ler ayrıca OpenClaw aracı çalıştırdıktan sonra ve sonuç Codex'e döndürülmeden önce OpenClaw dinamik araç sonuçlarını yeniden yazmak için çalışma zamanından bağımsız araç sonucu ara yazılımı kaydedebilir. Bu, OpenClaw'a ait transkript araç sonucu yazımlarını dönüştüren genel `tool_result_persist` Plugin kancasından ayrıdır.
|
||||
Plugin'ler, OpenClaw aracı yürüttükten sonra ve sonuç Codex'e döndürülmeden önce OpenClaw dinamik araç sonuçlarını yeniden yazmak için çalışma zamanından bağımsız araç sonucu ara katman yazılımı da kaydedebilir. Bu, OpenClaw'ın sahip olduğu döküm araç sonucu yazımlarını dönüştüren genel `tool_result_persist` Plugin hook'undan ayrıdır.
|
||||
|
||||
Plugin kancası anlamları için [Plugin hooks](/tr/plugins/hooks)
|
||||
ve [Plugin guard behavior](/tr/tools/plugin) sayfalarına bakın.
|
||||
Plugin hook semantiğinin kendisi için [Plugin hook'ları](/tr/plugins/hooks) ve [Plugin koruma davranışı](/tr/tools/plugin) bölümlerine bakın.
|
||||
|
||||
Koşum varsayılan olarak kapalıdır. Yeni yapılandırmalar OpenAI model başvurularını `openai/gpt-*` biçiminde kurallı tutmalı ve yerel uygulama sunucusu yürütmesi istediklerinde açıkça `agentRuntime.id: "codex"` veya `OPENCLAW_AGENT_RUNTIME=codex` zorlamalıdır. Eski `codex/*` model başvuruları uyumluluk için koşumu hâlâ otomatik seçer, ancak çalışma zamanı destekli eski sağlayıcı önekleri normal model/sağlayıcı seçenekleri olarak gösterilmez.
|
||||
Çalıştırıcı varsayılan olarak kapalıdır. Yeni yapılandırmalar OpenAI model referanslarını `openai/gpt-*` olarak kurallı tutmalı ve yerel uygulama sunucusu yürütmesi istediklerinde açıkça `agentRuntime.id: "codex"` veya `OPENCLAW_AGENT_RUNTIME=codex` zorlamalıdır. Eski `codex/*` model referansları uyumluluk için çalıştırıcıyı hâlâ otomatik seçer, ancak çalışma zamanı destekli eski sağlayıcı önekleri normal model/sağlayıcı seçenekleri olarak gösterilmez.
|
||||
|
||||
`codex` Plugin'i etkinse ancak birincil model hâlâ `openai-codex/*` ise, `openclaw doctor` rotayı değiştirmek yerine uyarır. Bu kasıtlıdır: `openai-codex/*`, PI Codex OAuth/abonelik yolu olarak kalır ve yerel uygulama sunucusu yürütmesi açık bir çalışma zamanı seçimi olarak kalır.
|
||||
`codex` Plugin'i etkinse ancak birincil model hâlâ `openai-codex/*` ise, `openclaw doctor` rotayı değiştirmek yerine uyarır. Bu bilinçlidir: `openai-codex/*` PI Codex OAuth/abonelik yolu olarak kalır ve yerel uygulama sunucusu yürütmesi açık bir çalışma zamanı seçimi olarak kalır.
|
||||
|
||||
## Rota haritası
|
||||
|
||||
Yapılandırmayı değiştirmeden önce bu tabloyu kullanın:
|
||||
|
||||
| İstenen davranış | Model başvurusu | Çalışma zamanı yapılandırması | Plugin gereksinimi | Beklenen durum etiketi |
|
||||
| ------------------------------------------- | ------------------------ | -------------------------------------- | --------------------------- | ------------------------------- |
|
||||
| Normal OpenClaw çalıştırıcısı üzerinden OpenAI API | `openai/gpt-*` | atlanmış veya `runtime: "pi"` | OpenAI sağlayıcısı | `Runtime: OpenClaw Pi Default` |
|
||||
| PI üzerinden Codex OAuth/abonelik | `openai-codex/gpt-*` | atlanmış veya `runtime: "pi"` | OpenAI Codex OAuth sağlayıcısı | `Runtime: OpenClaw Pi Default` |
|
||||
| Yerel Codex uygulama sunucusu gömülü turları | `openai/gpt-*` | `agentRuntime.id: "codex"` | `codex` Plugin'i | `Runtime: OpenAI Codex` |
|
||||
| Tutucu otomatik modla karma sağlayıcılar | sağlayıcıya özgü başvurular | `agentRuntime.id: "auto"` | İsteğe bağlı Plugin çalışma zamanları | Seçilen çalışma zamanına bağlı |
|
||||
| Açık Codex ACP bağdaştırıcı oturumu | ACP istemi/modeline bağlı | `sessions_spawn` ile `runtime: "acp"` | sağlıklı `acpx` arka ucu | ACP görev/oturum durumu |
|
||||
| İstenen davranış | Model referansı | Çalışma zamanı yapılandırması | Plugin gereksinimi | Beklenen durum etiketi |
|
||||
| ----------------------------------------- | ------------------------- | --------------------------------------- | --------------------------- | ------------------------------- |
|
||||
| Normal OpenClaw çalıştırıcısı üzerinden OpenAI API | `openai/gpt-*` | atlanmış veya `runtime: "pi"` | OpenAI sağlayıcısı | `Runtime: OpenClaw Pi Default` |
|
||||
| PI üzerinden Codex OAuth/abonelik | `openai-codex/gpt-*` | atlanmış veya `runtime: "pi"` | OpenAI Codex OAuth sağlayıcısı | `Runtime: OpenClaw Pi Default` |
|
||||
| Yerel Codex uygulama sunucusu gömülü turları | `openai/gpt-*` | `agentRuntime.id: "codex"` | `codex` Plugin'i | `Runtime: OpenAI Codex` |
|
||||
| Koruyucu otomatik modla karışık sağlayıcılar | sağlayıcıya özgü referanslar | `agentRuntime.id: "auto"` | İsteğe bağlı Plugin çalışma zamanları | Seçilen çalışma zamanına bağlı |
|
||||
| Açık Codex ACP bağdaştırıcısı oturumu | ACP prompt/model bağımlı | `sessions_spawn` ile `runtime: "acp"` | sağlıklı `acpx` arka ucu | ACP görev/oturum durumu |
|
||||
|
||||
Önemli ayrım sağlayıcı ile çalışma zamanı arasındadır:
|
||||
|
||||
- `openai-codex/*`, "PI hangi sağlayıcı/kimlik doğrulama rotasını kullanmalı?" sorusunu yanıtlar
|
||||
- `agentRuntime.id: "codex"`, "bu gömülü turu hangi döngü yürütmeli?" sorusunu yanıtlar
|
||||
- `/codex ...`, "bu sohbet hangi yerel Codex konuşmasına bağlanmalı veya onu denetlemeli?" sorusunu yanıtlar
|
||||
- ACP, "acpx hangi harici koşum sürecini başlatmalı?" sorusunu yanıtlar
|
||||
- `openai-codex/*` "PI hangi sağlayıcı/auth rotasını kullanmalı?" sorusunu yanıtlar
|
||||
- `agentRuntime.id: "codex"` "bu gömülü turu hangi döngü yürütmeli?"
|
||||
sorusunu yanıtlar
|
||||
- `/codex ...` "bu sohbet hangi yerel Codex konuşmasına bağlanmalı
|
||||
veya onu denetlemeli?" sorusunu yanıtlar
|
||||
- ACP "acpx hangi dış çalıştırıcı sürecini başlatmalı?" sorusunu yanıtlar
|
||||
|
||||
## Doğru model önekini seçin
|
||||
|
||||
OpenAI ailesi rotaları öneke özeldir. PI üzerinden Codex OAuth istediğinizde `openai-codex/*` kullanın; doğrudan OpenAI API erişimi istediğinizde veya yerel Codex uygulama sunucusu koşumunu zorladığınızda `openai/*` kullanın:
|
||||
OpenAI ailesi rotaları öneke özgüdür. PI üzerinden Codex OAuth istediğinizde `openai-codex/*` kullanın; doğrudan OpenAI API erişimi istediğinizde veya yerel Codex uygulama sunucusu çalıştırıcısını zorladığınızda `openai/*` kullanın:
|
||||
|
||||
| Model başvurusu | Çalışma zamanı yolu | Ne zaman kullanılır |
|
||||
| -------------------------------------------- | ------------------------------------------ | -------------------------------------------------------------------------- |
|
||||
| `openai/gpt-5.4` | OpenClaw/PI tesisatı üzerinden OpenAI sağlayıcısı | `OPENAI_API_KEY` ile mevcut doğrudan OpenAI Platform API erişimi istiyorsunuz. |
|
||||
| `openai-codex/gpt-5.5` | OpenClaw/PI üzerinden OpenAI Codex OAuth | Varsayılan PI çalıştırıcısıyla ChatGPT/Codex abonelik kimlik doğrulaması istiyorsunuz. |
|
||||
| `openai/gpt-5.5` + `agentRuntime.id: "codex"` | Codex uygulama sunucusu koşumu | Gömülü ajan turu için yerel Codex uygulama sunucusu yürütmesi istiyorsunuz. |
|
||||
| Model referansı | Çalışma zamanı yolu | Ne zaman kullanılır |
|
||||
| -------------------------------------------- | ----------------------------------------- | ------------------------------------------------------------------------- |
|
||||
| `openai/gpt-5.4` | OpenClaw/PI tesisatı üzerinden OpenAI sağlayıcısı | `OPENAI_API_KEY` ile güncel doğrudan OpenAI Platform API erişimi istediğinizde. |
|
||||
| `openai-codex/gpt-5.5` | OpenClaw/PI üzerinden OpenAI Codex OAuth | Varsayılan PI çalıştırıcısıyla ChatGPT/Codex abonelik auth istediğinizde. |
|
||||
| `openai/gpt-5.5` + `agentRuntime.id: "codex"` | Codex uygulama sunucusu çalıştırıcısı | Gömülü ajan turu için yerel Codex uygulama sunucusu yürütmesi istediğinizde. |
|
||||
|
||||
GPT-5.5 şu anda OpenClaw'da yalnızca abonelik/OAuth ile kullanılabilir. PI OAuth için `openai-codex/gpt-5.5` kullanın veya Codex uygulama sunucusu koşumuyla `openai/gpt-5.5` kullanın. `openai/gpt-5.5` için doğrudan API anahtarı erişimi, OpenAI GPT-5.5'i genel API'de etkinleştirdiğinde desteklenir.
|
||||
GPT-5.5 şu anda OpenClaw'da yalnızca abonelik/OAuth ile kullanılabilir. PI OAuth için `openai-codex/gpt-5.5` kullanın veya Codex uygulama sunucusu çalıştırıcısıyla `openai/gpt-5.5` kullanın. `openai/gpt-5.5` için doğrudan API anahtarı erişimi, OpenAI GPT-5.5'i genel API'de etkinleştirdiğinde desteklenir.
|
||||
|
||||
Eski `codex/gpt-*` başvuruları uyumluluk takma adları olarak kabul edilmeye devam eder. Doctor uyumluluk geçişi, eski birincil çalışma zamanı başvurularını kurallı model başvurularına yeniden yazar ve çalışma zamanı ilkesini ayrı kaydeder; yalnızca yedek eski başvurular ise değişmeden bırakılır, çünkü çalışma zamanı tüm ajan kapsayıcısı için yapılandırılır. Yeni PI Codex OAuth yapılandırmaları `openai-codex/gpt-*` kullanmalıdır; yeni yerel uygulama sunucusu koşumu yapılandırmaları `openai/gpt-*` artı `agentRuntime.id: "codex"` kullanmalıdır.
|
||||
Eski `codex/gpt-*` referansları uyumluluk diğer adları olarak kabul edilmeye devam eder. Doctor uyumluluk geçişi, eski birincil çalışma zamanı referanslarını kurallı model referanslarına yeniden yazar ve çalışma zamanı ilkesini ayrı kaydeder; yalnızca geri dönüşte kullanılan eski referanslar ise değişmeden bırakılır, çünkü çalışma zamanı tüm ajan kapsayıcısı için yapılandırılır. Yeni PI Codex OAuth yapılandırmaları `openai-codex/gpt-*` kullanmalıdır; yeni yerel uygulama sunucusu çalıştırıcısı yapılandırmaları `openai/gpt-*` ile birlikte `agentRuntime.id: "codex"` kullanmalıdır.
|
||||
|
||||
`agents.defaults.imageModel` aynı önek ayrımını izler. Görüntü anlama OpenAI Codex OAuth sağlayıcı yolu üzerinden çalışmalıysa `openai-codex/gpt-*` kullanın. Görüntü anlama sınırlı bir Codex uygulama sunucusu turu üzerinden çalışmalıysa `codex/gpt-*` kullanın. Codex uygulama sunucusu modeli görüntü girişi desteği bildirmelidir; yalnızca metin destekleyen Codex modelleri medya turu başlamadan önce başarısız olur.
|
||||
`agents.defaults.imageModel` aynı önek ayrımını izler. Görüntü anlama OpenAI Codex OAuth sağlayıcı yolu üzerinden çalışmalıysa `openai-codex/gpt-*` kullanın. Görüntü anlama sınırlı bir Codex uygulama sunucusu turu üzerinden çalışmalıysa `codex/gpt-*` kullanın. Codex uygulama sunucusu modeli görüntü girdi desteğini ilan etmelidir; yalnızca metin Codex modelleri medya turu başlamadan önce başarısız olur.
|
||||
|
||||
Geçerli oturum için etkin koşumu doğrulamak üzere `/status` kullanın. Seçim şaşırtıcıysa, `agents/harness` alt sistemi için hata ayıklama günlüğünü etkinleştirin ve Gateway'in yapılandırılmış `agent harness selected` kaydını inceleyin. Bu kayıt seçilen koşum kimliğini, seçim nedenini, çalışma zamanı/yedek ilkesini ve `auto` modunda her Plugin adayının destek sonucunu içerir.
|
||||
Geçerli oturum için etkili çalıştırıcıyı doğrulamak üzere `/status` kullanın. Seçim şaşırtıcıysa, `agents/harness` alt sistemi için hata ayıklama günlüklerini etkinleştirin ve Gateway'in yapılandırılmış `agent harness selected` kaydını inceleyin. Bu kayıt seçilen çalıştırıcı kimliğini, seçim nedenini, çalışma zamanı/geri dönüş ilkesini ve `auto` modunda her Plugin adayının destek sonucunu içerir.
|
||||
|
||||
### Doctor uyarıları ne anlama gelir
|
||||
|
||||
`openclaw doctor`, aşağıdakilerin tümü doğru olduğunda uyarır:
|
||||
`openclaw doctor`, şu koşulların tümü doğru olduğunda uyarır:
|
||||
|
||||
- birlikte gelen `codex` Plugin'i etkin veya izinlidir
|
||||
- bir ajanın birincil modeli `openai-codex/*`'dır
|
||||
- o ajanın etkin çalışma zamanı `codex` değildir
|
||||
- bir ajanın birincil modeli `openai-codex/*` şeklindedir
|
||||
- o ajanın etkili çalışma zamanı `codex` değildir
|
||||
|
||||
Bu uyarı vardır çünkü kullanıcılar çoğu zaman "Codex Plugin'i etkin" ifadesinin "yerel Codex uygulama sunucusu çalışma zamanı" anlamına gelmesini bekler. OpenClaw bu sıçramayı yapmaz. Uyarının anlamı şudur:
|
||||
Bu uyarı, kullanıcıların sık sık "Codex Plugin etkin" ifadesinin "yerel Codex uygulama sunucusu çalışma zamanı" anlamına gelmesini beklemesi nedeniyle vardır. OpenClaw bu sıçramayı yapmaz. Uyarı şu anlama gelir:
|
||||
|
||||
- PI üzerinden ChatGPT/Codex OAuth amaçladıysanız **değişiklik gerekmez**.
|
||||
- PI üzerinden ChatGPT/Codex OAuth amaçladıysanız **hiçbir değişiklik gerekmez**.
|
||||
- Yerel uygulama sunucusu yürütmesi amaçladıysanız modeli `openai/<model>` olarak değiştirin ve
|
||||
`agentRuntime.id: "codex"` ayarlayın.
|
||||
- Çalışma zamanı değişikliğinden sonra mevcut oturumlar hâlâ `/new` veya `/reset` gerektirir,
|
||||
çünkü oturum çalışma zamanı sabitlemeleri yapışkandır.
|
||||
|
||||
Koşum seçimi canlı oturum denetimi değildir. Gömülü bir tur çalıştığında, OpenClaw seçilen koşum kimliğini o oturuma kaydeder ve aynı oturum kimliğindeki sonraki turlar için onu kullanmaya devam eder. Gelecekteki oturumların başka bir koşum kullanmasını istediğinizde `agentRuntime` yapılandırmasını veya `OPENCLAW_AGENT_RUNTIME` değerini değiştirin; mevcut bir konuşmayı PI ile Codex arasında değiştirmeden önce yeni bir oturum başlatmak için `/new` veya `/reset` kullanın. Bu, tek bir transkriptin iki uyumsuz yerel oturum sistemi üzerinden yeniden oynatılmasını önler.
|
||||
Çalıştırıcı seçimi canlı oturum denetimi değildir. Gömülü bir tur çalıştığında OpenClaw seçilen çalıştırıcı kimliğini o oturuma kaydeder ve aynı oturum kimliğindeki sonraki turlarda kullanmaya devam eder. Gelecekteki oturumların başka bir çalıştırıcı kullanmasını istediğinizde `agentRuntime` yapılandırmasını veya `OPENCLAW_AGENT_RUNTIME` değerini değiştirin; mevcut bir konuşmayı PI ile Codex arasında geçirmeden önce yeni bir oturum başlatmak için `/new` veya `/reset` kullanın. Bu, bir dökümün iki uyumsuz yerel oturum sistemi üzerinden yeniden oynatılmasını önler.
|
||||
|
||||
Koşum sabitlemelerinden önce oluşturulmuş eski oturumlar, transkript geçmişleri olduğunda PI sabitlenmiş olarak değerlendirilir. Yapılandırmayı değiştirdikten sonra bu konuşmayı Codex'e almak için `/new` veya `/reset` kullanın.
|
||||
Çalıştırıcı sabitlemelerinden önce oluşturulan eski oturumlar, döküm geçmişleri olduğunda PI'ye sabitlenmiş olarak ele alınır. Yapılandırmayı değiştirdikten sonra bu konuşmayı Codex'e geçirmek için `/new` veya `/reset` kullanın.
|
||||
|
||||
`/status` etkin model çalışma zamanını gösterir. Varsayılan PI koşumu `Runtime: OpenClaw Pi Default` olarak, Codex uygulama sunucusu koşumu ise `Runtime: OpenAI Codex` olarak görünür.
|
||||
`/status` etkili model çalışma zamanını gösterir. Varsayılan PI çalıştırıcısı `Runtime: OpenClaw Pi Default` olarak, Codex uygulama sunucusu çalıştırıcısı ise `Runtime: OpenAI Codex` olarak görünür.
|
||||
|
||||
## Gereksinimler
|
||||
|
||||
- Birlikte gelen `codex` Plugin'i kullanılabilir olan OpenClaw.
|
||||
- Codex uygulama sunucusu `0.125.0` veya daha yeni. Birlikte gelen Plugin varsayılan olarak uyumlu bir Codex uygulama sunucusu ikilisini yönetir, bu nedenle `PATH` üzerindeki yerel `codex` komutları normal koşum başlatmasını etkilemez.
|
||||
- Uygulama sunucusu süreci veya OpenClaw'ın Codex kimlik doğrulama köprüsü için Codex kimlik doğrulaması kullanılabilir olmalıdır.
|
||||
- Codex uygulama sunucusu `0.125.0` veya daha yenisi. Birlikte gelen Plugin varsayılan olarak uyumlu bir Codex uygulama sunucusu ikilisini yönetir; bu nedenle `PATH` üzerindeki yerel `codex` komutları normal çalıştırıcı başlangıcını etkilemez.
|
||||
- Uygulama sunucusu süreci veya OpenClaw'ın Codex auth köprüsü için Codex auth kullanılabilir olmalıdır. Yerel stdio uygulama sunucusu başlatmaları her ajan için OpenClaw tarafından yönetilen bir Codex home ve yalıtılmış bir alt `HOME` kullanır; bu nedenle varsayılan olarak kişisel `~/.codex` hesabınızı, skills, plugin'leri, yapılandırmayı, iş parçacığı durumunu veya yerel `$HOME/.agents/skills` öğelerini okumazlar.
|
||||
|
||||
Plugin, daha eski veya sürümsüz uygulama sunucusu el sıkışmalarını engeller. Bu, OpenClaw'ı test edilmiş olduğu protokol yüzeyinde tutar.
|
||||
Plugin, daha eski veya sürümsüz uygulama sunucusu el sıkışmalarını engeller. Bu, OpenClaw'ı test edildiği protokol yüzeyinde tutar.
|
||||
|
||||
Canlı ve Docker duman testleri için kimlik doğrulama genellikle Codex CLI hesabından veya bir OpenClaw `openai-codex` kimlik doğrulama profilinden gelir. Yerel stdio uygulama sunucusu başlatmaları, hesap yoksa `CODEX_API_KEY` / `OPENAI_API_KEY` değerlerine de geri dönebilir.
|
||||
Canlı ve Docker duman testleri için auth genellikle Codex CLI hesabından veya bir OpenClaw `openai-codex` auth profilinden gelir. Yerel stdio uygulama sunucusu başlatmaları, hesap yoksa `CODEX_API_KEY` / `OPENAI_API_KEY` değerlerine de geri dönebilir.
|
||||
|
||||
## En küçük yapılandırma
|
||||
|
||||
`openai/gpt-5.5` kullanın, birlikte gelen Plugin'i etkinleştirin ve `codex` koşumunu zorlayın:
|
||||
`openai/gpt-5.5` kullanın, birlikte gelen Plugin'i etkinleştirin ve `codex` çalıştırıcısını zorlayın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -176,18 +178,21 @@ Yapılandırmanız `plugins.allow` kullanıyorsa, `codex` değerini oraya da ekl
|
||||
|
||||
## Codex'i diğer modellerin yanına ekleyin
|
||||
|
||||
Aynı ajan Codex ve Codex dışı sağlayıcı modelleri arasında serbestçe geçiş yapacaksa `agentRuntime.id: "codex"` değerini genel olarak ayarlamayın. Zorlanmış çalışma zamanı, o ajan veya oturum için her gömülü tura uygulanır. Bu çalışma zamanı zorlanmışken bir Anthropic modeli seçerseniz, OpenClaw yine Codex koşumunu dener ve o turu sessizce PI üzerinden yönlendirmek yerine kapalı biçimde başarısız olur.
|
||||
Aynı aracı Codex ve Codex olmayan sağlayıcı modelleri arasında serbestçe geçiş
|
||||
yapacaksa `agentRuntime.id: "codex"` değerini küresel olarak ayarlamayın. Zorunlu bir çalışma zamanı,
|
||||
o aracı veya oturumu için her gömülü dönüşe uygulanır. Bu çalışma zamanı zorunluyken
|
||||
bir Anthropic modeli seçerseniz OpenClaw yine Codex harness'ını dener ve bu dönüşü
|
||||
sessizce PI üzerinden yönlendirmek yerine kapalı şekilde başarısız olur.
|
||||
|
||||
Bunun yerine şu yapılardan birini kullanın:
|
||||
Bunun yerine şu biçimlerden birini kullanın:
|
||||
|
||||
- Codex'i `agentRuntime.id: "codex"` olan ayrılmış bir ajana koyun.
|
||||
- Varsayılan ajanı `agentRuntime.id: "auto"` üzerinde ve normal karma
|
||||
sağlayıcı kullanımı için PI geri dönüşüyle tutun.
|
||||
- Codex'i `agentRuntime.id: "codex"` ile ayrılmış bir araca koyun.
|
||||
- Varsayılan aracı normal karma sağlayıcı kullanımı için `agentRuntime.id: "auto"` ve PI fallback ile tutun.
|
||||
- Eski `codex/*` başvurularını yalnızca uyumluluk için kullanın. Yeni yapılandırmalar
|
||||
`openai/*` ile açık bir Codex çalışma zamanı politikasını tercih etmelidir.
|
||||
`openai/*` ile birlikte açık bir Codex çalışma zamanı politikasını tercih etmelidir.
|
||||
|
||||
Örneğin, bu yapı varsayılan ajanı normal otomatik seçimde tutar ve
|
||||
ayrı bir Codex ajanı ekler:
|
||||
Örneğin bu, varsayılan aracı normal otomatik seçimde tutar ve
|
||||
ayrı bir Codex aracı ekler:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -224,39 +229,39 @@ ayrı bir Codex ajanı ekler:
|
||||
}
|
||||
```
|
||||
|
||||
Bu yapıyla:
|
||||
Bu biçimle:
|
||||
|
||||
- Varsayılan `main` ajanı normal sağlayıcı yolunu ve PI uyumluluk geri dönüşünü kullanır.
|
||||
- `codex` ajanı Codex app-server bağlayıcısını kullanır.
|
||||
- Codex eksikse veya `codex` ajanı için desteklenmiyorsa, tur sessizce PI
|
||||
kullanmak yerine başarısız olur.
|
||||
- Varsayılan `main` aracı normal sağlayıcı yolunu ve PI uyumluluk fallback'ini kullanır.
|
||||
- `codex` aracı Codex uygulama sunucusu harness'ını kullanır.
|
||||
- Codex `codex` aracı için eksik veya desteklenmiyorsa dönüş, sessizce PI kullanmak
|
||||
yerine başarısız olur.
|
||||
|
||||
## Ajan komut yönlendirmesi
|
||||
## Araç komutu yönlendirme
|
||||
|
||||
Ajanlar kullanıcı isteklerini yalnızca "Codex" sözcüğüne göre değil, amaca göre yönlendirmelidir:
|
||||
Araçlar kullanıcı isteklerini yalnızca "Codex" sözcüğüne göre değil, amaca göre yönlendirmelidir:
|
||||
|
||||
| Kullanıcı şunu ister... | Ajan şunu kullanmalıdır... |
|
||||
| Kullanıcı şunu ister... | Araç şunu kullanmalıdır... |
|
||||
| -------------------------------------------------------- | ------------------------------------------------ |
|
||||
| "Bu sohbeti Codex'e bağla" | `/codex bind` |
|
||||
| "Codex iş parçacığı `<id>` burada sürdürülsün" | `/codex resume <id>` |
|
||||
| "Codex iş parçacıklarını göster" | `/codex threads` |
|
||||
| "Kötü bir Codex çalıştırması için destek raporu oluştur" | `/diagnostics [note]` |
|
||||
| "Kötü bir Codex çalışması için destek raporu oluştur" | `/diagnostics [note]` |
|
||||
| "Yalnızca bu ekli iş parçacığı için Codex geri bildirimi gönder" | `/codex diagnostics [note]` |
|
||||
| "Bu ajan için çalışma zamanı olarak Codex kullan" | `agentRuntime.id` için yapılandırma değişikliği |
|
||||
| "Bu araç için çalışma zamanı olarak Codex kullan" | `agentRuntime.id` için yapılandırma değişikliği |
|
||||
| "Normal OpenClaw ile ChatGPT/Codex aboneliğimi kullan" | `openai-codex/*` model başvuruları |
|
||||
| "Codex'i ACP/acpx üzerinden çalıştır" | ACP `sessions_spawn({ runtime: "acp", ... })` |
|
||||
| "Bir iş parçacığında Claude Code/Gemini/OpenCode/Cursor başlat" | ACP/acpx, `/codex` değil ve yerel alt ajanlar değil |
|
||||
| "Claude Code/Gemini/OpenCode/Cursor'ı bir iş parçacığında başlat" | ACP/acpx, `/codex` değil ve yerel alt araçlar değil |
|
||||
|
||||
OpenClaw, ACP oluşturma kılavuzunu ajanlara yalnızca ACP etkinleştirildiğinde,
|
||||
gönderilebilir olduğunda ve yüklenmiş bir çalışma zamanı arka ucu tarafından desteklendiğinde
|
||||
duyurur. ACP kullanılamıyorsa, sistem istemi ve Plugin Skills ajana ACP
|
||||
OpenClaw, ACP spawn kılavuzunu araçlara yalnızca ACP etkin,
|
||||
gönderilebilir ve yüklü bir çalışma zamanı arka ucu tarafından destekleniyorsa duyurur.
|
||||
ACP kullanılabilir değilse, sistem prompt'u ve Plugin Skills araca ACP
|
||||
yönlendirmesini öğretmemelidir.
|
||||
|
||||
## Yalnızca Codex dağıtımları
|
||||
|
||||
Her gömülü ajan turunun Codex kullandığını kanıtlamanız gerektiğinde Codex bağlayıcısını
|
||||
zorunlu kılın. Açık Plugin çalışma zamanları varsayılan olarak PI geri dönüşü kullanmaz, bu nedenle
|
||||
`fallback: "none"` isteğe bağlıdır ancak çoğu zaman dokümantasyon olarak kullanışlıdır:
|
||||
Her gömülü araç dönüşünün Codex kullandığını kanıtlamanız gerektiğinde Codex harness'ını
|
||||
zorunlu kılın. Açık Plugin çalışma zamanları varsayılan olarak PI fallback olmadan gelir, bu yüzden
|
||||
`fallback: "none"` isteğe bağlıdır ancak çoğu zaman belgelendirme açısından yararlıdır:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -278,15 +283,14 @@ Ortam geçersiz kılması:
|
||||
OPENCLAW_AGENT_RUNTIME=codex openclaw gateway run
|
||||
```
|
||||
|
||||
Codex zorunlu kılındığında, Codex Plugin devre dışıysa, app-server çok eskiyse
|
||||
veya app-server başlatılamıyorsa OpenClaw erken başarısız olur.
|
||||
`OPENCLAW_AGENT_HARNESS_FALLBACK=pi` ayarını yalnızca eksik bağlayıcı seçimini
|
||||
bilerek PI'ın işlemesini istiyorsanız belirleyin.
|
||||
Codex zorunlu kılındığında, Codex Plugin devre dışıysa, uygulama sunucusu
|
||||
çok eskiyse veya uygulama sunucusu başlatılamıyorsa OpenClaw erken başarısız olur.
|
||||
`OPENCLAW_AGENT_HARNESS_FALLBACK=pi` değerini yalnızca eksik harness seçimini
|
||||
bilerek PI'ın işlemesini istiyorsanız ayarlayın.
|
||||
|
||||
## Ajan başına Codex
|
||||
## Araç bazında Codex
|
||||
|
||||
Varsayılan ajan normal otomatik seçimi korurken bir ajanı yalnızca Codex kullanacak
|
||||
hale getirebilirsiniz:
|
||||
Varsayılan araç normal otomatik seçimi korurken bir aracı yalnızca Codex yapabilirsiniz:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -317,15 +321,16 @@ hale getirebilirsiniz:
|
||||
}
|
||||
```
|
||||
|
||||
Ajanlar ve modeller arasında geçiş yapmak için normal oturum komutlarını kullanın. `/new` yeni bir
|
||||
OpenClaw oturumu oluşturur ve Codex bağlayıcısı gerektiğinde yan app-server
|
||||
iş parçacığını oluşturur veya sürdürür. `/reset`, bu iş parçacığı için OpenClaw oturum bağlamasını
|
||||
temizler ve bir sonraki turun bağlayıcıyı geçerli yapılandırmadan yeniden çözmesine izin verir.
|
||||
Araçlar ve modeller arasında geçiş yapmak için normal oturum komutlarını kullanın.
|
||||
`/new` yeni bir OpenClaw oturumu oluşturur ve Codex harness'ı gerektiğinde kendi
|
||||
sidecar uygulama sunucusu iş parçacığını oluşturur veya sürdürür. `/reset`, o iş parçacığı için
|
||||
OpenClaw oturum bağlamasını temizler ve bir sonraki dönüşün harness'ı geçerli
|
||||
yapılandırmadan yeniden çözmesine izin verir.
|
||||
|
||||
## Model keşfi
|
||||
|
||||
Varsayılan olarak Codex Plugin, kullanılabilir modeller için app-server'a sorar. Keşif başarısız olursa
|
||||
veya zaman aşımına uğrarsa, şunlar için paketlenmiş bir geri dönüş kataloğu kullanır:
|
||||
Varsayılan olarak Codex Plugin, mevcut modelleri uygulama sunucusundan ister. Keşif
|
||||
başarısız olur veya zaman aşımına uğrarsa şu modeller için paketlenmiş fallback kataloğunu kullanır:
|
||||
|
||||
- GPT-5.5
|
||||
- GPT-5.4 mini
|
||||
@ -351,7 +356,8 @@ Keşfi `plugins.entries.codex.config.discovery` altında ayarlayabilirsiniz:
|
||||
}
|
||||
```
|
||||
|
||||
Başlatmanın Codex'i yoklamaktan kaçınmasını ve yedek katalogla kalmasını istediğinizde keşfi devre dışı bırakın:
|
||||
Başlangıcın Codex'i yoklamasını önlemek ve fallback kataloğuna bağlı kalmak
|
||||
istediğinizde keşfi devre dışı bırakın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -370,7 +376,7 @@ Başlatmanın Codex'i yoklamaktan kaçınmasını ve yedek katalogla kalmasını
|
||||
}
|
||||
```
|
||||
|
||||
## App-server bağlantısı ve ilkesi
|
||||
## Uygulama sunucusu bağlantısı ve politika
|
||||
|
||||
Varsayılan olarak Plugin, OpenClaw'ın yönetilen Codex ikilisini yerel olarak şununla başlatır:
|
||||
|
||||
@ -378,12 +384,20 @@ Varsayılan olarak Plugin, OpenClaw'ın yönetilen Codex ikilisini yerel olarak
|
||||
codex app-server --listen stdio://
|
||||
```
|
||||
|
||||
Yönetilen ikili, paketlenmiş bir Plugin çalışma zamanı bağımlılığı olarak bildirilir ve `codex` Plugin bağımlılıklarının geri kalanıyla birlikte hazırlanır. Bu, app-server sürümünü yerel olarak kurulu olabilecek ayrı bir Codex CLI yerine paketlenmiş Plugin'e bağlı tutar. `appServer.command` ayarını yalnızca bilerek farklı bir yürütülebilir dosya çalıştırmak istediğinizde yapın.
|
||||
Yönetilen ikili, paketlenmiş bir Plugin çalışma zamanı bağımlılığı olarak bildirilir ve
|
||||
diğer `codex` Plugin bağımlılıklarıyla birlikte hazırlanır. Bu, uygulama sunucusu
|
||||
sürümünü yerel olarak kurulu olabilecek ayrı Codex CLI yerine paketlenmiş Plugin'e
|
||||
bağlı tutar. `appServer.command` değerini yalnızca bilerek farklı bir çalıştırılabilir
|
||||
dosya çalıştırmak istediğinizde ayarlayın.
|
||||
|
||||
Varsayılan olarak OpenClaw, yerel Codex harness oturumlarını YOLO modunda başlatır: `approvalPolicy: "never"`, `approvalsReviewer: "user"` ve `sandbox: "danger-full-access"`. Bu, otonom heartbeat'ler için kullanılan güvenilir yerel operatör duruşudur: Codex, yanıtlayacak kimse olmadığında yerel onay istemlerinde durmadan kabuk ve ağ araçlarını kullanabilir.
|
||||
Varsayılan olarak OpenClaw, yerel Codex harness oturumlarını YOLO modunda başlatır:
|
||||
`approvalPolicy: "never"`, `approvalsReviewer: "user"` ve
|
||||
`sandbox: "danger-full-access"`. Bu, otonom Heartbeat'ler için kullanılan güvenilir
|
||||
yerel operatör duruşudur: Codex, yanıtlayacak kimse yokken yerel onay prompt'larında
|
||||
durmadan shell ve ağ araçlarını kullanabilir.
|
||||
|
||||
Codex guardian tarafından incelenen onaylara dahil olmak için `appServer.mode:
|
||||
"guardian"` ayarını yapın:
|
||||
Codex guardian tarafından incelenen onaylara katılmak için `appServer.mode:
|
||||
"guardian"` değerini ayarlayın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -403,11 +417,21 @@ Codex guardian tarafından incelenen onaylara dahil olmak için `appServer.mode:
|
||||
}
|
||||
```
|
||||
|
||||
Guardian modu, Codex'in yerel otomatik inceleme onay yolunu kullanır. Codex sandbox dışına çıkmayı, çalışma alanı dışına yazmayı veya ağ erişimi gibi izinler eklemeyi istediğinde, Codex bu onay isteğini insan istemi yerine yerel inceleyiciye yönlendirir. İnceleyici, Codex'in risk çerçevesini uygular ve belirli isteği onaylar veya reddeder. YOLO modundan daha fazla koruma istediğinizde, ancak gözetimsiz ajanların yine de ilerleme kaydetmesi gerektiğinde Guardian kullanın.
|
||||
Guardian modu, Codex'in yerel otomatik inceleme onay yolunu kullanır. Codex
|
||||
sandbox dışına çıkmayı, çalışma alanı dışına yazmayı veya ağ erişimi gibi izinler
|
||||
eklemeyi istediğinde, Codex bu onay isteğini insan prompt'u yerine yerel inceleyiciye
|
||||
yönlendirir. İnceleyici Codex'in risk çerçevesini uygular ve belirli isteği onaylar
|
||||
veya reddeder. YOLO modundan daha fazla koruma istediğiniz ancak yine de gözetimsiz
|
||||
araçların ilerlemesini sağlamak zorunda olduğunuzda Guardian kullanın.
|
||||
|
||||
`guardian` ön ayarı `approvalPolicy: "on-request"`, `approvalsReviewer: "auto_review"` ve `sandbox: "workspace-write"` olarak genişler. Tek tek ilke alanları yine de `mode` değerini geçersiz kılar, böylece gelişmiş dağıtımlar ön ayarı açık seçimlerle karıştırabilir. Daha eski `guardian_subagent` inceleyici değeri uyumluluk diğer adı olarak hâlâ kabul edilir, ancak yeni yapılandırmalar `auto_review` kullanmalıdır.
|
||||
`guardian` hazır ayarı `approvalPolicy: "on-request"`,
|
||||
`approvalsReviewer: "auto_review"` ve `sandbox: "workspace-write"` olarak genişler.
|
||||
Tek tek politika alanları yine de `mode` değerini geçersiz kılar, böylece ileri düzey
|
||||
dağıtımlar hazır ayarı açık seçimlerle karıştırabilir. Eski `guardian_subagent`
|
||||
inceleyici değeri uyumluluk takma adı olarak hâlâ kabul edilir, ancak yeni yapılandırmalar
|
||||
`auto_review` kullanmalıdır.
|
||||
|
||||
Zaten çalışmakta olan bir app-server için WebSocket aktarımını kullanın:
|
||||
Zaten çalışan bir uygulama sunucusu için WebSocket aktarımını kullanın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -429,15 +453,49 @@ Zaten çalışmakta olan bir app-server için WebSocket aktarımını kullanın:
|
||||
}
|
||||
```
|
||||
|
||||
Stdio app-server başlatmaları varsayılan olarak OpenClaw'ın süreç ortamını devralır, ancak Codex app-server hesap köprüsünün sahibi OpenClaw'dır. Kimlik doğrulama şu sırayla seçilir:
|
||||
Stdio uygulama sunucusu başlatmaları varsayılan olarak OpenClaw'ın süreç ortamını devralır,
|
||||
ancak OpenClaw Codex uygulama sunucusu hesap köprüsünü sahiplenir ve hem
|
||||
`CODEX_HOME` hem de `HOME` değerlerini o aracın OpenClaw durumu altındaki araç bazlı
|
||||
dizinlere ayarlar. Codex'in kendi Skills yükleyicisi `$CODEX_HOME/skills` ve
|
||||
`$HOME/.agents/skills` dizinlerini okur, bu nedenle her iki değer de yerel uygulama sunucusu
|
||||
başlatmaları için yalıtılır. Bu, Codex'e yerel Skills, Plugins, yapılandırma, hesaplar
|
||||
ve iş parçacığı durumunun operatörün kişisel Codex CLI ana dizininden sızmak yerine
|
||||
OpenClaw aracına kapsamlanmasını sağlar.
|
||||
|
||||
1. Ajan için açık bir OpenClaw Codex kimlik doğrulama profili.
|
||||
2. Yerel Codex CLI ChatGPT oturumu gibi app-server'ın mevcut hesabı.
|
||||
3. Yalnızca yerel stdio app-server başlatmaları için, app-server hesabı yoksa ve OpenAI kimlik doğrulaması hâlâ gerekiyorsa önce `CODEX_API_KEY`, ardından `OPENAI_API_KEY`.
|
||||
OpenClaw Plugins ve OpenClaw Skills anlık görüntüleri yine OpenClaw'ın kendi
|
||||
Plugin kayıt defteri ve Skills yükleyicisi üzerinden akar. Kişisel Codex CLI varlıkları
|
||||
akmaz. Bir OpenClaw aracının parçası olması gereken yararlı Codex CLI Skills veya
|
||||
Plugins öğeleriniz varsa bunların envanterini açıkça çıkarın:
|
||||
|
||||
OpenClaw, ChatGPT abonelik stili bir Codex kimlik doğrulama profili gördüğünde, oluşturulan Codex alt sürecinden `CODEX_API_KEY` ve `OPENAI_API_KEY` değerlerini kaldırır. Bu, Gateway düzeyi API anahtarlarını embeddings veya doğrudan OpenAI modelleri için kullanılabilir tutarken yerel Codex app-server turlarının yanlışlıkla API üzerinden ücretlendirilmesini önler. Açık Codex API anahtarı profilleri ve yerel stdio ortam anahtarı yedeği, devralınan alt süreç ortamı yerine app-server oturum açmasını kullanır. WebSocket app-server bağlantıları Gateway ortam API anahtarı yedeğini almaz; açık bir kimlik doğrulama profili veya uzak app-server'ın kendi hesabını kullanın.
|
||||
```bash
|
||||
openclaw migrate codex --dry-run
|
||||
openclaw migrate apply codex --yes
|
||||
```
|
||||
|
||||
Bir dağıtım ek ortam yalıtımı gerektiriyorsa, bu değişkenleri `appServer.clearEnv` içine ekleyin:
|
||||
Codex geçiş sağlayıcısı Skills öğelerini geçerli OpenClaw aracı çalışma alanına
|
||||
kopyalar. Codex yerel Plugins, hook'lar ve yapılandırma dosyaları otomatik olarak
|
||||
etkinleştirilmek yerine manuel inceleme için raporlanır veya arşivlenir, çünkü bunlar
|
||||
komut çalıştırabilir, MCP sunucuları açığa çıkarabilir veya kimlik bilgileri taşıyabilir.
|
||||
|
||||
Kimlik doğrulama şu sırayla seçilir:
|
||||
|
||||
1. Araç için açık bir OpenClaw Codex kimlik doğrulama profili.
|
||||
2. Uygulama sunucusunun o aracın Codex ana dizinindeki mevcut hesabı.
|
||||
3. Yalnızca yerel stdio uygulama sunucusu başlatmaları için, uygulama sunucusu hesabı
|
||||
yoksa ve OpenAI kimlik doğrulaması hâlâ gerekiyorsa `CODEX_API_KEY`, ardından
|
||||
`OPENAI_API_KEY`.
|
||||
|
||||
OpenClaw, ChatGPT aboneliği tarzı bir Codex kimlik doğrulama profili gördüğünde
|
||||
oluşturulan Codex alt sürecinden `CODEX_API_KEY` ve `OPENAI_API_KEY` değerlerini kaldırır.
|
||||
Bu, Gateway düzeyindeki API anahtarlarını embeddings veya doğrudan OpenAI modelleri için
|
||||
kullanılabilir tutarken yerel Codex uygulama sunucusu dönüşlerinin yanlışlıkla API üzerinden
|
||||
faturalandırılmasını engeller. Açık Codex API anahtarı profilleri ve yerel stdio ortam anahtarı
|
||||
fallback'i, devralınmış alt süreç ortamı yerine uygulama sunucusu oturum açmasını kullanır.
|
||||
WebSocket uygulama sunucusu bağlantıları Gateway ortam API anahtarı fallback'i almaz;
|
||||
açık bir kimlik doğrulama profili veya uzak uygulama sunucusunun kendi hesabını kullanın.
|
||||
|
||||
Bir dağıtım ek ortam yalıtımına ihtiyaç duyuyorsa bu değişkenleri
|
||||
`appServer.clearEnv` değerine ekleyin:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -456,41 +514,41 @@ Bir dağıtım ek ortam yalıtımı gerektiriyorsa, bu değişkenleri `appServer
|
||||
}
|
||||
```
|
||||
|
||||
`appServer.clearEnv` yalnızca oluşturulan Codex app-server alt sürecini etkiler.
|
||||
`appServer.clearEnv` yalnızca oluşturulan Codex uygulama sunucusu alt sürecini etkiler.
|
||||
|
||||
Desteklenen `appServer` alanları:
|
||||
|
||||
| Alan | Varsayılan | Anlam |
|
||||
| ------------------- | ---------------------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `transport` | `"stdio"` | `"stdio"` Codex'i başlatır; `"websocket"` `url` adresine bağlanır. |
|
||||
| `command` | yönetilen Codex ikilisi | stdio aktarımı için yürütülebilir dosya. Yönetilen ikiliyi kullanmak için ayarlanmamış bırakın; yalnızca açık bir geçersiz kılma için ayarlayın. |
|
||||
| `args` | `["app-server", "--listen", "stdio://"]` | stdio aktarımı için bağımsız değişkenler. |
|
||||
| `url` | ayarlanmamış | WebSocket app-server URL'si. |
|
||||
| `authToken` | ayarlanmamış | WebSocket aktarımı için Bearer belirteci. |
|
||||
| `headers` | `{}` | Ek WebSocket üst bilgileri. |
|
||||
| `clearEnv` | `[]` | OpenClaw devralınan ortamını oluşturduktan sonra başlatılan stdio app-server sürecinden kaldırılan ek ortam değişkeni adları. |
|
||||
| `requestTimeoutMs` | `60000` | app-server kontrol düzlemi çağrıları için zaman aşımı. |
|
||||
| `mode` | `"yolo"` | YOLO veya guardian tarafından incelenen yürütme için ön ayar. |
|
||||
| `approvalPolicy` | `"never"` | İş parçacığı başlatma/sürdürme/tur için gönderilen yerel Codex onay ilkesi. |
|
||||
| `sandbox` | `"danger-full-access"` | İş parçacığı başlatma/sürdürme için gönderilen yerel Codex sandbox modu. |
|
||||
| `approvalsReviewer` | `"user"` | Codex'in yerel onay istemlerini incelemesine izin vermek için `"auto_review"` kullanın. `guardian_subagent` eski bir diğer ad olarak kalır. |
|
||||
| `serviceTier` | ayarlanmamış | İsteğe bağlı Codex app-server hizmet katmanı: `"fast"`, `"flex"` veya `null`. Geçersiz eski değerler yok sayılır. |
|
||||
| Alan | Varsayılan | Anlam |
|
||||
| ------------------- | ---------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
|
||||
| `transport` | `"stdio"` | `"stdio"` Codex'i başlatır; `"websocket"` `url`'ye bağlanır. |
|
||||
| `command` | yönetilen Codex ikilisi | stdio taşıması için yürütülebilir dosya. Yönetilen ikiliyi kullanmak için ayarlanmamış bırakın; yalnızca açık bir geçersiz kılma için ayarlayın. |
|
||||
| `args` | `["app-server", "--listen", "stdio://"]` | stdio taşıması için bağımsız değişkenler. |
|
||||
| `url` | ayarlanmamış | WebSocket app-server URL'si. |
|
||||
| `authToken` | ayarlanmamış | WebSocket taşıması için Bearer token. |
|
||||
| `headers` | `{}` | Ek WebSocket üstbilgileri. |
|
||||
| `clearEnv` | `[]` | OpenClaw devralınan ortamını oluşturduktan sonra başlatılan stdio app-server sürecinden kaldırılan ek ortam değişkeni adları. `CODEX_HOME` ve `HOME`, yerel başlatmalarda OpenClaw'ın aracı başına Codex yalıtımı için ayrılmıştır. |
|
||||
| `requestTimeoutMs` | `60000` | app-server denetim düzlemi çağrıları için zaman aşımı. |
|
||||
| `mode` | `"yolo"` | YOLO veya guardian incelemeli yürütme için ön ayar. |
|
||||
| `approvalPolicy` | `"never"` | İş parçacığı başlatma/sürdürme/turn işlemine gönderilen yerel Codex onay politikası. |
|
||||
| `sandbox` | `"danger-full-access"` | İş parçacığı başlatma/sürdürme işlemine gönderilen yerel Codex sandbox modu. |
|
||||
| `approvalsReviewer` | `"user"` | Codex'in yerel onay istemlerini incelemesine izin vermek için `"auto_review"` kullanın. `guardian_subagent` eski bir takma ad olarak kalır. |
|
||||
| `serviceTier` | ayarlanmamış | İsteğe bağlı Codex app-server hizmet katmanı: `"fast"`, `"flex"` veya `null`. Geçersiz eski değerler yok sayılır. |
|
||||
|
||||
OpenClaw'a ait dinamik araç çağrıları `appServer.requestTimeoutMs` değerinden
|
||||
bağımsız olarak sınırlandırılır: her Codex `item/tool/call` isteği 30 saniye
|
||||
içinde bir OpenClaw yanıtı almalıdır. Zaman aşımında OpenClaw, desteklendiği
|
||||
yerlerde araç sinyalini iptal eder ve Codex'e başarısız bir dinamik araç yanıtı
|
||||
döndürür; böylece oturumu `processing` durumunda bırakmak yerine turun devam
|
||||
etmesi sağlanır.
|
||||
döndürür; böylece oturumu `processing` durumunda bırakmak yerine turn devam
|
||||
edebilir.
|
||||
|
||||
OpenClaw, Codex tur kapsamlı bir app-server isteğine yanıt verdikten sonra,
|
||||
harness ayrıca Codex'in yerel turu `turn/completed` ile bitirmesini bekler. Bu
|
||||
yanıttan sonra app-server 60 saniye sessiz kalırsa OpenClaw en iyi çabayla
|
||||
Codex turunu keser, tanısal bir zaman aşımı kaydeder ve OpenClaw oturum şeridini
|
||||
serbest bırakır; böylece takip eden sohbet iletileri eski bir yerel turun
|
||||
arkasında kuyruğa alınmaz.
|
||||
OpenClaw, Codex turn kapsamlı bir app-server isteğine yanıt verdikten sonra,
|
||||
harness ayrıca Codex'in yerel turn işlemini `turn/completed` ile bitirmesini
|
||||
bekler. app-server bu yanıttan sonra 60 saniye sessiz kalırsa, OpenClaw en iyi
|
||||
çabayla Codex turn işlemini keser, tanısal bir zaman aşımı kaydeder ve OpenClaw
|
||||
oturum şeridini serbest bırakır; böylece takip sohbet mesajları bayat bir yerel
|
||||
turn arkasında kuyruğa alınmaz.
|
||||
|
||||
Ortam geçersiz kılmaları yerel testler için kullanılabilir kalır:
|
||||
Yerel test için ortam geçersiz kılmaları kullanılabilir kalır:
|
||||
|
||||
- `OPENCLAW_CODEX_APP_SERVER_BIN`
|
||||
- `OPENCLAW_CODEX_APP_SERVER_ARGS`
|
||||
@ -498,33 +556,34 @@ Ortam geçersiz kılmaları yerel testler için kullanılabilir kalır:
|
||||
- `OPENCLAW_CODEX_APP_SERVER_APPROVAL_POLICY`
|
||||
- `OPENCLAW_CODEX_APP_SERVER_SANDBOX`
|
||||
|
||||
`OPENCLAW_CODEX_APP_SERVER_BIN`, `appServer.command` ayarlanmamış olduğunda
|
||||
yönetilen ikiliyi atlar.
|
||||
`OPENCLAW_CODEX_APP_SERVER_BIN`, `appServer.command` ayarlanmamışken yönetilen
|
||||
ikiliyi atlar.
|
||||
|
||||
`OPENCLAW_CODEX_APP_SERVER_GUARDIAN=1` kaldırıldı. Bunun yerine
|
||||
`plugins.entries.codex.config.appServer.mode: "guardian"` kullanın veya tek
|
||||
seferlik yerel test için `OPENCLAW_CODEX_APP_SERVER_MODE=guardian` kullanın.
|
||||
Yapılandırma, Plugin davranışını Codex harness kurulumunun geri kalanıyla aynı
|
||||
incelenen dosyada tuttuğu için tekrarlanabilir dağıtımlarda tercih edilir.
|
||||
Tekrarlanabilir dağıtımlar için yapılandırma tercih edilir; çünkü Plugin
|
||||
davranışını Codex harness kurulumunun geri kalanıyla aynı incelenmiş dosyada
|
||||
tutar.
|
||||
|
||||
## Bilgisayar kullanımı
|
||||
|
||||
Bilgisayar Kullanımı kendi kurulum kılavuzunda ele alınır:
|
||||
[Codex Bilgisayar Kullanımı](/tr/plugins/codex-computer-use).
|
||||
Computer Use kendi kurulum kılavuzunda ele alınır:
|
||||
[Codex Computer Use](/tr/plugins/codex-computer-use).
|
||||
|
||||
Kısa sürüm: OpenClaw masaüstü denetim uygulamasını vendorlama yapmaz veya
|
||||
Kısa sürüm: OpenClaw masaüstü denetim uygulamasını vendor olarak içermez veya
|
||||
masaüstü eylemlerini kendisi yürütmez. Codex app-server'ı hazırlar,
|
||||
`computer-use` MCP sunucusunun kullanılabilir olduğunu doğrular ve ardından
|
||||
Codex modu turları sırasında yerel MCP araç çağrılarını Codex'in yönetmesine
|
||||
izin verir.
|
||||
Codex modu turn işlemleri sırasında yerel MCP araç çağrılarını Codex'in
|
||||
yönetmesine izin verir.
|
||||
|
||||
Codex marketplace akışı dışında doğrudan TryCua sürücü erişimi için
|
||||
`cua-driver mcp` öğesini `openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'`
|
||||
ile kaydedin. Codex'e ait Bilgisayar Kullanımı ile doğrudan MCP kaydı
|
||||
arasındaki ayrım için [Codex Bilgisayar Kullanımı](/tr/plugins/codex-computer-use)
|
||||
`openclaw mcp set cua-driver '{"command":"cua-driver","args":["mcp"]}'` ile
|
||||
`cua-driver mcp` kaydedin. Codex'e ait Computer Use ile doğrudan MCP kaydı
|
||||
arasındaki ayrım için [Codex Computer Use](/tr/plugins/codex-computer-use)
|
||||
sayfasına bakın.
|
||||
|
||||
En düşük yapılandırma:
|
||||
En küçük yapılandırma:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -552,31 +611,31 @@ En düşük yapılandırma:
|
||||
}
|
||||
```
|
||||
|
||||
Kurulum komut yüzeyinden denetlenebilir veya yüklenebilir:
|
||||
Kurulum komut yüzeyinden denetlenebilir veya kurulabilir:
|
||||
|
||||
- `/codex computer-use status`
|
||||
- `/codex computer-use install`
|
||||
- `/codex computer-use install --source <marketplace-source>`
|
||||
- `/codex computer-use install --marketplace-path <path>`
|
||||
|
||||
Bilgisayar Kullanımı macOS'a özgüdür ve Codex MCP sunucusu uygulamaları
|
||||
denetleyebilmeden önce yerel işletim sistemi izinleri gerektirebilir.
|
||||
`computerUse.enabled` true ise ve MCP sunucusu kullanılamıyorsa, Codex modu
|
||||
turları yerel Bilgisayar Kullanımı araçları olmadan sessizce çalışmak yerine iş
|
||||
parçacığı başlamadan önce başarısız olur. Marketplace seçenekleri, uzak katalog
|
||||
sınırları, durum nedenleri ve sorun giderme için
|
||||
[Codex Bilgisayar Kullanımı](/tr/plugins/codex-computer-use) sayfasına bakın.
|
||||
Computer Use macOS'a özeldir ve Codex MCP sunucusu uygulamaları denetleyebilmeden
|
||||
önce yerel işletim sistemi izinleri gerektirebilir. `computerUse.enabled` true
|
||||
ise ve MCP sunucusu kullanılamıyorsa, Codex modu turn işlemleri yerel Computer
|
||||
Use araçları olmadan sessizce çalışmak yerine iş parçacığı başlamadan önce
|
||||
başarısız olur. Marketplace seçenekleri, uzak katalog sınırları, durum
|
||||
nedenleri ve sorun giderme için
|
||||
[Codex Computer Use](/tr/plugins/codex-computer-use) sayfasına bakın.
|
||||
|
||||
`computerUse.autoInstall` true olduğunda, Codex henüz yerel bir marketplace
|
||||
keşfetmediyse OpenClaw standart paketlenmiş Codex Desktop marketplace'ini
|
||||
`/Applications/Codex.app/Contents/Resources/plugins/openai-bundled`
|
||||
konumundan kaydedebilir. Mevcut oturumların eski bir PI veya Codex iş parçacığı
|
||||
bağını korumaması için çalışma zamanı ya da Bilgisayar Kullanımı yapılandırmasını
|
||||
değiştirdikten sonra `/new` veya `/reset` kullanın.
|
||||
keşfetmediyse OpenClaw standart paketli Codex Desktop marketplace'ini
|
||||
`/Applications/Codex.app/Contents/Resources/plugins/openai-bundled` konumundan
|
||||
kaydedebilir. Mevcut oturumların eski bir PI veya Codex iş parçacığı bağını
|
||||
korumaması için runtime veya Computer Use yapılandırmasını değiştirdikten sonra
|
||||
`/new` veya `/reset` kullanın.
|
||||
|
||||
## Yaygın tarifler
|
||||
|
||||
Varsayılan stdio aktarımıyla yerel Codex:
|
||||
Varsayılan stdio taşımasıyla yerel Codex:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -612,7 +671,7 @@ Yalnızca Codex harness doğrulaması:
|
||||
}
|
||||
```
|
||||
|
||||
Guardian tarafından incelenen Codex onayları:
|
||||
Guardian incelemeli Codex onayları:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -634,7 +693,7 @@ Guardian tarafından incelenen Codex onayları:
|
||||
}
|
||||
```
|
||||
|
||||
Açık üst bilgilerle uzak app-server:
|
||||
Açık üstbilgilere sahip uzak app-server:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -658,115 +717,75 @@ Açık üst bilgilerle uzak app-server:
|
||||
```
|
||||
|
||||
Model değiştirme OpenClaw denetiminde kalır. Bir OpenClaw oturumu mevcut bir
|
||||
Codex iş parçacığına bağlandığında, sonraki tur şu anda seçili OpenAI modelini,
|
||||
sağlayıcıyı, onay ilkesini, sandbox'ı ve hizmet katmanını app-server'a yeniden
|
||||
gönderir. `openai/gpt-5.5` modelinden `openai/gpt-5.2` modeline geçmek iş
|
||||
parçacığı bağını korur, ancak Codex'ten yeni seçilen modelle devam etmesini
|
||||
Codex iş parçacığına bağlı olduğunda, sonraki turn seçili OpenAI modelini,
|
||||
sağlayıcıyı, onay politikasını, sandbox'ı ve hizmet katmanını app-server'a
|
||||
yeniden gönderir. `openai/gpt-5.5` modelinden `openai/gpt-5.2` modeline geçmek
|
||||
iş parçacığı bağını korur ancak Codex'ten yeni seçilen modelle devam etmesini
|
||||
ister.
|
||||
|
||||
## Codex komutu
|
||||
|
||||
Paketlenmiş Plugin, `/codex` komutunu yetkili bir eğik çizgi komutu olarak
|
||||
kaydeder. Geneldir ve OpenClaw metin komutlarını destekleyen tüm kanallarda
|
||||
çalışır.
|
||||
Paketli Plugin, `/codex` komutunu yetkili bir slash komutu olarak kaydeder.
|
||||
Geneldir ve OpenClaw metin komutlarını destekleyen herhangi bir kanalda çalışır.
|
||||
|
||||
Yaygın biçimler:
|
||||
|
||||
- `/codex status` canlı app-server bağlantısını, modelleri, hesabı, hız sınırlarını, MCP sunucularını ve Skills öğelerini gösterir.
|
||||
- `/codex status` canlı app-server bağlantısını, modelleri, hesabı, hız sınırlarını, MCP sunucularını ve skills öğelerini gösterir.
|
||||
- `/codex models` canlı Codex app-server modellerini listeler.
|
||||
- `/codex threads [filter]` son Codex iş parçacıklarını listeler.
|
||||
- `/codex resume <thread-id>` geçerli OpenClaw oturumunu mevcut bir Codex iş parçacığına bağlar.
|
||||
- `/codex resume <thread-id>` mevcut OpenClaw oturumunu var olan bir Codex iş parçacığına bağlar.
|
||||
- `/codex compact` Codex app-server'dan bağlı iş parçacığını sıkıştırmasını ister.
|
||||
- `/codex review` bağlı iş parçacığı için Codex yerel incelemesini başlatır.
|
||||
- `/codex diagnostics [note]` bağlı iş parçacığı için Codex tanılama geri bildirimi göndermeden önce sorar.
|
||||
- `/codex computer-use status` yapılandırılan Bilgisayar Kullanımı Plugin'ini ve MCP sunucusunu denetler.
|
||||
- `/codex computer-use install` yapılandırılan Bilgisayar Kullanımı Plugin'ini yükler ve MCP sunucularını yeniden yükler.
|
||||
- `/codex computer-use status` yapılandırılmış Computer Use Plugin'ini ve MCP sunucusunu denetler.
|
||||
- `/codex computer-use install` yapılandırılmış Computer Use Plugin'ini kurar ve MCP sunucularını yeniden yükler.
|
||||
- `/codex account` hesap ve hız sınırı durumunu gösterir.
|
||||
- `/codex mcp` Codex app-server MCP sunucu durumunu listeler.
|
||||
- `/codex mcp` Codex app-server MCP sunucusu durumunu listeler.
|
||||
- `/codex skills` Codex app-server skills öğelerini listeler.
|
||||
|
||||
### Yaygın hata ayıklama iş akışı
|
||||
|
||||
Codex destekli bir agent Telegram, Discord, Slack veya başka bir kanalda
|
||||
beklenmedik bir şey yaptığında, sorunun gerçekleştiği konuşmayla başlayın:
|
||||
Codex destekli bir aracı Telegram, Discord, Slack veya başka bir kanalda
|
||||
şaşırtıcı bir şey yaptığında, sorunun yaşandığı konuşmayla başlayın:
|
||||
|
||||
1. `/diagnostics bad tool choice after image upload` komutunu veya gördüğünüzü
|
||||
açıklayan başka bir kısa notu çalıştırın.
|
||||
2. Tanılama isteğini bir kez onaylayın. Onay, yerel Gateway tanılama zip dosyasını
|
||||
oluşturur ve oturum Codex harness kullandığı için ilgili Codex geri bildirim
|
||||
paketini OpenAI sunucularına da gönderir.
|
||||
3. Tamamlanan tanılama yanıtını hata raporuna veya destek iş parçacığına kopyalayın.
|
||||
Yerel paket yolunu, gizlilik özetini, OpenClaw oturum kimliklerini, Codex iş
|
||||
parçacığı kimliklerini ve her Codex iş parçacığı için bir `Inspect locally`
|
||||
satırını içerir.
|
||||
4. Çalıştırmayı kendiniz hata ayıklamak istiyorsanız, yazdırılan `Inspect locally`
|
||||
komutunu bir terminalde çalıştırın. `codex resume <thread-id>` gibi görünür ve
|
||||
konuşmayı inceleyebilmeniz, yerelde sürdürebilmeniz veya Codex'e neden belirli
|
||||
bir aracı ya da planı seçtiğini sorabilmeniz için yerel Codex iş parçacığını
|
||||
açar.
|
||||
1. Gördüğünüzü açıklayan `/diagnostics bad tool choice after image upload` veya
|
||||
başka bir kısa not çalıştırın.
|
||||
2. Tanılama isteğini bir kez onaylayın. Onay, yerel Gateway tanılama zip
|
||||
dosyasını oluşturur ve oturum Codex harness kullandığı için ilgili Codex geri
|
||||
bildirim paketini de OpenAI sunucularına gönderir.
|
||||
3. Tamamlanan tanılama yanıtını hata raporuna veya destek iş parçacığına
|
||||
kopyalayın. Yerel paket yolunu, gizlilik özetini, OpenClaw oturum
|
||||
kimliklerini, Codex iş parçacığı kimliklerini ve her Codex iş parçacığı için
|
||||
bir `Inspect locally` satırını içerir.
|
||||
4. Çalıştırmayı kendiniz hata ayıklamak istiyorsanız, yazdırılan
|
||||
`Inspect locally` komutunu bir terminalde çalıştırın. `codex resume <thread-id>`
|
||||
gibi görünür ve konuşmayı inceleyebilmeniz, yerel olarak sürdürebilmeniz veya
|
||||
Codex'e belirli bir aracı ya da planı neden seçtiğini sorabilmeniz için yerel
|
||||
Codex iş parçacığını açar.
|
||||
|
||||
`/codex diagnostics [note]` komutunu yalnızca tam OpenClaw Gateway tanılama
|
||||
paketi olmadan, geçerli olarak bağlı iş parçacığı için özellikle Codex geri
|
||||
bildirim yüklemesini istediğinizde kullanın. Çoğu destek raporu için
|
||||
`/diagnostics [note]` daha iyi bir başlangıç noktasıdır; çünkü yerel Gateway
|
||||
durumunu ve Codex iş parçacığı kimliklerini tek bir yanıtta bir araya getirir.
|
||||
Tam gizlilik modeli ve grup sohbeti davranışı için
|
||||
[Tanılama dışa aktarma](/tr/gateway/diagnostics) sayfasına bakın.
|
||||
`/codex diagnostics [note]` komutunu yalnızca tam OpenClaw Gateway tanılama paketi olmadan, o anda bağlı iş parçacığı için özel olarak Codex geri bildirim yüklemesini istediğinizde kullanın. Çoğu destek raporu için `/diagnostics [note]` daha iyi bir başlangıç noktasıdır çünkü yerel Gateway durumunu ve Codex iş parçacığı kimliklerini tek yanıtta bir araya getirir. Tam gizlilik modeli ve grup sohbeti davranışı için [Tanılama dışa aktarımı](/tr/gateway/diagnostics) bölümüne bakın.
|
||||
|
||||
Çekirdek OpenClaw ayrıca genel Gateway tanılama komutu olarak yalnızca sahibin
|
||||
kullanabildiği `/diagnostics [note]` komutunu sunar. Onay istemi hassas veri
|
||||
önsözünü gösterir, [Tanılama Dışa Aktarma](/tr/gateway/diagnostics) sayfasına
|
||||
bağlantı verir ve her seferinde açık exec onayıyla
|
||||
`openclaw gateway diagnostics export --json` ister. Tanılamaları tümüne izin
|
||||
veren bir kuralla onaylamayın. Onaydan sonra OpenClaw, yerel paket yolu ve
|
||||
manifest özetiyle yapıştırılabilir bir rapor gönderir. Etkin OpenClaw oturumu
|
||||
Codex harness kullanıyorsa, aynı onay ilgili Codex geri bildirim paketlerinin
|
||||
OpenAI sunucularına gönderilmesini de yetkilendirir. Onay istemi Codex geri
|
||||
bildiriminin gönderileceğini söyler, ancak onaydan önce Codex oturum veya iş
|
||||
parçacığı kimliklerini listelemez.
|
||||
Çekirdek OpenClaw ayrıca genel Gateway tanılama komutu olarak yalnızca sahiplerin kullanabildiği `/diagnostics [note]` komutunu sunar. Onay istemi hassas veri önsözünü gösterir, [Tanılama Dışa Aktarımı](/tr/gateway/diagnostics) bağlantısını verir ve her seferinde açık exec onayı yoluyla `openclaw gateway diagnostics export --json` ister. Tanılamaları tümüne izin veren bir kuralla onaylamayın. Onaydan sonra OpenClaw, yerel paket yolu ve manifest özetiyle birlikte yapıştırılabilir bir rapor gönderir. Etkin OpenClaw oturumu Codex harness'ını kullanıyorsa, aynı onay ilgili Codex geri bildirim paketlerinin OpenAI sunucularına gönderilmesine de izin verir. Onay istemi Codex geri bildiriminin gönderileceğini söyler, ancak onaydan önce Codex oturumu veya iş parçacığı kimliklerini listelemez.
|
||||
|
||||
`/diagnostics` bir grup sohbetinde bir sahip tarafından çağrılırsa, OpenClaw
|
||||
paylaşılan kanalı temiz tutar: grup yalnızca kısa bir bildirim alırken,
|
||||
tanılama önsözü, onay istemleri ve Codex oturum/iş parçacığı kimlikleri özel
|
||||
onay yolu üzerinden sahibe gönderilir. Özel sahip yolu yoksa OpenClaw grup
|
||||
isteğini reddeder ve sahibinden bunu bir DM üzerinden çalıştırmasını ister.
|
||||
`/diagnostics` bir grup sohbetinde bir sahip tarafından çağrılırsa, OpenClaw paylaşılan kanalı temiz tutar: grup yalnızca kısa bir bildirim alırken tanılama önsözü, onay istemleri ve Codex oturum/iş parçacığı kimlikleri özel onay rotası üzerinden sahibe gönderilir. Özel sahip rotası yoksa OpenClaw grup isteğini reddeder ve sahibin bunu bir DM'den çalıştırmasını ister.
|
||||
|
||||
Onaylanmış Codex yüklemesi Codex uygulama sunucusundaki `feedback/upload` çağrısını yapar ve
|
||||
uygulama sunucusundan, mevcut olduğunda listelenen her iş parçacığı ve oluşturulmuş Codex alt iş parçacıkları için günlükleri dahil etmesini ister. Yükleme, Codex'in normal geri bildirim yolu üzerinden OpenAI
|
||||
sunucularına gider; Codex geri bildirimi o uygulama sunucusunda devre dışıysa komut
|
||||
uygulama sunucusu hatasını döndürür. Tamamlanan tanılama yanıtı, gönderilen iş parçacıkları için kanalları,
|
||||
OpenClaw oturum kimliklerini, Codex iş parçacığı kimliklerini ve yerel `codex resume <thread-id>`
|
||||
komutlarını listeler. Onayı reddeder veya yok sayarsanız,
|
||||
OpenClaw bu Codex kimliklerini yazdırmaz. Bu yükleme yerel
|
||||
Gateway tanılama dışa aktarımının yerine geçmez.
|
||||
Onaylanan Codex yüklemesi Codex app-server `feedback/upload` çağrısı yapar ve app-server'dan, mümkün olduğunda listelenen her iş parçacığı ve oluşturulmuş Codex alt iş parçacıkları için günlükleri dahil etmesini ister. Yükleme, Codex'in normal geri bildirim yolu üzerinden OpenAI sunucularına gider; bu app-server'da Codex geri bildirimi devre dışıysa komut app-server hatasını döndürür. Tamamlanan tanılama yanıtı, gönderilen iş parçacıkları için kanalları, OpenClaw oturum kimliklerini, Codex iş parçacığı kimliklerini ve yerel `codex resume <thread-id>` komutlarını listeler. Onayı reddeder veya yok sayarsanız OpenClaw bu Codex kimliklerini yazdırmaz. Bu yükleme yerel Gateway tanılama dışa aktarımının yerini almaz.
|
||||
|
||||
`/codex resume`, harness'ın normal dönüşler için kullandığı aynı yan bağlama dosyasını yazar.
|
||||
Sonraki iletide OpenClaw bu Codex iş parçacığını sürdürür, o anda seçili
|
||||
OpenClaw modelini uygulama sunucusuna geçirir ve genişletilmiş geçmişi
|
||||
etkin tutar.
|
||||
`/codex resume`, harness'ın normal turlarda kullandığı aynı yan dosya bağlama dosyasını yazar. Bir sonraki mesajda OpenClaw bu Codex iş parçacığını sürdürür, o anda seçili OpenClaw modelini app-server'a geçirir ve genişletilmiş geçmişi etkin tutar.
|
||||
|
||||
### CLI'dan bir Codex iş parçacığını inceleme
|
||||
|
||||
Kötü bir Codex çalıştırmasını anlamanın en hızlı yolu çoğu zaman yerel Codex
|
||||
iş parçacığını doğrudan açmaktır:
|
||||
Kötü bir Codex çalıştırmasını anlamanın en hızlı yolu çoğu zaman yerel Codex iş parçacığını doğrudan açmaktır:
|
||||
|
||||
```sh
|
||||
codex resume <thread-id>
|
||||
```
|
||||
|
||||
Bunu bir kanal konuşmasında hata fark ettiğinizde ve sorunlu
|
||||
Codex oturumunu incelemek, yerelde sürdürmek ya da Codex'e neden belirli bir
|
||||
araç veya muhakeme seçimi yaptığını sormak istediğinizde kullanın. En kolay yol genellikle önce
|
||||
`/diagnostics [note]` çalıştırmaktır: onay verdikten sonra tamamlanan rapor
|
||||
her Codex iş parçacığını listeler ve örneğin
|
||||
`codex resume <thread-id>` gibi bir `Inspect locally` komutu yazdırır. Bu komutu doğrudan terminale kopyalayabilirsiniz.
|
||||
Bunu bir kanal konuşmasında hata fark ettiğinizde ve sorunlu Codex oturumunu incelemek, yerelde devam ettirmek veya Codex'e neden belirli bir araç ya da akıl yürütme seçimi yaptığını sormak istediğinizde kullanın. En kolay yol genellikle önce `/diagnostics [note]` çalıştırmaktır: onayladıktan sonra tamamlanan rapor her Codex iş parçacığını listeler ve örneğin `codex resume <thread-id>` gibi bir `Yerelde incele` komutu yazdırır. Bu komutu doğrudan bir terminale kopyalayabilirsiniz.
|
||||
|
||||
Geçerli sohbet için `/codex binding` komutundan veya son Codex uygulama sunucusu iş parçacıkları için
|
||||
`/codex threads [filter]` komutundan da bir iş parçacığı kimliği alabilir, ardından kabuğunuzda aynı
|
||||
`codex resume` komutunu çalıştırabilirsiniz.
|
||||
Geçerli sohbet için `/codex binding` komutundan veya son Codex app-server iş parçacıkları için `/codex threads [filter]` komutundan da bir iş parçacığı kimliği alabilir, ardından kabuğunuzda aynı `codex resume` komutunu çalıştırabilirsiniz.
|
||||
|
||||
Komut yüzeyi Codex uygulama sunucusu `0.125.0` veya daha yeni bir sürüm gerektirir. Gelecekteki veya özel bir uygulama sunucusu ilgili JSON-RPC yöntemini sunmuyorsa, tekil
|
||||
denetim yöntemleri `unsupported by this Codex app-server` olarak bildirilir.
|
||||
Komut yüzeyi Codex app-server `0.125.0` veya daha yenisini gerektirir. Gelecekteki ya da özel bir app-server ilgili JSON-RPC yöntemini sunmuyorsa, tekil kontrol yöntemleri `unsupported by this Codex app-server` olarak bildirilir.
|
||||
|
||||
## Hook sınırları
|
||||
|
||||
@ -775,101 +794,135 @@ Codex harness'ında üç hook katmanı vardır:
|
||||
| Katman | Sahip | Amaç |
|
||||
| ------------------------------------- | ------------------------ | ------------------------------------------------------------------- |
|
||||
| OpenClaw Plugin hook'ları | OpenClaw | PI ve Codex harness'ları genelinde ürün/Plugin uyumluluğu. |
|
||||
| Codex uygulama sunucusu uzantı ara katmanı | OpenClaw paketli Plugin'leri | OpenClaw dinamik araçları çevresinde dönüş başına bağdaştırıcı davranışı. |
|
||||
| Codex app-server uzantı middleware'i | OpenClaw paketli Plugin'ler | OpenClaw dinamik araçları çevresinde tur başına adaptör davranışı. |
|
||||
| Codex yerel hook'ları | Codex | Codex yapılandırmasından düşük seviyeli Codex yaşam döngüsü ve yerel araç ilkesi. |
|
||||
|
||||
OpenClaw, OpenClaw Plugin davranışını yönlendirmek için proje veya genel Codex `hooks.json` dosyalarını kullanmaz. Desteklenen yerel araç ve izin köprüsü için
|
||||
OpenClaw, `PreToolUse`, `PostToolUse`,
|
||||
`PermissionRequest` ve `Stop` için iş parçacığı başına Codex yapılandırması enjekte eder. `SessionStart` ve
|
||||
`UserPromptSubmit` gibi diğer Codex hook'ları Codex düzeyi denetimler olarak kalır; v1 sözleşmesinde
|
||||
OpenClaw Plugin hook'ları olarak sunulmazlar.
|
||||
OpenClaw, OpenClaw Plugin davranışını yönlendirmek için proje veya global Codex `hooks.json` dosyalarını kullanmaz. Desteklenen yerel araç ve izin köprüsü için OpenClaw, `PreToolUse`, `PostToolUse`, `PermissionRequest` ve `Stop` için iş parçacığı başına Codex yapılandırması enjekte eder. `SessionStart` ve `UserPromptSubmit` gibi diğer Codex hook'ları Codex düzeyi kontroller olarak kalır; v1 sözleşmesinde OpenClaw Plugin hook'ları olarak sunulmazlar.
|
||||
|
||||
OpenClaw dinamik araçları için OpenClaw, Codex çağrı istediğinde aracı yürütür; bu nedenle OpenClaw, harness bağdaştırıcısında sahip olduğu Plugin ve ara katman davranışını tetikler. Codex-yerel araçlar için kanonik araç kaydının sahibi Codex'tir.
|
||||
OpenClaw seçili olayları yansıtabilir, ancak Codex bu işlemi uygulama sunucusu veya yerel hook
|
||||
geri çağrıları üzerinden sunmadığı sürece yerel Codex iş parçacığını yeniden yazamaz.
|
||||
OpenClaw dinamik araçları için OpenClaw, Codex çağrıyı istedikten sonra aracı çalıştırır; bu nedenle OpenClaw, harness adaptöründe kendisine ait Plugin ve middleware davranışını tetikler. Codex'e yerel araçlar için kanonik araç kaydının sahibi Codex'tir. OpenClaw seçili olayları yansıtabilir, ancak Codex bu işlemi app-server veya yerel hook geri çağrıları üzerinden sunmadıkça yerel Codex iş parçacığını yeniden yazamaz.
|
||||
|
||||
Compaction ve LLM yaşam döngüsü projeksiyonları yerel Codex hook komutlarından değil, Codex uygulama sunucusu
|
||||
bildirimlerinden ve OpenClaw bağdaştırıcı durumundan gelir.
|
||||
OpenClaw'ın `before_compaction`, `after_compaction`, `llm_input` ve
|
||||
`llm_output` olayları, Codex'in dahili isteğinin veya Compaction yüklerinin bayt bayt yakalamaları değil, bağdaştırıcı düzeyinde gözlemlerdir.
|
||||
Compaction ve LLM yaşam döngüsü projeksiyonları yerel Codex hook komutlarından değil, Codex app-server bildirimlerinden ve OpenClaw adaptör durumundan gelir. OpenClaw'ın `before_compaction`, `after_compaction`, `llm_input` ve `llm_output` olayları adaptör düzeyi gözlemlerdir; Codex'in dahili istek veya compaction yüklerinin bayt bayt yakalanmış halleri değildir.
|
||||
|
||||
Codex yerel `hook/started` ve `hook/completed` uygulama sunucusu bildirimleri,
|
||||
yörünge ve hata ayıklama için `codex_app_server.hook` aracı olayları olarak yansıtılır.
|
||||
Bunlar OpenClaw Plugin hook'larını çağırmaz.
|
||||
Codex yerel `hook/started` ve `hook/completed` app-server bildirimleri, izlek ve hata ayıklama için `codex_app_server.hook` ajan olayları olarak projekte edilir. Bunlar OpenClaw Plugin hook'larını çağırmaz.
|
||||
|
||||
## V1 destek sözleşmesi
|
||||
|
||||
Codex modu, altında farklı bir model çağrısı bulunan PI değildir. Codex, yerel model döngüsünün daha fazlasına sahiptir ve OpenClaw, Plugin ve oturum yüzeylerini
|
||||
bu sınırın çevresinde uyarlar.
|
||||
Codex modu, altında farklı bir model çağrısı olan PI değildir. Codex yerel model döngüsünün daha büyük kısmına sahiptir ve OpenClaw Plugin ile oturum yüzeylerini bu sınır çevresinde uyarlar.
|
||||
|
||||
Codex çalışma zamanı v1'de desteklenenler:
|
||||
Codex runtime v1'de desteklenenler:
|
||||
|
||||
| Yüzey | Destek | Neden |
|
||||
| -------------------------------------------- | --------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| Codex üzerinden OpenAI model döngüsü | Desteklenir | Codex uygulama sunucusu OpenAI dönüşünün, yerel iş parçacığı sürdürmenin ve yerel araç devamının sahibidir. |
|
||||
| OpenClaw kanal yönlendirme ve teslimi | Desteklenir | Telegram, Discord, Slack, WhatsApp, iMessage ve diğer kanallar model çalışma zamanının dışında kalır. |
|
||||
| OpenClaw dinamik araçları | Desteklenir | Codex, OpenClaw'dan bu araçları yürütmesini ister; bu nedenle OpenClaw yürütme yolunda kalır. |
|
||||
| İstem ve bağlam Plugin'leri | Desteklenir | OpenClaw istem katmanlarını oluşturur ve iş parçacığını başlatmadan veya sürdürmeden önce bağlamı Codex dönüşüne yansıtır. |
|
||||
| Bağlam motoru yaşam döngüsü | Desteklenir | Birleştirme, alım veya dönüş sonrası bakım ve bağlam motoru Compaction koordinasyonu Codex dönüşleri için çalışır. |
|
||||
| Dinamik araç hook'ları | Desteklenir | `before_tool_call`, `after_tool_call` ve araç sonucu ara katmanı OpenClaw'a ait dinamik araçların çevresinde çalışır. |
|
||||
| Yaşam döngüsü hook'ları | Bağdaştırıcı gözlemleri olarak desteklenir | `llm_input`, `llm_output`, `agent_end`, `before_compaction` ve `after_compaction` gerçekçi Codex modu yükleriyle tetiklenir. |
|
||||
| Son yanıt düzeltme kapısı | Yerel hook rölesi üzerinden desteklenir | Codex `Stop`, `before_agent_finalize` öğesine iletilir; `revise`, sonlandırmadan önce Codex'ten bir model geçişi daha ister. |
|
||||
| Yerel kabuk, patch ve MCP engelleme veya gözlemleme | Yerel hook rölesi üzerinden desteklenir | Codex `PreToolUse` ve `PostToolUse`, Codex uygulama sunucusu `0.125.0` veya daha yenisindeki MCP yükleri dahil olmak üzere kabul edilmiş yerel araç yüzeyleri için iletilir. Engelleme desteklenir; argüman yeniden yazma desteklenmez. |
|
||||
| Yerel izin ilkesi | Yerel hook rölesi üzerinden desteklenir | Codex `PermissionRequest`, çalışma zamanı sunduğu yerde OpenClaw ilkesinden geçirilebilir. OpenClaw karar döndürmezse Codex normal koruyucu veya kullanıcı onayı yolundan devam eder. |
|
||||
| Uygulama sunucusu yörünge yakalama | Desteklenir | OpenClaw, uygulama sunucusuna gönderdiği isteği ve aldığı uygulama sunucusu bildirimlerini kaydeder. |
|
||||
| Codex üzerinden OpenAI model döngüsü | Desteklenir | Codex app-server OpenAI turuna, yerel iş parçacığı sürdürmeye ve yerel araç devamına sahiptir. |
|
||||
| OpenClaw kanal yönlendirme ve teslim | Desteklenir | Telegram, Discord, Slack, WhatsApp, iMessage ve diğer kanallar model runtime'ının dışında kalır. |
|
||||
| OpenClaw dinamik araçları | Desteklenir | Codex, OpenClaw'dan bu araçları çalıştırmasını ister; bu nedenle OpenClaw yürütme yolunda kalır. |
|
||||
| İstem ve bağlam Plugin'leri | Desteklenir | OpenClaw, iş parçacığını başlatmadan veya sürdürmeden önce istem katmanları oluşturur ve bağlamı Codex turuna projekte eder. |
|
||||
| Bağlam motoru yaşam döngüsü | Desteklenir | Derleme, alma veya tur sonrası bakım ve bağlam motoru compaction koordinasyonu Codex turları için çalışır. |
|
||||
| Dinamik araç hook'ları | Desteklenir | `before_tool_call`, `after_tool_call` ve araç sonucu middleware'i OpenClaw'a ait dinamik araçların çevresinde çalışır. |
|
||||
| Yaşam döngüsü hook'ları | Adaptör gözlemleri olarak desteklenir | `llm_input`, `llm_output`, `agent_end`, `before_compaction` ve `after_compaction` dürüst Codex modu yükleriyle tetiklenir. |
|
||||
| Nihai yanıt revizyon kapısı | Yerel hook aktarımı üzerinden desteklenir | Codex `Stop`, `before_agent_finalize` olayına aktarılır; `revise`, sonlandırmadan önce Codex'ten bir model geçişi daha ister. |
|
||||
| Yerel shell, patch ve MCP engelleme veya gözlem | Yerel hook aktarımı üzerinden desteklenir | Codex `PreToolUse` ve `PostToolUse`, Codex app-server `0.125.0` veya daha yenisindeki MCP yükleri dahil olmak üzere taahhüt edilmiş yerel araç yüzeyleri için aktarılır. Engelleme desteklenir; argüman yeniden yazma desteklenmez. |
|
||||
| Yerel izin ilkesi | Yerel hook aktarımı üzerinden desteklenir | Codex `PermissionRequest`, runtime'ın sunduğu yerlerde OpenClaw ilkesi üzerinden yönlendirilebilir. OpenClaw karar döndürmezse Codex normal guardian veya kullanıcı onayı yolundan devam eder. |
|
||||
| App-server izlek yakalama | Desteklenir | OpenClaw, app-server'a gönderdiği isteği ve aldığı app-server bildirimlerini kaydeder. |
|
||||
|
||||
Codex çalışma zamanı v1'de desteklenmeyenler:
|
||||
Codex runtime v1'de desteklenmeyenler:
|
||||
|
||||
| Yüzey | V1 sınırı | Gelecek yol |
|
||||
| -------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------- |
|
||||
| Yerel araç argümanı mutasyonu | Codex yerel araç öncesi hook'ları engelleyebilir, ancak OpenClaw Codex-yerel araç argümanlarını yeniden yazmaz. | Yerine geçen araç girdisi için Codex hook/şema desteği gerektirir. |
|
||||
| Düzenlenebilir Codex-yerel transkript geçmişi | Kanonik yerel iş parçacığı geçmişinin sahibi Codex'tir. OpenClaw bir yansıtmanın sahibidir ve gelecek bağlamı yansıtabilir, ancak desteklenmeyen dahili öğeleri değiştirmemelidir. | Yerel iş parçacığı cerrahisi gerekiyorsa açık Codex uygulama sunucusu API'leri ekleyin. |
|
||||
| Codex-yerel araç kayıtları için `tool_result_persist` | Bu hook, Codex-yerel araç kayıtlarını değil, OpenClaw'a ait transkript yazımlarını dönüştürür. | Dönüştürülmüş kayıtları yansıtabilir, ancak kanonik yeniden yazma Codex desteği gerektirir. |
|
||||
| Zengin yerel Compaction meta verisi | OpenClaw Compaction başlangıcını ve tamamlanmasını gözlemler, ancak kararlı bir tutulan/atılan listesi, token deltası veya özet yükü almaz. | Daha zengin Codex Compaction olayları gerekir. |
|
||||
| Compaction müdahalesi | Geçerli OpenClaw Compaction hook'ları Codex modunda bildirim düzeyindedir. | Plugin'lerin yerel Compaction'ı veto etmesi veya yeniden yazması gerekiyorsa Codex ön/son Compaction hook'ları ekleyin. |
|
||||
| Bayt bayt model API isteği yakalama | OpenClaw uygulama sunucusu isteklerini ve bildirimlerini yakalayabilir, ancak Codex çekirdeği son OpenAI API isteğini dahili olarak oluşturur. | Codex model isteği izleme olayı veya hata ayıklama API'si gerekir. |
|
||||
| Yüzey | V1 sınırı | Gelecek yol |
|
||||
| --------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------------------------------- |
|
||||
| Yerel araç bağımsız değişken mutasyonu | Codex yerel araç öncesi kancaları engelleyebilir, ancak OpenClaw Codex'e özgü yerel araç bağımsız değişkenlerini yeniden yazmaz. | Değiştirilecek araç girdisi için Codex kanca/şema desteği gerektirir. |
|
||||
| Düzenlenebilir Codex'e özgü yerel transkript geçmişi | Kanonik yerel iş parçacığı geçmişinin sahibi Codex'tir. OpenClaw bir aynaya sahiptir ve gelecekteki bağlamı yansıtabilir, ancak desteklenmeyen iç yapıları değiştirmemelidir. | Yerel iş parçacığı cerrahisi gerekiyorsa açık Codex app-server API'leri ekleyin. |
|
||||
| Codex'e özgü yerel araç kayıtları için `tool_result_persist` | Bu kanca, Codex'e özgü yerel araç kayıtlarını değil, OpenClaw'ın sahip olduğu transkript yazmalarını dönüştürür. | Dönüştürülmüş kayıtları aynalayabilir, ancak kanonik yeniden yazma Codex desteği gerektirir. |
|
||||
| Zengin yerel compaction meta verisi | OpenClaw compaction başlangıcını ve tamamlanmasını gözlemler, ancak kararlı bir tutuldu/çıkarıldı listesi, token farkı veya özet yükü almaz. | Daha zengin Codex compaction olayları gerekir. |
|
||||
| Compaction müdahalesi | Geçerli OpenClaw compaction kancaları Codex modunda bildirim düzeyindedir. | Plugin'lerin yerel compaction'ı veto etmesi veya yeniden yazması gerekiyorsa Codex compaction öncesi/sonrası kancaları ekleyin. |
|
||||
| Model API isteğinin bayt bayt yakalanması | OpenClaw app-server isteklerini ve bildirimlerini yakalayabilir, ancak Codex çekirdeği nihai OpenAI API isteğini dahili olarak oluşturur. | Bir Codex model isteği izleme olayı veya hata ayıklama API'si gerekir. |
|
||||
|
||||
## Araçlar, medya ve Compaction
|
||||
## Araçlar, medya ve compaction
|
||||
|
||||
Codex harness'ı yalnızca düşük seviyeli gömülü aracı yürütücüsünü değiştirir.
|
||||
Codex harness yalnızca düşük düzeyli gömülü ajan yürütücüsünü değiştirir.
|
||||
|
||||
OpenClaw yine de araç listesini oluşturur ve harness'tan dinamik araç sonuçlarını alır. Metin, görseller, video, müzik, TTS, onaylar ve mesajlaşma aracı çıktısı
|
||||
normal OpenClaw teslim yolundan devam eder.
|
||||
OpenClaw araç listesini oluşturmaya ve harness'tan dinamik araç sonuçları almaya
|
||||
devam eder. Metin, görseller, video, müzik, TTS, onaylar ve mesajlaşma aracı çıktısı
|
||||
normal OpenClaw teslimat yolu üzerinden devam eder.
|
||||
|
||||
Yerel hook rölesi bilerek geneldir, ancak v1 destek sözleşmesi
|
||||
OpenClaw'ın test ettiği Codex-yerel araç ve izin yollarıyla sınırlıdır. Codex çalışma zamanında bu, kabuk, patch ve MCP `PreToolUse`,
|
||||
`PostToolUse` ve `PermissionRequest` yüklerini içerir. Çalışma zamanı sözleşmesi adını koyana kadar gelecekteki her Codex hook olayının bir OpenClaw Plugin yüzeyi olduğunu varsaymayın.
|
||||
Yerel kanca aktarıcısı kasıtlı olarak geneldir, ancak v1 destek sözleşmesi
|
||||
OpenClaw'ın test ettiği Codex'e özgü yerel araç ve izin yollarıyla sınırlıdır. Codex
|
||||
runtime'ında buna shell, patch ve MCP `PreToolUse`,
|
||||
`PostToolUse` ve `PermissionRequest` yükleri dahildir. Runtime sözleşmesi adını
|
||||
verene kadar gelecekteki her Codex kanca olayının bir OpenClaw Plugin yüzeyi
|
||||
olduğunu varsaymayın.
|
||||
|
||||
`PermissionRequest` için OpenClaw yalnızca ilke karar verdiğinde açık izin veya ret kararları döndürür. Kararsız sonuç izin değildir. Codex bunu hook kararı yok olarak ele alır ve kendi koruyucu veya kullanıcı onayı yoluna düşürür.
|
||||
`PermissionRequest` için OpenClaw yalnızca ilke karar verdiğinde açık izin verme
|
||||
veya reddetme kararları döndürür. Kararsız sonuç izin verme değildir. Codex bunu
|
||||
kanca kararı yok olarak ele alır ve kendi guardian veya kullanıcı onayı yoluna düşer.
|
||||
|
||||
Codex MCP araç onayı elicitation'ları, Codex `_meta.codex_approval_kind` değerini
|
||||
`"mcp_tool_call"` olarak işaretlediğinde OpenClaw'ın Plugin onay akışı üzerinden yönlendirilir. Codex `request_user_input` istemleri
|
||||
kaynak sohbete geri gönderilir ve sıradaki bir sonraki takip iletisi, ek bağlam olarak yönlendirilmek yerine bu yerel
|
||||
sunucu isteğini yanıtlar. Diğer MCP elicitation istekleri yine kapalı başarısız olur.
|
||||
Codex MCP araç onayı istemleri, Codex `_meta.codex_approval_kind` değerini
|
||||
`"mcp_tool_call"` olarak işaretlediğinde OpenClaw'ın Plugin onay akışı üzerinden
|
||||
yönlendirilir. Codex `request_user_input` istemleri kaynak sohbete geri gönderilir
|
||||
ve sıradaki bir sonraki takip mesajı, ek bağlam olarak yönlendirilmek yerine bu
|
||||
yerel sunucu isteğini yanıtlar. Diğer MCP istem istekleri yine kapalı başarısız olur.
|
||||
|
||||
Etkin çalıştırma kuyruğu yönlendirmesi, Codex app-server `turn/steer` ile eşleşir. Varsayılan `messages.queue.mode: "steer"` ile OpenClaw, kuyruğa alınan sohbet mesajlarını yapılandırılmış sessizlik penceresi boyunca toplu hale getirir ve bunları varış sırasına göre tek bir `turn/steer` isteği olarak gönderir. Eski `queue` modu ayrı `turn/steer` istekleri gönderir. Codex inceleme ve manuel compaction turn'leri aynı turn yönlendirmesini reddedebilir; bu durumda OpenClaw, seçilen mod geri dönüşe izin verdiğinde takip kuyruğunu kullanır. Bkz. [Yönlendirme kuyruğu](/tr/concepts/queue-steering).
|
||||
Etkin çalışma kuyruğu yönlendirmesi Codex app-server `turn/steer` üzerine eşlenir.
|
||||
Varsayılan `messages.queue.mode: "steer"` ile OpenClaw sıraya alınmış sohbet mesajlarını
|
||||
yapılandırılmış sessizlik penceresi boyunca toplar ve bunları varış sırasıyla tek bir
|
||||
`turn/steer` isteği olarak gönderir. Eski `queue` modu ayrı `turn/steer` istekleri
|
||||
gönderir. Codex inceleme ve manuel compaction turları aynı tur yönlendirmesini reddedebilir;
|
||||
bu durumda OpenClaw, seçili mod geri dönüşe izin verdiğinde takip kuyruğunu kullanır. Bkz.
|
||||
[Yönlendirme kuyruğu](/tr/concepts/queue-steering).
|
||||
|
||||
Seçilen model Codex harness kullandığında, yerel thread compaction Codex app-server'a devredilir. OpenClaw kanal geçmişi, arama, `/new`, `/reset` ve gelecekteki model veya harness geçişleri için bir transcript aynası tutar. Ayna; kullanıcı istemini, son asistan metnini ve app-server bunları yaydığında hafif Codex akıl yürütme veya plan kayıtlarını içerir. Bugün OpenClaw yalnızca yerel compaction başlangıç ve tamamlanma sinyallerini kaydeder. Henüz insan tarafından okunabilir bir compaction özeti veya Codex'in compaction sonrasında hangi girdileri tuttuğuna dair denetlenebilir bir liste sunmaz.
|
||||
Seçili model Codex harness kullandığında, yerel iş parçacığı compaction'ı
|
||||
Codex app-server'a devredilir. OpenClaw kanal geçmişi, arama, `/new`, `/reset` ve
|
||||
gelecekteki model veya harness değişimleri için bir transkript aynası tutar. Ayna,
|
||||
app-server bunları yaydığında kullanıcı istemini, son asistan metnini ve hafif
|
||||
Codex akıl yürütme veya plan kayıtlarını içerir. Bugün OpenClaw yalnızca yerel
|
||||
compaction başlangıç ve tamamlanma sinyallerini kaydeder. Henüz insan tarafından
|
||||
okunabilir bir compaction özeti veya Codex'in compaction sonrasında hangi girdileri
|
||||
tuttuğuna dair denetlenebilir bir liste sunmaz.
|
||||
|
||||
Kanonik yerel thread'in sahibi Codex olduğundan, `tool_result_persist` şu anda Codex-yerel araç sonucu kayıtlarını yeniden yazmaz. Yalnızca OpenClaw, OpenClaw'a ait bir oturum transcript araç sonucu yazarken uygulanır.
|
||||
Kanonik yerel iş parçacığının sahibi Codex olduğundan, `tool_result_persist` şu anda
|
||||
Codex'e özgü yerel araç sonucu kayıtlarını yeniden yazmaz. Yalnızca OpenClaw,
|
||||
OpenClaw'a ait bir oturum transkripti araç sonucu yazarken uygulanır.
|
||||
|
||||
Medya oluşturma PI gerektirmez. Görsel, video, müzik, PDF, TTS ve medya anlama; `agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` ve `messages.tts` gibi eşleşen sağlayıcı/model ayarlarını kullanmaya devam eder.
|
||||
Medya üretimi PI gerektirmez. Görsel, video, müzik, PDF, TTS ve medya anlama
|
||||
`agents.defaults.imageGenerationModel`, `videoGenerationModel`, `pdfModel` ve
|
||||
`messages.tts` gibi eşleşen sağlayıcı/model ayarlarını kullanmaya devam eder.
|
||||
|
||||
## Sorun giderme
|
||||
|
||||
**Codex normal bir `/model` sağlayıcısı olarak görünmüyor:** yeni yapılandırmalar için bu beklenen bir durumdur. `agentRuntime.id: "codex"` ile bir `openai/gpt-*` modeli (veya eski bir `codex/*` ref'i) seçin, `plugins.entries.codex.enabled` etkinleştirin ve `plugins.allow` değerinin `codex` öğesini hariç tutup tutmadığını kontrol edin.
|
||||
**Codex normal bir `/model` sağlayıcısı olarak görünmüyor:** bu, yeni
|
||||
yapılandırmalar için beklenen durumdur. `agentRuntime.id: "codex"` ile bir
|
||||
`openai/gpt-*` modeli (veya eski bir `codex/*` başvurusu) seçin,
|
||||
`plugins.entries.codex.enabled` değerini etkinleştirin ve `plugins.allow` değerinin
|
||||
`codex` öğesini hariç tutup tutmadığını kontrol edin.
|
||||
|
||||
**OpenClaw Codex yerine PI kullanıyor:** `agentRuntime.id: "auto"`, hiçbir Codex harness çalıştırmayı sahiplenmediğinde uyumluluk arka ucu olarak hâlâ PI kullanabilir. Test ederken Codex seçimini zorlamak için `agentRuntime.id: "codex"` ayarlayın. Zorlanmış Codex runtime, siz açıkça `agentRuntime.fallback: "pi"` ayarlamadıkça artık PI'ye geri dönmek yerine başarısız olur. Codex app-server seçildikten sonra, hataları ek geri dönüş yapılandırması olmadan doğrudan görünür.
|
||||
**OpenClaw Codex yerine PI kullanıyor:** `agentRuntime.id: "auto"`, çalışmayı hiçbir
|
||||
Codex harness sahiplenmediğinde uyumluluk arka ucu olarak PI kullanmaya devam edebilir.
|
||||
Test sırasında Codex seçimini zorlamak için `agentRuntime.id: "codex"` olarak ayarlayın.
|
||||
Zorlanmış Codex runtime artık PI'ya geri dönmek yerine başarısız olur; bunu yalnızca
|
||||
açıkça `agentRuntime.fallback: "pi"` ayarlarsanız yapar. Codex app-server seçildikten
|
||||
sonra, hataları ek geri dönüş yapılandırması olmadan doğrudan yüzeye çıkar.
|
||||
|
||||
**app-server reddediliyor:** Codex'i yükselterek app-server el sıkışmasının `0.125.0` veya daha yeni sürümü bildirmesini sağlayın. Aynı sürüm ön sürümleri veya `0.125.0-alpha.2` ya da `0.125.0+custom` gibi derleme sonekli sürümler reddedilir, çünkü OpenClaw'ın test ettiği kararlı `0.125.0` protokol tabanıdır.
|
||||
**app-server reddediliyor:** Codex'i yükseltin; app-server el sıkışması
|
||||
`0.125.0` veya daha yeni sürümü bildirmelidir. Aynı sürümlü ön sürümler veya
|
||||
`0.125.0-alpha.2` ya da `0.125.0+custom` gibi derleme sonekli sürümler reddedilir,
|
||||
çünkü OpenClaw'ın test ettiği kararlı protokol tabanı `0.125.0` sürümüdür.
|
||||
|
||||
**Model keşfi yavaş:** `plugins.entries.codex.config.discovery.timeoutMs` değerini düşürün veya keşfi devre dışı bırakın.
|
||||
**Model keşfi yavaş:** `plugins.entries.codex.config.discovery.timeoutMs` değerini
|
||||
düşürün veya keşfi devre dışı bırakın.
|
||||
|
||||
**WebSocket taşıması hemen başarısız oluyor:** `appServer.url`, `authToken` ve uzak app-server'ın aynı Codex app-server protokol sürümünü konuştuğunu kontrol edin.
|
||||
**WebSocket aktarımı hemen başarısız oluyor:** `appServer.url`, `authToken` ve
|
||||
uzak app-server'ın aynı Codex app-server protokol sürümünü konuştuğunu kontrol edin.
|
||||
|
||||
**Codex olmayan bir model PI kullanıyor:** bu, o ajan için `agentRuntime.id: "codex"` zorlamadıysanız veya eski bir `codex/*` ref'i seçmediyseniz beklenen bir durumdur. Düz `openai/gpt-*` ve diğer sağlayıcı ref'leri `auto` modunda normal sağlayıcı yollarında kalır. `agentRuntime.id: "codex"` zorlarsanız, o ajan için her gömülü turn Codex destekli bir OpenAI modeli olmalıdır.
|
||||
**Codex olmayan bir model PI kullanıyor:** bu, o ajan için
|
||||
`agentRuntime.id: "codex"` değerini zorlamadıysanız veya eski bir `codex/*` başvurusu
|
||||
seçmediyseniz beklenen durumdur. Düz `openai/gpt-*` ve diğer sağlayıcı başvuruları
|
||||
`auto` modunda normal sağlayıcı yolunda kalır. `agentRuntime.id: "codex"` değerini
|
||||
zorlarsanız, o ajan için her gömülü turun Codex destekli bir OpenAI modeli olması gerekir.
|
||||
|
||||
**Computer Use kurulu ancak araçlar çalışmıyor:** yeni bir oturumdan `/codex computer-use status` kontrol edin. Bir araç `Native hook relay unavailable` bildirirse `/new` veya `/reset` kullanın; devam ederse, eski yerel hook kayıtlarını temizlemek için gateway'i yeniden başlatın. `computer-use.list_apps` zaman aşımına uğrarsa Codex Computer Use veya Codex Desktop'ı yeniden başlatıp yeniden deneyin.
|
||||
**Computer Use kurulu ancak araçlar çalışmıyor:** yeni bir oturumdan
|
||||
`/codex computer-use status` komutunu kontrol edin. Bir araç
|
||||
`Native hook relay unavailable` bildirirse `/new` veya `/reset` kullanın; devam ederse,
|
||||
eski yerel kanca kayıtlarını temizlemek için gateway'i yeniden başlatın. `computer-use.list_apps`
|
||||
zaman aşımına uğrarsa Codex Computer Use veya Codex Desktop'ı yeniden başlatıp tekrar deneyin.
|
||||
|
||||
## İlgili
|
||||
|
||||
@ -878,6 +931,6 @@ Medya oluşturma PI gerektirmez. Görsel, video, müzik, PDF, TTS ve medya anlam
|
||||
- [Model sağlayıcıları](/tr/concepts/model-providers)
|
||||
- [OpenAI sağlayıcısı](/tr/providers/openai)
|
||||
- [Durum](/tr/cli/status)
|
||||
- [Plugin hook'ları](/tr/plugins/hooks)
|
||||
- [Plugin kancaları](/tr/plugins/hooks)
|
||||
- [Yapılandırma başvurusu](/tr/gateway/configuration-reference)
|
||||
- [Test etme](/tr/help/testing-live#live-codex-app-server-harness-smoke)
|
||||
|
||||
@ -2,61 +2,71 @@
|
||||
read_when:
|
||||
- Skills ekleme veya değiştirme
|
||||
- Beceri geçitlemesini, izin listelerini veya yükleme kurallarını değiştirme
|
||||
- Beceri önceliğini ve anlık görüntü davranışını anlama
|
||||
- Skill önceliğini ve anlık görüntü davranışını anlama
|
||||
sidebarTitle: Skills
|
||||
summary: 'Skills: yönetilen ile çalışma alanı arasındaki farklar, geçitleme kuralları, ajan izin listeleri ve yapılandırma bağlantıları'
|
||||
summary: 'Skills: yönetilen ve çalışma alanı, geçit kuralları, ajan izin listeleri ve yapılandırma bağlantıları'
|
||||
title: Skills
|
||||
x-i18n:
|
||||
generated_at: "2026-04-30T09:50:48Z"
|
||||
generated_at: "2026-04-30T20:05:55Z"
|
||||
model: gpt-5.5
|
||||
provider: openai
|
||||
source_hash: d7dd17f52119bf0a0bb197025070abb68f7667a7d22c3d5fa6ef2f666110a45a
|
||||
source_hash: b58d690786756bd3539940aae9f2abcb8a497798ed7b6afeb5e6d6e255fcf257
|
||||
source_path: tools/skills.md
|
||||
workflow: 16
|
||||
---
|
||||
|
||||
OpenClaw, ajana araçları nasıl kullanacağını öğretmek için **[AgentSkills](https://agentskills.io) uyumlu** beceri
|
||||
OpenClaw, agente araçları nasıl kullanacağını öğretmek için **[AgentSkills](https://agentskills.io) uyumlu** beceri
|
||||
klasörleri kullanır. Her beceri, YAML frontmatter ve talimatlar içeren
|
||||
bir `SKILL.md` barındıran dizindir. OpenClaw, paketle gelen becerileri ve
|
||||
isteğe bağlı yerel geçersiz kılmaları yükler; bunları yükleme sırasında
|
||||
ortama, yapılandırmaya ve ikili dosya varlığına göre filtreler.
|
||||
bir `SKILL.md` dosyası barındıran bir dizindir. OpenClaw, paketle gelen
|
||||
becerileri ve isteğe bağlı yerel geçersiz kılmaları yükler; bunları yükleme
|
||||
zamanında ortama, yapılandırmaya ve ikili dosya varlığına göre filtreler.
|
||||
|
||||
## Konumlar ve öncelik
|
||||
|
||||
OpenClaw becerileri şu kaynaklardan yükler, **en yüksek öncelik önce**:
|
||||
OpenClaw becerileri şu kaynaklardan yükler, **en yüksek öncelik ilk sırada**:
|
||||
|
||||
| # | Kaynak | Yol |
|
||||
| --- | ---------------------- | -------------------------------- |
|
||||
| 1 | Çalışma alanı becerileri | `<workspace>/skills` |
|
||||
| 2 | Proje ajanı becerileri | `<workspace>/.agents/skills` |
|
||||
| 3 | Kişisel ajan becerileri | `~/.agents/skills` |
|
||||
| # | Kaynak | Yol |
|
||||
| --- | ------------------------- | -------------------------------- |
|
||||
| 1 | Çalışma alanı becerileri | `<workspace>/skills` |
|
||||
| 2 | Proje agent becerileri | `<workspace>/.agents/skills` |
|
||||
| 3 | Kişisel agent becerileri | `~/.agents/skills` |
|
||||
| 4 | Yönetilen/yerel beceriler | `~/.openclaw/skills` |
|
||||
| 5 | Paketle gelen beceriler | kurulumla birlikte gelir |
|
||||
| 6 | Ek beceri klasörleri | `skills.load.extraDirs` (config) |
|
||||
| 5 | Paketle gelen beceriler | kurulumla birlikte gelir |
|
||||
| 6 | Ek beceri klasörleri | `skills.load.extraDirs` (config) |
|
||||
|
||||
Bir beceri adı çakışırsa, en yüksek kaynak kazanır.
|
||||
|
||||
## Ajan bazında ve paylaşılan beceriler
|
||||
Codex CLI'nin yerel `$CODEX_HOME/skills` dizini bu OpenClaw beceri
|
||||
köklerinden biri değildir. Codex harness modunda, yerel app-server başlatmaları
|
||||
agent başına izole Codex home'ları kullanır; bu yüzden kişisel Codex CLI
|
||||
becerileri örtük olarak yüklenmez. Bunların envanterini çıkarmak için
|
||||
`openclaw migrate codex --dry-run` kullanın ve mevcut OpenClaw agent çalışma
|
||||
alanına kopyalamadan önce etkileşimli onay kutusu istemiyle beceri dizinlerini
|
||||
seçmek için `openclaw migrate codex` kullanın. Etkileşimsiz çalıştırmalar için,
|
||||
kopyalanacak tam beceriler adına `--skill <name>` seçeneğini tekrarlayın.
|
||||
|
||||
**Çok ajanlı** kurulumlarda her ajanın kendi çalışma alanı vardır:
|
||||
## Agent başına ve paylaşılan beceriler
|
||||
|
||||
| Kapsam | Yol | Şunlara görünür |
|
||||
| ---------------------- | ------------------------------------------- | --------------------------- |
|
||||
| Ajan bazında | `<workspace>/skills` | Yalnızca o ajan |
|
||||
| Proje ajanı | `<workspace>/.agents/skills` | Yalnızca o çalışma alanının ajanı |
|
||||
| Kişisel ajan | `~/.agents/skills` | O makinedeki tüm ajanlar |
|
||||
| Paylaşılan yönetilen/yerel | `~/.openclaw/skills` | O makinedeki tüm ajanlar |
|
||||
| Paylaşılan ek dizinler | `skills.load.extraDirs` (en düşük öncelik) | O makinedeki tüm ajanlar |
|
||||
**Çoklu agent** kurulumlarında her agent'in kendi çalışma alanı vardır:
|
||||
|
||||
Birden çok yerde aynı ad → en yüksek kaynak kazanır. Çalışma alanı,
|
||||
proje ajanını; proje ajanı, kişisel ajanı; kişisel ajan, yönetilen/yereli;
|
||||
| Kapsam | Yol | Görünür olduğu yer |
|
||||
| --------------------- | ------------------------------------------- | ------------------------------- |
|
||||
| Agent başına | `<workspace>/skills` | Yalnızca o agent |
|
||||
| Proje agent'i | `<workspace>/.agents/skills` | Yalnızca o çalışma alanı agent'i |
|
||||
| Kişisel agent | `~/.agents/skills` | O makinedeki tüm agent'ler |
|
||||
| Paylaşılan yönetilen/yerel | `~/.openclaw/skills` | O makinedeki tüm agent'ler |
|
||||
| Paylaşılan ek dizinler | `skills.load.extraDirs` (en düşük öncelik) | O makinedeki tüm agent'ler |
|
||||
|
||||
Aynı ad birden fazla yerdeyse → en yüksek kaynak kazanır. Çalışma alanı,
|
||||
proje agent'ini; proje agent'i, kişisel agent'i; kişisel agent, yönetilen/yereli;
|
||||
yönetilen/yerel, paketle geleni; paketle gelen de ek dizinleri geçer.
|
||||
|
||||
## Ajan beceri izin listeleri
|
||||
## Agent beceri izin listeleri
|
||||
|
||||
Beceri **konumu** ve beceri **görünürlüğü** ayrı denetimlerdir.
|
||||
Konum/öncelik, aynı adlı bir becerinin hangi kopyasının kazanacağını belirler;
|
||||
ajan izin listeleri ise bir ajanın gerçekten hangi becerileri kullanabileceğini belirler.
|
||||
Konum/öncelik aynı ada sahip becerinin hangi kopyasının kazanacağını belirler;
|
||||
agent izin listeleri ise bir agent'in hangi becerileri gerçekten kullanabileceğini
|
||||
belirler.
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -75,93 +85,93 @@ ajan izin listeleri ise bir ajanın gerçekten hangi becerileri kullanabileceği
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="İzin listesi kuralları">
|
||||
- Varsayılan olarak sınırsız beceriler için `agents.defaults.skills` değerini atlayın.
|
||||
- Varsayılan olarak kısıtlanmamış beceriler için `agents.defaults.skills` değerini atlayın.
|
||||
- `agents.defaults.skills` değerini devralmak için `agents.list[].skills` değerini atlayın.
|
||||
- Beceri olmaması için `agents.list[].skills: []` ayarlayın.
|
||||
- Boş olmayan bir `agents.list[].skills` listesi, o ajan için **nihai** kümedir — varsayılanlarla birleştirilmez.
|
||||
- Etkin izin listesi istem oluşturma, beceri slash komutu keşfi, sandbox eşitlemesi ve beceri anlık görüntüleri genelinde uygulanır.
|
||||
|
||||
- Hiç beceri olmaması için `agents.list[].skills: []` ayarlayın.
|
||||
- Boş olmayan bir `agents.list[].skills` listesi, o agent için **nihai** kümedir — varsayılanlarla birleştirilmez.
|
||||
- Etkili izin listesi prompt oluşturma, beceri slash komutu keşfi, sandbox eşitlemesi ve beceri anlık görüntüleri genelinde uygulanır.
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Plugins ve beceriler
|
||||
## Plugin'ler ve beceriler
|
||||
|
||||
Plugins, `openclaw.plugin.json` içinde `skills` dizinlerini listeleyerek
|
||||
kendi becerilerini gönderebilir (yollar Plugin köküne görelidir). Plugin becerileri,
|
||||
Plugin etkinleştirildiğinde yüklenir. Bu, araç açıklaması için fazla uzun olan
|
||||
ancak Plugin kurulu olduğunda kullanılabilir olması gereken araca özgü
|
||||
işletim kılavuzları için doğru yerdir — örneğin tarayıcı
|
||||
Plugin, çok adımlı tarayıcı denetimi için bir `browser-automation` becerisi gönderir.
|
||||
Plugin'ler kendi becerilerini, `openclaw.plugin.json` içinde `skills`
|
||||
dizinlerini listeleyerek gönderebilir (yollar Plugin köküne görelidir).
|
||||
Plugin becerileri, Plugin etkinleştirildiğinde yüklenir. Bu, araç açıklaması
|
||||
için fazla uzun olan ancak Plugin yüklendiğinde kullanılabilir olması gereken
|
||||
araca özgü işletim kılavuzları için doğru yerdir; örneğin, tarayıcı
|
||||
Plugin'i çok adımlı tarayıcı denetimi için bir `browser-automation` becerisi
|
||||
gönderir.
|
||||
|
||||
Plugin beceri dizinleri, `skills.load.extraDirs` ile aynı düşük öncelikli
|
||||
yola birleştirilir; bu nedenle aynı adlı paketle gelen, yönetilen, ajan veya
|
||||
çalışma alanı becerisi bunları geçersiz kılar. Bunları Plugin yapılandırma
|
||||
girişindeki `metadata.openclaw.requires.config` ile kapılayabilirsiniz.
|
||||
yolla birleştirilir; bu yüzden aynı ada sahip paketle gelen, yönetilen,
|
||||
agent veya çalışma alanı becerisi bunların üzerine yazar. Bunları Plugin'in
|
||||
config girdisindeki `metadata.openclaw.requires.config` aracılığıyla geçitleyebilirsiniz.
|
||||
|
||||
Keşif/yapılandırma için [Plugins](/tr/tools/plugin) bölümüne, bu becerilerin
|
||||
öğrettiği araç yüzeyi için [Araçlar](/tr/tools) bölümüne bakın.
|
||||
Keşif/yapılandırma için [Plugin'ler](/tr/tools/plugin), bu becerilerin öğrettiği
|
||||
araç yüzeyi için [Araçlar](/tr/tools) bölümüne bakın.
|
||||
|
||||
## Skill Workshop
|
||||
## Beceri Atölyesi
|
||||
|
||||
İsteğe bağlı, deneysel **Skill Workshop** Plugin, ajan çalışması sırasında
|
||||
İsteğe bağlı, deneysel **Beceri Atölyesi** Plugin'i, agent çalışması sırasında
|
||||
gözlemlenen yeniden kullanılabilir prosedürlerden çalışma alanı becerileri
|
||||
oluşturabilir veya güncelleyebilir. Varsayılan olarak devre dışıdır ve
|
||||
`plugins.entries.skill-workshop` üzerinden açıkça etkinleştirilmelidir.
|
||||
|
||||
Skill Workshop yalnızca `<workspace>/skills` içine yazar, oluşturulan
|
||||
Beceri Atölyesi yalnızca `<workspace>/skills` içine yazar, oluşturulan
|
||||
içeriği tarar, bekleyen onayı veya otomatik güvenli yazmaları destekler,
|
||||
güvensiz önerileri karantinaya alır ve başarılı yazmalardan sonra beceri
|
||||
anlık görüntüsünü yeniler; böylece yeni beceriler Gateway yeniden başlatması
|
||||
olmadan kullanılabilir hale gelir.
|
||||
güvenli olmayan önerileri karantinaya alır ve başarılı yazmalardan sonra
|
||||
beceri anlık görüntüsünü yeniler; böylece yeni beceriler Gateway yeniden
|
||||
başlatması olmadan kullanılabilir hale gelir.
|
||||
|
||||
Bunu _"bir dahaki sefere GIF atfını doğrula"_ gibi düzeltmeler veya medya
|
||||
QA kontrol listeleri gibi zor kazanılmış iş akışları için kullanın. Bekleyen
|
||||
QA kontrol listeleri gibi zor edinilmiş iş akışları için kullanın. Bekleyen
|
||||
onayla başlayın; otomatik yazmaları yalnızca önerilerini inceledikten sonra
|
||||
güvenilir çalışma alanlarında kullanın. Tam kılavuz: [Skill Workshop Plugin](/tr/plugins/skill-workshop).
|
||||
güvenilir çalışma alanlarında kullanın. Tam kılavuz: [Beceri Atölyesi Plugin'i](/tr/plugins/skill-workshop).
|
||||
|
||||
## ClawHub (kurulum ve eşitleme)
|
||||
|
||||
[ClawHub](https://clawhub.ai), OpenClaw için herkese açık beceri kayıt defteridir.
|
||||
Keşif/kurulum/güncelleme için yerel `openclaw skills` komutlarını veya
|
||||
yayınlama/eşitleme iş akışları için ayrı `clawhub` CLI aracını kullanın.
|
||||
Tam kılavuz: [ClawHub](/tr/tools/clawhub).
|
||||
Keşfetme/kurma/güncelleme için yerel `openclaw skills` komutlarını veya
|
||||
yayınlama/eşitleme iş akışları için ayrı `clawhub` CLI'yi kullanın. Tam kılavuz:
|
||||
[ClawHub](/tr/tools/clawhub).
|
||||
|
||||
| Eylem | Komut |
|
||||
| ------------------------------------ | -------------------------------------- |
|
||||
| Çalışma alanına bir beceri kur | `openclaw skills install <skill-slug>` |
|
||||
| Kurulu tüm becerileri güncelle | `openclaw skills update --all` |
|
||||
| Eşitle (tara + güncellemeleri yayımla) | `clawhub sync --all` |
|
||||
| Eylem | Komut |
|
||||
| ---------------------------------- | -------------------------------------- |
|
||||
| Çalışma alanına beceri kur | `openclaw skills install <skill-slug>` |
|
||||
| Kurulu tüm becerileri güncelle | `openclaw skills update --all` |
|
||||
| Eşitle (tara + güncellemeleri yayınla) | `clawhub sync --all` |
|
||||
|
||||
Yerel `openclaw skills install`, etkin çalışma alanı `skills/` dizinine
|
||||
Yerel `openclaw skills install`, etkin çalışma alanındaki `skills/` dizinine
|
||||
kurulum yapar. Ayrı `clawhub` CLI de geçerli çalışma dizininizin altındaki
|
||||
`./skills` içine kurulum yapar (veya yapılandırılmış OpenClaw çalışma alanına
|
||||
geri döner). OpenClaw bunu bir sonraki oturumda `<workspace>/skills` olarak
|
||||
alır. Yapılandırılmış beceri kökleri, `skills/<group>/<skill>/SKILL.md`
|
||||
gibi tek bir gruplama düzeyini de destekler; böylece ilgili üçüncü taraf
|
||||
becerileri geniş özyinelemeli tarama olmadan paylaşılan bir klasör altında
|
||||
tutulabilir.
|
||||
`./skills` konumuna kurulum yapar (veya yapılandırılmış OpenClaw çalışma
|
||||
alanına geri döner). OpenClaw bunu bir sonraki oturumda `<workspace>/skills`
|
||||
olarak alır.
|
||||
Yapılandırılmış beceri kökleri, `skills/<group>/<skill>/SKILL.md` gibi tek
|
||||
bir gruplama seviyesini de destekler; böylece ilişkili üçüncü taraf beceriler
|
||||
geniş özyinelemeli tarama olmadan paylaşılan bir klasör altında tutulabilir.
|
||||
|
||||
ClawHub beceri sayfaları, kurulumdan önce en son güvenlik taraması durumunu
|
||||
VirusTotal, ClawScan ve statik analiz için tarayıcı ayrıntı sayfalarıyla
|
||||
birlikte gösterir. `openclaw skills install <slug>` yalnızca kurulum yolu
|
||||
olarak kalır; yayıncılar yanlış pozitifleri ClawHub panosu veya
|
||||
`clawhub skill rescan <slug>` üzerinden düzeltir.
|
||||
VirusTotal, ClawScan ve statik analiz için tarayıcı ayrıntı sayfalarıyla birlikte
|
||||
gösterir. `openclaw skills install <slug>` yalnızca kurulum yolu olarak kalır;
|
||||
yayıncılar yanlış pozitifleri ClawHub panosu veya `clawhub skill rescan <slug>`
|
||||
üzerinden düzeltir.
|
||||
|
||||
## Güvenlik
|
||||
|
||||
<Warning>
|
||||
Üçüncü taraf becerileri **güvenilmeyen kod** olarak değerlendirin. Etkinleştirmeden
|
||||
Üçüncü taraf becerileri **güvenilmeyen kod** olarak ele alın. Etkinleştirmeden
|
||||
önce okuyun. Güvenilmeyen girdiler ve riskli araçlar için sandbox içinde
|
||||
çalıştırmayı tercih edin. Ajan tarafı denetimler için
|
||||
çalıştırmaları tercih edin. Agent tarafı denetimleri için
|
||||
[Sandboxing](/tr/gateway/sandboxing) bölümüne bakın.
|
||||
</Warning>
|
||||
|
||||
- Çalışma alanı ve ek dizin beceri keşfi, yalnızca çözümlenen gerçek yolu yapılandırılmış kökün içinde kalan beceri köklerini ve `SKILL.md` dosyalarını kabul eder.
|
||||
- Gateway destekli beceri bağımlılığı kurulumları (`skills.install`, onboarding ve Skills ayarları UI), kurulum metaverilerini yürütmeden önce yerleşik tehlikeli kod tarayıcısını çalıştırır. Çağıran açıkça tehlikeli geçersiz kılmayı ayarlamadıkça `critical` bulgular varsayılan olarak engeller; şüpheli bulgular ise yine yalnızca uyarır.
|
||||
- `openclaw skills install <slug>` farklıdır — çalışma alanına bir ClawHub beceri klasörü indirir ve yukarıdaki kurulum metaverisi yolunu kullanmaz.
|
||||
- `skills.entries.*.env` ve `skills.entries.*.apiKey`, o ajan turu için gizli değerleri **host** sürecine enjekte eder (sandbox içine değil). Gizli değerleri istemlerden ve günlüklerden uzak tutun.
|
||||
- Çalışma alanı ve ek dizin beceri keşfi yalnızca çözümlenen realpath'i yapılandırılmış kökün içinde kalan beceri köklerini ve `SKILL.md` dosyalarını kabul eder.
|
||||
- Gateway destekli beceri bağımlılığı kurulumları (`skills.install`, onboarding ve Skills ayarları arayüzü), kurulum metadatasını çalıştırmadan önce yerleşik tehlikeli kod tarayıcısını çalıştırır. `critical` bulgular, çağıran taraf tehlikeli geçersiz kılmayı açıkça ayarlamadıkça varsayılan olarak engeller; şüpheli bulgular ise yine yalnızca uyarır.
|
||||
- `openclaw skills install <slug>` farklıdır — bir ClawHub beceri klasörünü çalışma alanına indirir ve yukarıdaki kurulum metadata yolunu kullanmaz.
|
||||
- `skills.entries.*.env` ve `skills.entries.*.apiKey`, sırları o agent turu için **host** sürecine enjekte eder (sandbox'a değil). Sırları prompt'lardan ve günlüklerden uzak tutun.
|
||||
|
||||
Daha geniş bir tehdit modeli ve kontrol listeleri için [Güvenlik](/tr/gateway/security) bölümüne bakın.
|
||||
Daha geniş tehdit modeli ve kontrol listeleri için [Güvenlik](/tr/gateway/security) bölümüne bakın.
|
||||
|
||||
## SKILL.md biçimi
|
||||
|
||||
@ -174,37 +184,35 @@ description: Generate or edit images via a provider-backed image workflow
|
||||
---
|
||||
```
|
||||
|
||||
OpenClaw, düzen/amaç için AgentSkills belirtimini izler. Gömülü ajan
|
||||
tarafından kullanılan ayrıştırıcı yalnızca **tek satırlık** frontmatter
|
||||
anahtarlarını destekler; `metadata` bir **tek satırlık JSON nesnesi**
|
||||
olmalıdır. Talimatlarda beceri klasörü yoluna başvurmak için `{baseDir}`
|
||||
kullanın.
|
||||
OpenClaw düzen/amaç için AgentSkills spesifikasyonunu izler. Gömülü agent
|
||||
tarafından kullanılan ayrıştırıcı yalnızca **tek satırlı** frontmatter
|
||||
anahtarlarını destekler; `metadata` bir **tek satırlı JSON nesnesi** olmalıdır.
|
||||
Beceri klasörü yoluna başvurmak için talimatlarda `{baseDir}` kullanın.
|
||||
|
||||
### İsteğe bağlı frontmatter anahtarları
|
||||
|
||||
<ParamField path="homepage" type="string">
|
||||
macOS Skills UI içinde "Web sitesi" olarak gösterilen URL. `metadata.openclaw.homepage` üzerinden de desteklenir.
|
||||
macOS Skills arayüzünde "Web sitesi" olarak gösterilen URL. `metadata.openclaw.homepage` üzerinden de desteklenir.
|
||||
</ParamField>
|
||||
<ParamField path="user-invocable" type="boolean" default="true">
|
||||
`true` olduğunda beceri, kullanıcı slash komutu olarak sunulur.
|
||||
`true` olduğunda beceri kullanıcı slash komutu olarak gösterilir.
|
||||
</ParamField>
|
||||
<ParamField path="disable-model-invocation" type="boolean" default="false">
|
||||
`true` olduğunda beceri, model isteminden çıkarılır (kullanıcı çağrısıyla yine kullanılabilir).
|
||||
`true` olduğunda beceri model prompt'undan çıkarılır (kullanıcı çağrısıyla hâlâ kullanılabilir).
|
||||
</ParamField>
|
||||
<ParamField path="command-dispatch" type='"tool"'>
|
||||
`tool` olarak ayarlandığında slash komutu modeli atlar ve doğrudan bir araca gönderilir.
|
||||
`tool` olarak ayarlandığında slash komutu modeli atlar ve doğrudan bir araca iletilir.
|
||||
</ParamField>
|
||||
<ParamField path="command-tool" type="string">
|
||||
`command-dispatch: tool` ayarlandığında çağrılacak araç adı.
|
||||
</ParamField>
|
||||
<ParamField path="command-arg-mode" type='"raw"' default="raw">
|
||||
Araç gönderimi için ham argüman dizesini araca iletir (çekirdek ayrıştırma yok). Araç `{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }` ile çağrılır.
|
||||
Araç iletimi için ham argüman dizesini araca iletir (çekirdek ayrıştırma yoktur). Araç `{ command: "<raw args>", commandName: "<slash command>", skillName: "<skill name>" }` ile çağrılır.
|
||||
</ParamField>
|
||||
|
||||
## Kapılama (yükleme zamanı filtreleri)
|
||||
## Geçitleme (yükleme zamanı filtreleri)
|
||||
|
||||
OpenClaw, `metadata` (tek satırlık JSON) kullanarak becerileri yükleme
|
||||
zamanında filtreler:
|
||||
OpenClaw, becerileri yükleme zamanında `metadata` (tek satırlı JSON) kullanarak filtreler:
|
||||
|
||||
```markdown
|
||||
---
|
||||
@ -224,53 +232,53 @@ metadata:
|
||||
`metadata.openclaw` altındaki alanlar:
|
||||
|
||||
<ParamField path="always" type="boolean">
|
||||
`true` olduğunda beceriyi her zaman dahil et (diğer kapıları atla).
|
||||
`true` olduğunda beceriyi her zaman dahil et (diğer geçitleri atla).
|
||||
</ParamField>
|
||||
<ParamField path="emoji" type="string">
|
||||
macOS Skills UI tarafından kullanılan isteğe bağlı emoji.
|
||||
macOS Skills arayüzü tarafından kullanılan isteğe bağlı emoji.
|
||||
</ParamField>
|
||||
<ParamField path="homepage" type="string">
|
||||
macOS Skills UI içinde "Web sitesi" olarak gösterilen isteğe bağlı URL.
|
||||
macOS Skills arayüzünde "Web sitesi" olarak gösterilen isteğe bağlı URL.
|
||||
</ParamField>
|
||||
<ParamField path="os" type='"darwin" | "linux" | "win32"' >
|
||||
İsteğe bağlı platform listesi. Ayarlanırsa beceri yalnızca bu işletim sistemlerinde uygundur.
|
||||
İsteğe bağlı platform listesi. Ayarlanırsa beceri yalnızca bu OS'lerde uygun olur.
|
||||
</ParamField>
|
||||
<ParamField path="requires.bins" type="string[]">
|
||||
Her biri `PATH` üzerinde bulunmalıdır.
|
||||
Her biri `PATH` üzerinde mevcut olmalıdır.
|
||||
</ParamField>
|
||||
<ParamField path="requires.anyBins" type="string[]">
|
||||
En az biri `PATH` üzerinde bulunmalıdır.
|
||||
En az biri `PATH` üzerinde mevcut olmalıdır.
|
||||
</ParamField>
|
||||
<ParamField path="requires.env" type="string[]">
|
||||
Ortam değişkeni bulunmalı veya yapılandırmada sağlanmalıdır.
|
||||
Env var mevcut olmalı veya config içinde sağlanmalıdır.
|
||||
</ParamField>
|
||||
<ParamField path="requires.config" type="string[]">
|
||||
Doğru değerli olması gereken `openclaw.json` yollarının listesi.
|
||||
Truthy olması gereken `openclaw.json` yollarının listesi.
|
||||
</ParamField>
|
||||
<ParamField path="primaryEnv" type="string">
|
||||
`skills.entries.<name>.apiKey` ile ilişkili ortam değişkeni adı.
|
||||
`skills.entries.<name>.apiKey` ile ilişkili env var adı.
|
||||
</ParamField>
|
||||
<ParamField path="install" type="object[]">
|
||||
macOS Skills UI tarafından kullanılan isteğe bağlı kurulum belirtimleri (brew/node/go/uv/download).
|
||||
macOS Skills arayüzü tarafından kullanılan isteğe bağlı kurulum spesifikasyonları (brew/node/go/uv/download).
|
||||
</ParamField>
|
||||
|
||||
`metadata.openclaw` yoksa beceri her zaman uygundur (yapılandırmada devre dışı
|
||||
bırakılmadıkça veya paketle gelen beceriler için `skills.allowBundled`
|
||||
tarafından engellenmedikçe).
|
||||
`metadata.openclaw` yoksa, beceri her zaman uygun kabul edilir (config içinde
|
||||
devre dışı bırakılmadığı veya paketle gelen beceriler için `skills.allowBundled`
|
||||
tarafından engellenmediği sürece).
|
||||
|
||||
<Note>
|
||||
Eski `metadata.clawdbot` blokları, `metadata.openclaw` yokken hâlâ kabul edilir;
|
||||
böylece daha eski kurulu beceriler bağımlılık kapılarını ve kurulum ipuçlarını
|
||||
korur. Yeni ve güncellenmiş beceriler `metadata.openclaw` kullanmalıdır.
|
||||
Eski `metadata.clawdbot` blokları, `metadata.openclaw` olmadığında hâlâ kabul
|
||||
edilir; böylece daha eski kurulu beceriler bağımlılık geçitlerini ve kurulum
|
||||
ipuçlarını korur. Yeni ve güncellenen beceriler `metadata.openclaw` kullanmalıdır.
|
||||
</Note>
|
||||
|
||||
### Sandboxing notları
|
||||
### Sandbox notları
|
||||
|
||||
- `requires.bins`, beceri yükleme zamanında **host** üzerinde denetlenir.
|
||||
- Bir ajan sandbox içindese, ikili dosya **konteynerin içinde** de bulunmalıdır. Bunu `agents.defaults.sandbox.docker.setupCommand` (veya özel bir imaj) ile kurun. `setupCommand`, konteyner oluşturulduktan sonra bir kez çalışır. Paket kurulumları ayrıca ağ çıkışı, yazılabilir kök FS ve sandbox içinde root kullanıcı gerektirir.
|
||||
- Örnek: `summarize` becerisi (`skills/summarize/SKILL.md`), orada çalışmak için sandbox konteynerinde `summarize` CLI aracına ihtiyaç duyar.
|
||||
- Bir agent sandbox içindeyse, ikili dosya **container içinde** de mevcut olmalıdır. Bunu `agents.defaults.sandbox.docker.setupCommand` (veya özel bir image) üzerinden kurun. `setupCommand`, container oluşturulduktan sonra bir kez çalışır. Paket kurulumları ayrıca ağ çıkışı, yazılabilir root FS ve sandbox içinde bir root kullanıcı gerektirir.
|
||||
- Örnek: `summarize` becerisi (`skills/summarize/SKILL.md`) orada çalışmak için sandbox container içinde `summarize` CLI'ye ihtiyaç duyar.
|
||||
|
||||
### Kurulum belirtimleri
|
||||
### Kurulum spesifikasyonları
|
||||
|
||||
```markdown
|
||||
---
|
||||
@ -298,17 +306,17 @@ metadata:
|
||||
```
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Yükleyici seçim kuralları">
|
||||
- Birden fazla yükleyici listelenirse gateway tek bir tercih edilen seçenek seçer (varsa brew, aksi halde node).
|
||||
- Tüm yükleyiciler `download` ise OpenClaw, mevcut artifaktları görebilmeniz için her girdiyi listeler.
|
||||
- Yükleyici tanımları, seçenekleri platforma göre filtrelemek için `os: ["darwin"|"linux"|"win32"]` içerebilir.
|
||||
- Node kurulumları, `openclaw.json` içindeki `skills.install.nodeManager` ayarına uyar (varsayılan: npm; seçenekler: npm/pnpm/yarn/bun). Bu yalnızca skill kurulumlarını etkiler; Gateway çalışma zamanı yine Node olmalıdır — Bun, WhatsApp/Telegram için önerilmez.
|
||||
- Gateway destekli yükleyici seçimi tercih odaklıdır: kurulum tanımları türleri karıştırdığında OpenClaw, `skills.install.preferBrew` etkinse ve `brew` varsa önce Homebrew'i, sonra `uv`'yi, sonra yapılandırılan node yöneticisini, ardından `go` veya `download` gibi diğer yedekleri tercih eder.
|
||||
- Her kurulum tanımı `download` ise OpenClaw, tek bir tercih edilen yükleyiciye indirgemek yerine tüm indirme seçeneklerini gösterir.
|
||||
<Accordion title="Kurucu seçim kuralları">
|
||||
- Birden çok kurucu listelenmişse gateway tek bir tercih edilen seçenek seçer (varsa brew, aksi halde node).
|
||||
- Tüm kurucular `download` ise OpenClaw her girdiyi listeler, böylece kullanılabilir yapıtları görebilirsiniz.
|
||||
- Kurucu belirtimleri, seçenekleri platforma göre filtrelemek için `os: ["darwin"|"linux"|"win32"]` içerebilir.
|
||||
- Node kurulumları `openclaw.json` içindeki `skills.install.nodeManager` değerini dikkate alır (varsayılan: npm; seçenekler: npm/pnpm/yarn/bun). Bu yalnızca Skills kurulumlarını etkiler; Gateway çalışma zamanı yine Node olmalıdır — Bun, WhatsApp/Telegram için önerilmez.
|
||||
- Gateway destekli kurucu seçimi tercihe dayalıdır: kurulum belirtimleri farklı türleri karıştırdığında OpenClaw, `skills.install.preferBrew` etkinse ve `brew` mevcutsa Homebrew'ı tercih eder, ardından `uv`, sonra yapılandırılmış node yöneticisi, sonra `go` veya `download` gibi diğer yedekler gelir.
|
||||
- Her kurulum belirtimi `download` ise OpenClaw, tek bir tercih edilen kurucuya indirgemek yerine tüm indirme seçeneklerini gösterir.
|
||||
|
||||
</Accordion>
|
||||
<Accordion title="Yükleyici başına ayrıntılar">
|
||||
- **Go kurulumları:** `go` eksikse ve `brew` kullanılabiliyorsa gateway önce Homebrew üzerinden Go kurar ve mümkün olduğunda `GOBIN` değerini Homebrew'in `bin` dizinine ayarlar.
|
||||
<Accordion title="Kurucu bazında ayrıntılar">
|
||||
- **Go kurulumları:** `go` yoksa ve `brew` kullanılabiliyorsa gateway önce Homebrew üzerinden Go kurar ve mümkün olduğunda `GOBIN` değerini Homebrew'ın `bin` dizinine ayarlar.
|
||||
- **İndirme kurulumları:** `url` (zorunlu), `archive` (`tar.gz` | `tar.bz2` | `zip`), `extract` (varsayılan: arşiv algılandığında otomatik), `stripComponents`, `targetDir` (varsayılan: `~/.openclaw/tools/<skillKey>`).
|
||||
|
||||
</Accordion>
|
||||
@ -316,8 +324,8 @@ metadata:
|
||||
|
||||
## Yapılandırma geçersiz kılmaları
|
||||
|
||||
Paketle gelen ve yönetilen skills, `~/.openclaw/openclaw.json` içindeki
|
||||
`skills.entries` altında açılıp kapatılabilir ve env değerleriyle beslenebilir:
|
||||
Paketle gelen ve yönetilen Skills, `~/.openclaw/openclaw.json` içindeki
|
||||
`skills.entries` altında açılıp kapatılabilir ve env değerleriyle sağlanabilir:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -342,37 +350,37 @@ Paketle gelen ve yönetilen skills, `~/.openclaw/openclaw.json` içindeki
|
||||
```
|
||||
|
||||
<ParamField path="enabled" type="boolean">
|
||||
`false`, paketle gelmiş veya kurulmuş olsa bile skill'i devre dışı bırakır.
|
||||
Paketle gelen `coding-agent` skill'i isteğe bağlıdır: agent'lara sunmadan önce
|
||||
`skills.entries.coding-agent.enabled: true` ayarını yapın,
|
||||
ardından `claude`, `codex`, `opencode` veya `pi` içinden birinin kurulu olduğundan ve
|
||||
kendi CLI'ı için kimliğinin doğrulandığından emin olun.
|
||||
`false`, paketle gelmiş veya kurulmuş olsa bile Skill'i devre dışı bırakır.
|
||||
Paketle gelen `coding-agent` Skill'i isteğe bağlıdır: agent'lara açmadan önce
|
||||
`skills.entries.coding-agent.enabled: true` ayarlayın,
|
||||
ardından `claude`, `codex`, `opencode` veya `pi` seçeneklerinden birinin kurulu olduğundan ve
|
||||
kendi CLI'ı için kimlik doğrulamasının yapıldığından emin olun.
|
||||
</ParamField>
|
||||
<ParamField path="apiKey" type='string | { source, provider, id }'>
|
||||
`metadata.openclaw.primaryEnv` bildiren skills için kolaylık sağlar. Düz metni veya SecretRef'i destekler.
|
||||
`metadata.openclaw.primaryEnv` bildiren Skills için kolaylık sağlar. Düz metin veya SecretRef destekler.
|
||||
</ParamField>
|
||||
<ParamField path="env" type="Record<string, string>">
|
||||
Yalnızca değişken süreçte zaten ayarlı değilse enjekte edilir.
|
||||
Yalnızca değişken süreçte zaten ayarlanmamışsa enjekte edilir.
|
||||
</ParamField>
|
||||
<ParamField path="config" type="object">
|
||||
Özel skill başına alanlar için isteğe bağlı torba. Özel anahtarlar burada bulunmalıdır.
|
||||
Özel Skill bazlı alanlar için isteğe bağlı torba. Özel anahtarlar burada bulunmalıdır.
|
||||
</ParamField>
|
||||
<ParamField path="allowBundled" type="string[]">
|
||||
Yalnızca **paketle gelen** skills için isteğe bağlı izin listesi. Ayarlanırsa yalnızca listedeki paketle gelen skills uygun olur (yönetilen/çalışma alanı skills etkilenmez).
|
||||
Yalnızca **paketle gelen** Skills için isteğe bağlı izin listesi. Ayarlanırsa yalnızca listedeki paketle gelen Skills uygun olur (yönetilen/çalışma alanı Skills etkilenmez).
|
||||
</ParamField>
|
||||
|
||||
Skill adı kısa çizgiler içeriyorsa anahtarı tırnak içine alın (JSON5 tırnaklı
|
||||
anahtarlara izin verir). Yapılandırma anahtarları varsayılan olarak **skill adı** ile eşleşir — bir skill
|
||||
anahtarlara izin verir). Yapılandırma anahtarları varsayılan olarak **Skill adı** ile eşleşir — bir Skill
|
||||
`metadata.openclaw.skillKey` tanımlıyorsa `skills.entries` altında bu anahtarı kullanın.
|
||||
|
||||
<Note>
|
||||
OpenClaw içinde stok görsel oluşturma/düzenleme için paketle gelen bir skill yerine
|
||||
OpenClaw içinde hazır görüntü oluşturma/düzenleme için paketle gelen bir Skill yerine
|
||||
`agents.defaults.imageGenerationModel` ile çekirdek
|
||||
`image_generate` aracını kullanın. Buradaki skill örnekleri özel veya üçüncü taraf
|
||||
iş akışları içindir. Yerel görsel analizi için
|
||||
`image_generate` aracını kullanın. Buradaki Skill örnekleri özel veya üçüncü taraf
|
||||
iş akışları içindir. Yerel görüntü analizi için
|
||||
`agents.defaults.imageModel` ile `image` aracını kullanın. `openai/*`, `google/*`,
|
||||
`fal/*` veya sağlayıcıya özgü başka bir görsel modeli seçerseniz o sağlayıcının
|
||||
kimlik doğrulama/API anahtarını da ekleyin.
|
||||
`fal/*` veya başka bir sağlayıcıya özgü görüntü modeli seçerseniz o sağlayıcının
|
||||
auth/API anahtarını da ekleyin.
|
||||
</Note>
|
||||
|
||||
## Ortam enjeksiyonu
|
||||
@ -381,37 +389,37 @@ Bir agent çalıştırması başladığında OpenClaw:
|
||||
|
||||
1. Skill metadata'sını okur.
|
||||
2. `skills.entries.<key>.env` ve `skills.entries.<key>.apiKey` değerlerini `process.env` üzerine uygular.
|
||||
3. Sistem istemini **uygun** skills ile oluşturur.
|
||||
3. Sistem istemini **uygun** Skills ile oluşturur.
|
||||
4. Çalıştırma sona erdikten sonra özgün ortamı geri yükler.
|
||||
|
||||
Ortam enjeksiyonu genel bir shell ortamı değil, **agent çalıştırmasıyla sınırlıdır**.
|
||||
|
||||
Paketle gelen `claude-cli` arka ucu için OpenClaw aynı uygun anlık görüntüyü
|
||||
geçici bir Claude Code plugin'i olarak da somutlaştırır ve
|
||||
`--plugin-dir` ile geçirir. Claude Code daha sonra kendi yerel skill çözücüsünü kullanabilir;
|
||||
OpenClaw ise önceliği, agent başına izin listelerini, kapılamayı ve
|
||||
`skills.entries.*` env/API anahtarı enjeksiyonunu yönetmeye devam eder. Diğer CLI arka uçları yalnızca
|
||||
Paketle gelen `claude-cli` arka ucu için OpenClaw aynı
|
||||
uygun anlık görüntüyü geçici bir Claude Code Plugin'i olarak da oluşturur ve bunu
|
||||
`--plugin-dir` ile geçirir. Claude Code daha sonra kendi yerel Skill çözücüsünü kullanabilir; OpenClaw ise
|
||||
öncelik, agent bazlı izin listeleri, gating ve
|
||||
`skills.entries.*` env/API anahtarı enjeksiyonunun sahibi olmaya devam eder. Diğer CLI arka uçları yalnızca
|
||||
istem kataloğunu kullanır.
|
||||
|
||||
## Anlık görüntüler ve yenileme
|
||||
|
||||
OpenClaw, uygun skills için **bir oturum başladığında** anlık görüntü alır ve
|
||||
OpenClaw, **bir oturum başladığında** uygun Skills'in anlık görüntüsünü alır ve
|
||||
aynı oturumdaki sonraki turlarda bu listeyi yeniden kullanır. Skills veya yapılandırmadaki değişiklikler
|
||||
bir sonraki yeni oturumda etkili olur.
|
||||
|
||||
Skills oturum ortasında iki durumda yenilenebilir:
|
||||
|
||||
- Skills watcher etkindir.
|
||||
- Yeni bir uygun uzak node görünür.
|
||||
- Skills izleyicisi etkindir.
|
||||
- Yeni uygun bir uzak node görünür.
|
||||
|
||||
Bunu bir **hot reload** olarak düşünün: yenilenen liste bir sonraki
|
||||
agent turunda alınır. Bu oturum için geçerli agent skill izin listesi değişirse
|
||||
OpenClaw anlık görüntüyü yeniler, böylece görünür skills mevcut agent ile uyumlu kalır.
|
||||
Bunu bir **sıcak yeniden yükleme** olarak düşünün: yenilenmiş liste
|
||||
bir sonraki agent turunda alınır. O oturum için etkili agent Skill izin listesi değişirse
|
||||
OpenClaw anlık görüntüyü yeniler, böylece görünür Skills geçerli agent ile uyumlu kalır.
|
||||
|
||||
### Skills watcher
|
||||
### Skills izleyicisi
|
||||
|
||||
Varsayılan olarak OpenClaw skill klasörlerini izler ve `SKILL.md` dosyaları
|
||||
değiştiğinde skills anlık görüntüsünü artırır. `skills.load` altında yapılandırın:
|
||||
Varsayılan olarak OpenClaw Skill klasörlerini izler ve `SKILL.md` dosyaları değiştiğinde
|
||||
Skills anlık görüntüsünü artırır. `skills.load` altında yapılandırın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -426,54 +434,53 @@ değiştiğinde skills anlık görüntüsünü artırır. `skills.load` altında
|
||||
|
||||
### Uzak macOS node'ları (Linux gateway)
|
||||
|
||||
Gateway Linux üzerinde çalışıyor ancak `system.run` izni verilmiş bir **macOS node'u**
|
||||
Gateway Linux üzerinde çalışıyor ancak `system.run` izinli bir **macOS node'u**
|
||||
bağlıysa (Exec onayları güvenliği `deny` olarak ayarlanmamışsa),
|
||||
OpenClaw, gerekli ikili dosyalar o node üzerinde mevcut olduğunda yalnızca macOS skills'i uygun kabul edebilir.
|
||||
Agent bu skills'i `host=node` ile `exec` aracı üzerinden çalıştırmalıdır.
|
||||
gerekli binary'ler o node üzerinde bulunduğunda OpenClaw yalnızca macOS'a özgü Skills'i uygun kabul edebilir.
|
||||
Agent bu Skills'i `host=node` ile `exec` aracı üzerinden yürütmelidir.
|
||||
|
||||
Bu, node'un komut desteğini raporlamasına ve `system.which` veya `system.run`
|
||||
üzerinden yapılan bir bin probe'a dayanır. Çevrimdışı node'lar **uzaklara özel** skills'i
|
||||
görünür yapmaz. Bağlı bir node bin probe'larına yanıt vermeyi bırakırsa
|
||||
OpenClaw, önbelleğe alınmış bin eşleşmelerini temizler; böylece agent'lar şu anda orada
|
||||
çalışamayan skills'i artık görmez.
|
||||
Bu, node'un komut desteğini bildirmesine ve `system.which` veya `system.run` üzerinden
|
||||
bir bin yoklamasına dayanır. Çevrimdışı node'lar **yalnızca uzak** Skills'i görünür yapmaz.
|
||||
Bağlı bir node bin yoklamalarına yanıt vermeyi durdurursa OpenClaw önbelleğe alınmış bin eşleşmelerini temizler,
|
||||
böylece agent'lar artık şu anda orada çalıştırılamayan Skills'i görmez.
|
||||
|
||||
## Token etkisi
|
||||
|
||||
Skills uygun olduğunda OpenClaw, mevcut skills'in kompakt bir XML listesini
|
||||
sistem istemine enjekte eder (`pi-coding-agent` içindeki `formatSkillsForPrompt`
|
||||
üzerinden). Maliyet deterministiktir:
|
||||
Skills uygun olduğunda OpenClaw, sistem istemine kullanılabilir Skills'in kompakt bir XML listesini
|
||||
(`pi-coding-agent` içindeki `formatSkillsForPrompt` üzerinden) enjekte eder.
|
||||
Maliyet deterministiktir:
|
||||
|
||||
- **Temel ek yük** (yalnızca ≥1 skill olduğunda): 195 karakter.
|
||||
- **Temel ek yük** (yalnızca ≥1 Skill olduğunda): 195 karakter.
|
||||
- **Skill başına:** 97 karakter + XML kaçışlı `<name>`, `<description>` ve `<location>` değerlerinin uzunluğu.
|
||||
|
||||
Formül (karakterler):
|
||||
Formül (karakter):
|
||||
|
||||
```text
|
||||
total = 195 + Σ (97 + len(name_escaped) + len(description_escaped) + len(location_escaped))
|
||||
```
|
||||
|
||||
XML kaçışlama `& < > " '` karakterlerini varlıklara (`&`, `<` vb.)
|
||||
genişleterek uzunluğu artırır. Token sayıları model tokenizer'ına göre değişir. Kabaca
|
||||
XML kaçışı `& < > " '` karakterlerini entity'lere (`&`, `<` vb.) genişletir,
|
||||
bu da uzunluğu artırır. Token sayıları model tokenizer'ına göre değişir. Kabaca
|
||||
OpenAI tarzı bir tahmin ~4 karakter/token olduğundan **97 karakter ≈ 24 token** eder;
|
||||
buna skill başına gerçek alan uzunluklarınız eklenir.
|
||||
buna Skill başına gerçek alan uzunluklarınız eklenir.
|
||||
|
||||
## Yönetilen skills yaşam döngüsü
|
||||
## Yönetilen Skills yaşam döngüsü
|
||||
|
||||
OpenClaw, kurulumla (npm paketi veya OpenClaw.app) birlikte temel bir skills kümesini
|
||||
**paketle gelen skills** olarak gönderir. `~/.openclaw/skills`, yerel geçersiz kılmalar için vardır —
|
||||
örneğin paketle gelen kopyayı değiştirmeden bir skill'i sabitlemek veya yamamak için.
|
||||
Çalışma alanı skills kullanıcıya aittir ve ad çakışmalarında ikisinin de üzerine yazar.
|
||||
OpenClaw, kurulumla (npm paketi veya OpenClaw.app) birlikte temel bir Skills kümesini
|
||||
**paketle gelen Skills** olarak gönderir. `~/.openclaw/skills`, yerel geçersiz kılmalar için vardır —
|
||||
örneğin paketle gelen kopyayı değiştirmeden bir Skill'i sabitlemek veya yamamak için.
|
||||
Çalışma alanı Skills kullanıcıya aittir ve ad çakışmalarında ikisini de geçersiz kılar.
|
||||
|
||||
## Daha fazla skill mi arıyorsunuz?
|
||||
## Daha fazla Skill mi arıyorsunuz?
|
||||
|
||||
[https://clawhub.ai](https://clawhub.ai) adresine göz atın. Tam yapılandırma
|
||||
şeması: [Skills yapılandırması](/tr/tools/skills-config).
|
||||
|
||||
## İlgili
|
||||
|
||||
- [ClawHub](/tr/tools/clawhub) — herkese açık skills kayıt defteri
|
||||
- [Skill oluşturma](/tr/tools/creating-skills) — özel skills oluşturma
|
||||
- [Plugins](/tr/tools/plugin) — plugin sistemi genel bakışı
|
||||
- [Skill Workshop plugin](/tr/plugins/skill-workshop) — agent çalışmasından skills üretin
|
||||
- [Skills yapılandırması](/tr/tools/skills-config) — skill yapılandırması başvurusu
|
||||
- [Slash komutları](/tr/tools/slash-commands) — mevcut tüm slash komutları
|
||||
- [ClawHub](/tr/tools/clawhub) — herkese açık Skills kayıt defteri
|
||||
- [Skills oluşturma](/tr/tools/creating-skills) — özel Skills oluşturma
|
||||
- [Plugins](/tr/tools/plugin) — Plugin sistemi genel bakışı
|
||||
- [Skill Workshop Plugin'i](/tr/plugins/skill-workshop) — agent çalışmasından Skills oluşturma
|
||||
- [Skills yapılandırması](/tr/tools/skills-config) — Skill yapılandırma başvurusu
|
||||
- [Eğik çizgi komutları](/tr/tools/slash-commands) — kullanılabilir tüm eğik çizgi komutları
|
||||
|
||||
Loading…
Reference in New Issue
Block a user