chore(i18n): refresh tr translations
This commit is contained in:
parent
0ff13a0571
commit
860615c06f
119
docs/tr/ci.md
119
docs/tr/ci.md
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Bir CI işinin neden çalıştığını veya çalışmadığını anlamanız gerekiyor.
|
||||
- Bir CI işinin neden çalıştığını veya neden çalışmadığını anlamanız gerekir.
|
||||
- Başarısız GitHub Actions kontrollerinde hata ayıklıyorsunuz.
|
||||
summary: CI iş grafiği, kapsam geçitleri ve yerel komut eşdeğerleri
|
||||
title: CI işlem hattı
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T08:58:41Z"
|
||||
generated_at: "2026-04-23T13:58:02Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 5c89c66204b203a39435cfc19de7b437867f2792bbfa2c3948371abde9f80e11
|
||||
source_hash: c5a8ea0d8e428826169b0e6aced1caeb993106fe79904002125ace86b48cae1f
|
||||
source_path: ci.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -17,91 +17,84 @@ x-i18n:
|
||||
|
||||
CI, `main` dalına yapılan her push işleminde ve her pull request'te çalışır. Yalnızca ilgisiz alanlar değiştiğinde pahalı işleri atlamak için akıllı kapsamlandırma kullanır.
|
||||
|
||||
QA Lab, ana akıllı kapsamlı iş akışının dışında özel CI şeritlerine sahiptir.
|
||||
`Parity gate` iş akışı, eşleşen PR değişikliklerinde ve manuel tetiklemede çalışır;
|
||||
özel QA çalışma zamanını derler ve sahte GPT-5.4 ile Opus 4.6
|
||||
agentic paketlerini karşılaştırır. `QA-Lab - All Lanes` iş akışı, `main` üzerinde gece çalışır ve
|
||||
manuel tetiklemede de çalışır; sahte parity gate, canlı Matrix şeridi ve canlı
|
||||
Telegram şeridini paralel işler olarak dağıtır. Canlı işler `qa-live-shared`
|
||||
ortamını kullanır ve Telegram şeridi Convex lease'leri kullanır. `OpenClaw Release
|
||||
Checks` de sürüm onayından önce aynı QA Lab şeritlerini çalıştırır.
|
||||
QA Lab, ana akıllı kapsamlı iş akışının dışında özel CI hatlarına sahiptir. `Parity gate` iş akışı, eşleşen PR değişikliklerinde ve manuel tetikleme ile çalışır; özel QA çalışma zamanını derler ve sahte GPT-5.4 ile Opus 4.6 etmen paketlerini karşılaştırır. `QA-Lab - All Lanes` iş akışı, `main` üzerinde gecelik olarak ve manuel tetikleme ile çalışır; sahte parity gate, canlı Matrix hattı ve canlı Telegram hattını paralel işler olarak dağıtır. Canlı işler `qa-live-shared` environment'ını kullanır ve Telegram hattı Convex kiralamalarını kullanır. `OpenClaw Release Checks` de sürüm onayından önce aynı QA Lab hatlarını çalıştırır.
|
||||
|
||||
## İş Genel Bakışı
|
||||
## İş Genel Görünümü
|
||||
|
||||
| İş | Amaç | Ne zaman çalışır |
|
||||
| -------------------------------- | -------------------------------------------------------------------------------------------- | ----------------------------------- |
|
||||
| `preflight` | Yalnızca docs değişikliklerini, değişen kapsamları, değişen extension'ları algılar ve CI manifest'ini oluşturur | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `security-scm-fast` | `zizmor` ile özel anahtar algılama ve iş akışı denetimi | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `security-dependency-audit` | npm advisories'e karşı bağımlılıksız üretim lockfile denetimi | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `security-fast` | Hızlı güvenlik işleri için zorunlu toplu iş | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `build-artifacts` | `dist/`, Control UI, yerleşik artifact kontrolleri ve yeniden kullanılabilir downstream artifact'leri derler | Node ile ilgili değişiklikler |
|
||||
| `checks-fast-core` | paketle gelen/plugin-contract/protocol kontrolleri gibi hızlı Linux doğruluk şeritleri | Node ile ilgili değişiklikler |
|
||||
| `checks-fast-contracts-channels` | Kararlı bir toplu kontrol sonucuyla shard'lanmış kanal sözleşmesi kontrolleri | Node ile ilgili değişiklikler |
|
||||
| `checks-node-extensions` | extension paketi genelinde tam paketle gelen Plugin test shard'ları | Node ile ilgili değişiklikler |
|
||||
| `checks-node-core-test` | Kanal, paketle gelen, sözleşme ve extension şeritleri hariç çekirdek Node test shard'ları | Node ile ilgili değişiklikler |
|
||||
| `extension-fast` | Yalnızca değişen paketle gelen Plugin'ler için odaklı testler | extension değişiklikli pull request'ler |
|
||||
| `check` | Parçalanmış ana yerel geçit eşdeğeri: prod türleri, lint, guard'lar, test türleri ve katı smoke | Node ile ilgili değişiklikler |
|
||||
| `check-additional` | Mimari, sınır, extension-surface guard'ları, package-boundary ve gateway-watch shard'ları | Node ile ilgili değişiklikler |
|
||||
| `build-smoke` | Yerleşik CLI smoke testleri ve başlangıç belleği smoke testi | Node ile ilgili değişiklikler |
|
||||
| `checks` | Yerleşik artifact kanal testleri ile yalnızca push için Node 22 uyumluluğu doğrulayıcısı | Node ile ilgili değişiklikler |
|
||||
| `check-docs` | Docs biçimlendirme, lint ve bozuk bağlantı kontrolleri | Docs değiştiğinde |
|
||||
| `skills-python` | Python destekli Skills için Ruff + pytest | Python-skill ile ilgili değişiklikler |
|
||||
| `checks-windows` | Windows'a özel test şeritleri | Windows ile ilgili değişiklikler |
|
||||
| `macos-node` | Paylaşılan yerleşik artifact'leri kullanan macOS TypeScript test şeridi | macOS ile ilgili değişiklikler |
|
||||
| `macos-swift` | macOS uygulaması için Swift lint, derleme ve testler | macOS ile ilgili değişiklikler |
|
||||
| `android` | Her iki flavor için Android birim testleri artı bir debug APK derlemesi | Android ile ilgili değişiklikler |
|
||||
| `preflight` | Yalnızca dokümantasyon değişikliklerini, değişen kapsamları, değişen eklentileri algılar ve CI manifestini oluşturur | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `security-scm-fast` | `zizmor` aracılığıyla özel anahtar algılama ve iş akışı denetimi | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `security-dependency-audit` | npm advisory'lerine karşı bağımlılıksız üretim lockfile denetimi | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `security-fast` | Hızlı güvenlik işleri için zorunlu toplu iş | Taslak olmayan push ve PR'lerde her zaman |
|
||||
| `build-artifacts` | `dist/`, Control UI, derlenmiş artifact kontrolleri ve yeniden kullanılabilir aşağı akış artifact'lerini derler | Node ile ilgili değişiklikler |
|
||||
| `checks-fast-core` | bundled/plugin-contract/protocol kontrolleri gibi hızlı Linux doğruluk hatları | Node ile ilgili değişiklikler |
|
||||
| `checks-fast-contracts-channels` | Kararlı bir toplu kontrol sonucu ile shard'lanmış kanal sözleşme kontrolleri | Node ile ilgili değişiklikler |
|
||||
| `checks-node-extensions` | eklenti paketi genelinde tam bundled-plugin test shard'ları | Node ile ilgili değişiklikler |
|
||||
| `checks-node-core-test` | kanal, bundled, contract ve eklenti hatları hariç çekirdek Node test shard'ları | Node ile ilgili değişiklikler |
|
||||
| `extension-fast` | Yalnızca değişen bundled plugin'ler için odaklı testler | eklenti değişiklikleri olan pull request'ler |
|
||||
| `check` | shard'lanmış ana yerel geçit eşdeğeri: prod türleri, lint, guard'lar, test türleri ve katı smoke | Node ile ilgili değişiklikler |
|
||||
| `check-additional` | Mimari, sınır, eklenti yüzeyi guard'ları, package-boundary ve gateway-watch shard'ları | Node ile ilgili değişiklikler |
|
||||
| `build-smoke` | Derlenmiş CLI smoke testleri ve başlangıç belleği smoke testi | Node ile ilgili değişiklikler |
|
||||
| `checks` | Derlenmiş artifact kanal testleri artı yalnızca push için Node 22 uyumluluğu doğrulayıcısı | Node ile ilgili değişiklikler |
|
||||
| `check-docs` | Dokümantasyon biçimlendirme, lint ve bozuk bağlantı kontrolleri | Dokümantasyon değiştiğinde |
|
||||
| `skills-python` | Python destekli Skills için Ruff + pytest | Python skill ile ilgili değişiklikler |
|
||||
| `checks-windows` | Windows'a özgü test hatları | Windows ile ilgili değişiklikler |
|
||||
| `macos-node` | Paylaşılan derlenmiş artifact'leri kullanan macOS TypeScript test hattı | macOS ile ilgili değişiklikler |
|
||||
| `macos-swift` | macOS uygulaması için Swift lint, build ve testler | macOS ile ilgili değişiklikler |
|
||||
| `android` | Her iki flavor için Android birim testleri artı bir debug APK build'i | Android ile ilgili değişiklikler |
|
||||
|
||||
## Hızlı Başarısız Olma Sırası
|
||||
## Önce Hızlı Başarısız Olma Sırası
|
||||
|
||||
İşler, pahalı olanlar çalışmadan önce ucuz kontroller başarısız olacak şekilde sıralanır:
|
||||
İşler, pahalı işler çalışmadan önce ucuz kontroller başarısız olacak şekilde sıralanır:
|
||||
|
||||
1. `preflight`, hangi şeritlerin var olacağına en başta karar verir. `docs-scope` ve `changed-scope` mantığı bağımsız işler değil, bu işin içindeki adımlardır.
|
||||
1. `preflight`, hangi hatların var olacağına karar verir. `docs-scope` ve `changed-scope` mantığı bağımsız işler değil, bu işin içindeki adımlardır.
|
||||
2. `security-scm-fast`, `security-dependency-audit`, `security-fast`, `check`, `check-additional`, `check-docs` ve `skills-python`, daha ağır artifact ve platform matris işlerini beklemeden hızlıca başarısız olur.
|
||||
3. `build-artifacts`, hızlı Linux şeritleriyle çakışacak şekilde çalışır; böylece downstream tüketiciler paylaşılan derleme hazır olur olmaz başlayabilir.
|
||||
4. Daha ağır platform ve çalışma zamanı şeritleri bundan sonra dağıtılır: `checks-fast-core`, `checks-fast-contracts-channels`, `checks-node-extensions`, `checks-node-core-test`, yalnızca PR için `extension-fast`, `checks`, `checks-windows`, `macos-node`, `macos-swift` ve `android`.
|
||||
3. `build-artifacts`, hızlı Linux hatlarıyla çakışacak şekilde çalışır, böylece aşağı akış tüketicileri paylaşılan build hazır olur olmaz başlayabilir.
|
||||
4. Daha ağır platform ve çalışma zamanı hatları bundan sonra dağıtılır: `checks-fast-core`, `checks-fast-contracts-channels`, `checks-node-extensions`, `checks-node-core-test`, yalnızca PR için `extension-fast`, `checks`, `checks-windows`, `macos-node`, `macos-swift` ve `android`.
|
||||
|
||||
Kapsam mantığı `scripts/ci-changed-scope.mjs` içinde yer alır ve `src/scripts/ci-changed-scope.test.ts` içindeki birim testleriyle kapsanır.
|
||||
CI iş akışı düzenlemeleri Node CI grafiğini ve iş akışı lint'ini doğrular, ancak tek başlarına Windows, Android veya macOS yerel derlemelerini zorlamaz; bu platform şeritleri platform kaynak değişikliklerine göre kapsamlandırılmış kalır.
|
||||
Windows Node kontrolleri; Windows'a özgü süreç/yol sarmalayıcıları, npm/pnpm/UI runner yardımcıları, package manager yapılandırması ve bu şeridi çalıştıran CI iş akışı yüzeyleriyle kapsamlandırılır; ilgisiz kaynak, Plugin, install-smoke ve yalnızca test değişiklikleri normal test shard'ları tarafından zaten çalıştırılan kapsam için 16-vCPU'lu bir Windows worker ayırmamak adına Linux Node şeritlerinde kalır.
|
||||
Ayrı `install-smoke` iş akışı, kendi `preflight` işi üzerinden aynı kapsam betiğini yeniden kullanır. Daha dar changed-smoke sinyalinden `run_install_smoke` değerini hesaplar; böylece Docker/install smoke, install, paketleme, container ile ilgili değişiklikler, paketle gelen extension üretim değişiklikleri ve Docker smoke işlerinin çalıştırdığı çekirdek Plugin/kanal/gateway/Plugin SDK yüzeyleri için çalışır. Yalnızca test ve yalnızca docs düzenlemeleri Docker worker'larını ayırmaz. QR paket smoke testi, BuildKit pnpm store önbelleğini korurken Docker `pnpm install` katmanını yeniden çalışmaya zorlar; böylece her çalıştırmada bağımlılıkları yeniden indirmeden kurulumu yine de test eder. Gateway-network e2e, işin başında daha önce derlenmiş çalışma zamanı imajını yeniden kullanır; böylece bir Docker derlemesi daha eklemeden gerçek container-container WebSocket kapsamı ekler. Yerel `test:docker:all`, paylaşılan tek bir `scripts/e2e/Dockerfile` built-app imajını önceden derler ve bunu E2E container smoke runner'ları arasında yeniden kullanır; yeniden kullanılabilir canlı/E2E iş akışı da Docker matrisi öncesinde tek bir SHA etiketli GHCR Docker E2E imajı derleyip göndererek ve ardından matrisi `OPENCLAW_SKIP_DOCKER_BUILD=1` ile çalıştırarak bu deseni yansıtır. QR ve installer Docker testleri kendi kuruluma odaklı Dockerfile'larını korur. Ayrı bir `docker-e2e-fast` işi, sınırlandırılmış paketle gelen Plugin Docker profilini 120 saniyelik komut zaman aşımı altında çalıştırır: setup-entry bağımlılık onarımı artı sentetik bundled-loader arıza yalıtımı. Tam paketle gelen güncelleme/kanal matrisi manuel/tam paket olarak kalır; çünkü gerçek npm update ve doctor repair geçişlerini tekrar tekrar uygular.
|
||||
Kapsam mantığı `scripts/ci-changed-scope.mjs` içinde bulunur ve `src/scripts/ci-changed-scope.test.ts` içindeki birim testleriyle kapsanır.
|
||||
CI iş akışı düzenlemeleri Node CI grafiğini ve iş akışı lint denetimini doğrular, ancak tek başına Windows, Android veya macOS yerel build'lerini zorlamaz; bu platform hatları platform kaynak değişikliklerine göre kapsamlı kalır.
|
||||
Windows Node kontrolleri, Windows'a özgü işlem/yol sarmalayıcılarına, npm/pnpm/UI çalıştırıcı yardımcılarına, paket yöneticisi yapılandırmasına ve bu hattı çalıştıran CI iş akışı yüzeylerine göre kapsamlandırılır; ilgisiz kaynak, eklenti, install-smoke ve yalnızca test değişiklikleri Linux Node hatlarında kalır, böylece normal test shard'ları tarafından zaten kullanılan kapsam için 16-vCPU'lu bir Windows worker ayrılmaz.
|
||||
Ayrı `install-smoke` iş akışı aynı kapsam betiğini kendi `preflight` işi üzerinden yeniden kullanır. `run_install_smoke` değerini daha dar changed-smoke sinyalinden hesaplar; böylece Docker/install smoke, kurulum, paketleme, container ile ilgili değişiklikler, bundled extension üretim değişiklikleri ve Docker smoke işlerinin kullandığı çekirdek plugin/channel/gateway/Plugin SDK yüzeyleri için çalışır. Yalnızca test ve yalnızca dokümantasyon düzenlemeleri Docker worker'ları ayırmaz. QR paket smoke testi, Docker `pnpm install` katmanını yeniden çalışmaya zorlar ve BuildKit pnpm store önbelleğini korur; böylece her çalıştırmada bağımlılıkları yeniden indirmeden kurulumu yine de test eder. gateway-network e2e, işin başında oluşturulan çalışma zamanı imajını yeniden kullanır; böylece başka bir Docker build eklemeden gerçek container-to-container WebSocket kapsamı ekler. Yerel `test:docker:all`, paylaşılan bir canlı test imajını ve paylaşılan bir `scripts/e2e/Dockerfile` built-app imajını önceden derler, ardından canlı/E2E smoke hatlarını `OPENCLAW_SKIP_DOCKER_BUILD=1` ile paralel çalıştırır; varsayılan 4 eşzamanlılığını `OPENCLAW_DOCKER_ALL_PARALLELISM` ile ayarlayın. Yerel toplu çalıştırma, varsayılan olarak ilk başarısızlıktan sonra yeni havuzlanmış hatları zamanlamayı durdurur ve her hattın `OPENCLAW_DOCKER_ALL_LANE_TIMEOUT_MS` ile geçersiz kılınabilen 120 dakikalık bir zaman aşımı vardır. Başlangıca veya sağlayıcıya duyarlı hatlar paralel havuzdan sonra özel olarak çalışır. Yeniden kullanılabilir canlı/E2E iş akışı, Docker matrisinden önce SHA etiketli tek bir GHCR Docker E2E imajı oluşturup göndererek paylaşılan imaj modelini yansıtır, ardından matrisi `OPENCLAW_SKIP_DOCKER_BUILD=1` ile çalıştırır. Zamanlanmış canlı/E2E iş akışı, tam sürüm yolundaki Docker paketini her gün çalıştırır. QR ve yükleyici Docker testleri kendi kurulum odaklı Dockerfile'larını korur. Ayrı bir `docker-e2e-fast` işi, 120 saniyelik komut zaman aşımı altında sınırlı bundled-plugin Docker profilini çalıştırır: setup-entry bağımlılık onarımı artı sentetik bundled-loader başarısızlık izolasyonu. Tam bundled update/channel matrisi manuel/tam paket olarak kalır çünkü tekrar eden gerçek npm update ve doctor repair geçişleri yapar.
|
||||
|
||||
Yerel changed-lane mantığı `scripts/changed-lanes.mjs` içinde yer alır ve `scripts/check-changed.mjs` tarafından yürütülür. Bu yerel geçit, geniş CI platform kapsamına göre mimari sınırlar konusunda daha katıdır: çekirdek üretim değişiklikleri çekirdek prod typecheck artı çekirdek testlerini çalıştırır, yalnızca çekirdek test değişiklikleri yalnızca çekirdek test typecheck/testlerini çalıştırır, extension üretim değişiklikleri extension prod typecheck artı extension testlerini çalıştırır ve yalnızca extension test değişiklikleri yalnızca extension test typecheck/testlerini çalıştırır. Herkese açık Plugin SDK veya plugin-contract değişiklikleri, extension'lar bu çekirdek sözleşmelere bağlı olduğu için extension doğrulamasını genişletir. Yalnızca sürüm meta verisi içeren version bump'lar hedefli sürüm/yapılandırma/kök bağımlılık kontrolleri çalıştırır. Bilinmeyen kök/yapılandırma değişiklikleri güvenli tarafta kalmak için tüm şeritlere başarısız olur.
|
||||
Yerel changed-lane mantığı `scripts/changed-lanes.mjs` içinde bulunur ve `scripts/check-changed.mjs` tarafından çalıştırılır. Bu yerel geçit, geniş CI platform kapsamına kıyasla mimari sınırlar konusunda daha katıdır: çekirdek üretim değişiklikleri çekirdek prod typecheck artı çekirdek testlerini çalıştırır, çekirdek yalnızca test değişiklikleri yalnızca çekirdek test typecheck/testlerini çalıştırır, eklenti üretim değişiklikleri eklenti prod typecheck artı eklenti testlerini çalıştırır ve eklenti yalnızca test değişiklikleri yalnızca eklenti test typecheck/testlerini çalıştırır. Herkese açık Plugin SDK veya plugin-contract değişiklikleri, eklenti doğrulamasını genişletir çünkü eklentiler bu çekirdek sözleşmelere bağımlıdır. Yalnızca sürüm metaverisi içeren version bump'ları hedefli sürüm/yapılandırma/kök bağımlılık kontrollerini çalıştırır. Bilinmeyen root/config değişiklikleri güvenli olacak şekilde tüm hatlara başarısız olur.
|
||||
|
||||
Push işlemlerinde `checks` matrisi yalnızca push için `compat-node22` şeridini ekler. Pull request'lerde bu şerit atlanır ve matris normal test/kanal şeritlerine odaklı kalır.
|
||||
Push işlemlerinde `checks` matrisi yalnızca push için olan `compat-node22` hattını ekler. Pull request'lerde bu hat atlanır ve matris normal test/kanal hatlarına odaklı kalır.
|
||||
|
||||
En yavaş Node test aileleri, her iş küçük kalacak şekilde bölünür veya dengelenir: kanal sözleşmeleri kayıt ve çekirdek kapsamını toplam altı ağırlıklı shard'a böler, paketle gelen Plugin testleri altı extension worker arasında dengelenir, auto-reply altı küçük worker yerine üç dengeli worker olarak çalışır ve agentic gateway/plugin yapılandırmaları yerleşik artifact'leri beklemek yerine mevcut yalnızca kaynak agentic Node işlerine dağıtılır. Geniş tarayıcı, QA, medya ve çeşitli Plugin testleri paylaşılan plugin catch-all yerine kendilerine özel Vitest yapılandırmalarını kullanır. Geniş agents şeridi, tek bir yavaş test dosyasına ait olmaktan çok import/zamanlama ağırlıklı olduğu için paylaşılan Vitest dosya paralel zamanlayıcısını kullanır. `runtime-config`, paylaşılan çalışma zamanı shard'ının kuyruğu sahiplenmesini önlemek için infra core-runtime shard'ı ile birlikte çalışır. `check-additional`, package-boundary derleme/canary işlerini birlikte tutar ve çalışma zamanı topolojisi mimarisini gateway watch kapsamından ayırır; boundary guard shard'ı küçük bağımsız guard'larını tek iş içinde eşzamanlı çalıştırır. Gateway watch, kanal testleri ve çekirdek support-boundary shard'ı, `dist/` ve `dist-runtime/` zaten derlendikten sonra `build-artifacts` içinde eşzamanlı çalışır; eski kontrol adlarını hafif doğrulayıcı işler olarak korurken iki ek Blacksmith worker'ı ve ikinci bir artifact-consumer kuyruğunu önler.
|
||||
Android CI, hem `testPlayDebugUnitTest` hem de `testThirdPartyDebugUnitTest` çalıştırır, ardından Play debug APK'sını derler. Third-party flavor'ın ayrı bir kaynak kümesi veya manifest'i yoktur; birim test şeridi yine de bu flavor'ı SMS/call-log BuildConfig bayraklarıyla derlerken her Android ile ilgili push'ta yinelenen bir debug APK paketleme işinden kaçınır.
|
||||
`extension-fast` yalnızca PR içindir; çünkü push çalıştırmaları zaten tam paketle gelen Plugin shard'larını yürütür. Bu, `main` üzerinde `checks-node-extensions` içinde zaten bulunan kapsam için ek bir Blacksmith worker ayırmadan incelemeler için değişen Plugin geri bildirimi sağlar.
|
||||
En yavaş Node test aileleri, her iş küçük kalsın diye bölünür veya dengelenir: kanal sözleşmeleri, registry ve çekirdek kapsamı toplam altı ağırlıklı shard'a böler, bundled plugin testleri altı eklenti worker'ı arasında dengelenir, auto-reply altı küçük worker yerine üç dengeli worker olarak çalışır ve agentic gateway/plugin yapılandırmaları derlenmiş artifact'leri beklemek yerine mevcut yalnızca kaynak agentic Node işlerine dağıtılır. Geniş browser, QA, medya ve çeşitli eklenti testleri, paylaşılan eklenti genel amaçlı yapılandırma yerine özel Vitest yapılandırmalarını kullanır. Geniş agents hattı, tek bir yavaş test dosyasına ait olmak yerine import/zamanlama ağırlıklı olduğu için paylaşılan Vitest dosya-paralel zamanlayıcısını kullanır. `runtime-config`, paylaşılan çalışma zamanı shard'ının kuyruğun sonunu sahiplenmesini önlemek için infra core-runtime shard'ı ile çalışır. `check-additional`, package-boundary derleme/canary işlerini birlikte tutar ve çalışma zamanı topolojisi mimarisini gateway watch kapsamından ayırır; boundary guard shard'ı küçük bağımsız guard'larını tek bir iş içinde eşzamanlı çalıştırır. Gateway watch, kanal testleri ve çekirdek support-boundary shard'ı, `dist/` ve `dist-runtime/` zaten derlendikten sonra `build-artifacts` içinde eşzamanlı çalışır; böylece iki ek Blacksmith worker'ı ve ikinci bir artifact-consumer kuyruğu oluşturmadan eski kontrol adlarını hafif doğrulayıcı işler olarak korur.
|
||||
Android CI, hem `testPlayDebugUnitTest` hem de `testThirdPartyDebugUnitTest` çalıştırır, ardından Play debug APK'sını derler. third-party flavor için ayrı bir kaynak kümesi veya manifest yoktur; birim test hattı yine de bu flavor'ı SMS/call-log BuildConfig bayraklarıyla derler, aynı zamanda Android ile ilgili her push'ta yinelenen bir debug APK paketleme işinden kaçınır.
|
||||
`extension-fast` yalnızca PR içindir çünkü push çalıştırmaları zaten tam bundled plugin shard'larını yürütür. Bu, `checks-node-extensions` içinde zaten bulunan kapsam için `main` üzerinde ek bir Blacksmith worker ayırmadan incelemeler için değişen eklenti geri bildirimi sağlar.
|
||||
|
||||
GitHub, aynı PR veya `main` referansına daha yeni bir push geldiğinde yerine geçen işleri `cancelled` olarak işaretleyebilir. Aynı referans için en yeni çalışma da başarısız olmadığı sürece bunu CI gürültüsü olarak değerlendirin. Toplu shard kontrolleri `!cancelled() && always()` kullanır; böylece normal shard arızalarını yine de raporlarlar ancak tüm iş akışı zaten yerini yenisine bıraktıktan sonra kuyruğa girmezler.
|
||||
CI eşzamanlılık anahtarı sürümlüdür (`CI-v7-*`); böylece eski bir kuyruk grubundaki GitHub tarafı zombi bir iş, daha yeni main çalıştırmalarını süresiz olarak engelleyemez.
|
||||
GitHub, aynı PR veya `main` referansına daha yeni bir push geldiğinde yerini alan işleri `cancelled` olarak işaretleyebilir. Aynı referans için en yeni çalıştırma da başarısız olmuyorsa bunu CI gürültüsü olarak değerlendirin. Toplu shard kontrolleri `!cancelled() && always()` kullanır, böylece normal shard hatalarını yine bildirirler ancak tüm iş akışı zaten yerini almışsa kuyruğa girmezler.
|
||||
CI eşzamanlılık anahtarı sürümlüdür (`CI-v7-*`); böylece eski bir kuyruk grubundaki GitHub taraflı bir zombi, daha yeni main çalıştırmalarını süresiz olarak engelleyemez.
|
||||
|
||||
## Runner'lar
|
||||
## Çalıştırıcılar
|
||||
|
||||
| Runner | İşler |
|
||||
| -------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ubuntu-24.04` | `preflight`, hızlı güvenlik işleri ve toplamaları (`security-scm-fast`, `security-dependency-audit`, `security-fast`), hızlı protocol/contract/paketle gelen kontroller, shard'lanmış kanal sözleşmesi kontrolleri, lint dışındaki `check` shard'ları, `check-additional` shard'ları ve toplamaları, Node test toplu doğrulayıcıları, docs kontrolleri, Python Skills, workflow-sanity, labeler, auto-response; install-smoke preflight da GitHub tarafından barındırılan Ubuntu kullanır, böylece Blacksmith matrisi daha erken kuyruğa girebilir |
|
||||
| `blacksmith-8vcpu-ubuntu-2404` | `build-artifacts`, build-smoke, Linux Node test shard'ları, paketle gelen Plugin test shard'ları, `android` |
|
||||
| `blacksmith-16vcpu-ubuntu-2404` | `check-lint`; bu iş CPU'ya yeterince duyarlı kaldığından 8 vCPU tasarruf ettiğinden daha fazlasına mal oldu; 32-vCPU kuyruk süresi tasarruf ettiğinden daha pahalı olduğu için install-smoke Docker derlemeleri |
|
||||
| `blacksmith-16vcpu-windows-2025` | `checks-windows` |
|
||||
| `blacksmith-6vcpu-macos-latest` | `openclaw/openclaw` üzerinde `macos-node`; fork'lar `macos-latest` değerine geri döner |
|
||||
| `blacksmith-12vcpu-macos-latest` | `openclaw/openclaw` üzerinde `macos-swift`; fork'lar `macos-latest` değerine geri döner |
|
||||
| Çalıştırıcı | İşler |
|
||||
| -------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
|
||||
| `ubuntu-24.04` | `preflight`, hızlı güvenlik işleri ve toplu işler (`security-scm-fast`, `security-dependency-audit`, `security-fast`), hızlı protocol/contract/bundled kontrolleri, shard'lanmış kanal sözleşme kontrolleri, lint dışındaki `check` shard'ları, `check-additional` shard'ları ve toplu işleri, Node test toplu doğrulayıcıları, dokümantasyon kontrolleri, Python Skills, workflow-sanity, labeler, auto-response; install-smoke preflight da GitHub barındırmalı Ubuntu kullanır, böylece Blacksmith matrisi daha erken kuyruğa girebilir |
|
||||
| `blacksmith-8vcpu-ubuntu-2404` | `build-artifacts`, build-smoke, Linux Node test shard'ları, bundled plugin test shard'ları, `android` |
|
||||
| `blacksmith-16vcpu-ubuntu-2404` | `check-lint`; bu iş hâlâ CPU'ya yeterince duyarlıdır ve 8 vCPU tasarruf ettirdiğinden daha fazla maliyet yaratmıştır; install-smoke Docker build'leri, burada 32-vCPU kuyruk süresi tasarruf ettirdiğinden daha fazla maliyet yaratmıştır |
|
||||
| `blacksmith-16vcpu-windows-2025` | `checks-windows` |
|
||||
| `blacksmith-6vcpu-macos-latest` | `openclaw/openclaw` üzerinde `macos-node`; fork'lar `macos-latest` değerine geri döner |
|
||||
| `blacksmith-12vcpu-macos-latest` | `openclaw/openclaw` üzerinde `macos-swift`; fork'lar `macos-latest` değerine geri döner |
|
||||
|
||||
## Yerel Eşdeğerler
|
||||
|
||||
```bash
|
||||
pnpm changed:lanes # origin/main...HEAD için yerel changed-lane sınıflandırıcısını inceleyin
|
||||
pnpm check:changed # akıllı yerel geçit: sınır şeridine göre changed typecheck/lint/testler
|
||||
pnpm check # hızlı yerel geçit: üretim tsgo + shard'lanmış lint + paralel hızlı guard'lar
|
||||
pnpm check:changed # akıllı yerel geçit: sınır hattına göre değişen typecheck/lint/testler
|
||||
pnpm check # hızlı yerel geçit: production tsgo + shard'lanmış lint + paralel hızlı guard'lar
|
||||
pnpm check:test-types
|
||||
pnpm check:timed # aynı geçit, aşama başına zamanlamalarla
|
||||
pnpm check:timed # aşama başına zamanlamalarla aynı geçit
|
||||
pnpm build:strict-smoke
|
||||
pnpm check:architecture
|
||||
pnpm test:gateway:watch-regression
|
||||
pnpm test # Vitest testleri
|
||||
pnpm test:channels
|
||||
pnpm test:contracts:channels
|
||||
pnpm check:docs # docs biçimlendirme + lint + bozuk bağlantılar
|
||||
pnpm build # CI artifact/build-smoke şeritleri önemliyse dist derlemesi
|
||||
node scripts/ci-run-timings.mjs <run-id> # duvar süresini, kuyruk süresini ve en yavaş işleri özetler
|
||||
pnpm check:docs # dokümantasyon biçimlendirme + lint + bozuk bağlantılar
|
||||
pnpm build # CI artifact/build-smoke hatları önemliyse dist build'i
|
||||
node scripts/ci-run-timings.mjs <run-id> # toplam süreyi, kuyruk süresini ve en yavaş işleri özetleyin
|
||||
```
|
||||
|
||||
@ -1,14 +1,14 @@
|
||||
---
|
||||
read_when:
|
||||
- Kanal sağlığı + son oturum alıcıları için hızlı bir tanı istiyorsunuz
|
||||
- Hata ayıklama için yapıştırılabilir bir “all” durumu istiyorsunuz
|
||||
summary: '`openclaw status` için CLI başvurusu (tanılama, yoklamalar, kullanım anlık görüntüleri)'
|
||||
title: status
|
||||
- Kanal sağlığı ve son oturum alıcıları hakkında hızlı bir tanılama istiyorsunuz.
|
||||
- Hata ayıklama için yapıştırılabilir bir “all” durumu istiyorsunuz.
|
||||
summary: '`openclaw status` için CLI başvurusu (tanılama, problar, kullanım anlık görüntüleri)'
|
||||
title: durum
|
||||
x-i18n:
|
||||
generated_at: "2026-04-05T13:49:28Z"
|
||||
generated_at: "2026-04-23T13:57:59Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: fbe9d94fbe9938cd946ee6f293b5bd3b464b75e1ade2eacdd851788c3bffe94e
|
||||
source_hash: 015614e329ec172a62c625581897fa64589f12dfe28edefe8a2764b5b5367b2a
|
||||
source_path: cli/status.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -26,17 +26,18 @@ openclaw status --usage
|
||||
|
||||
Notlar:
|
||||
|
||||
- `--deep` canlı yoklamalar çalıştırır (WhatsApp Web + Telegram + Discord + Slack + Signal).
|
||||
- `--usage`, normalize edilmiş sağlayıcı kullanım pencerelerini `X% left` olarak yazdırır.
|
||||
- MiniMax'ın ham `usage_percent` / `usagePercent` alanları kalan kotadır, bu nedenle OpenClaw bunları görüntülemeden önce tersine çevirir; mevcut olduğunda sayı tabanlı alanlar önceliklidir. `model_remains` yanıtları sohbet modeli girdisini tercih eder, gerektiğinde zaman penceresi etiketini zaman damgalarından türetir ve plan etiketine model adını dahil eder.
|
||||
- Geçerli oturum anlık görüntüsü seyrek olduğunda `/status`, token ve önbellek sayaçlarını en son transcript kullanım günlüğünden geri doldurabilir. Mevcut sıfır olmayan canlı değerler yine transcript yedek değerlerine üstün gelir.
|
||||
- Transcript yedeği, canlı oturum girdisinde eksik olduğunda etkin çalışma zamanı modeli etiketini de kurtarabilir. Bu transcript modeli seçilen modelden farklıysa status, bağlam penceresini seçilen model yerine kurtarılan çalışma zamanı modeline göre çözümler.
|
||||
- Prompt boyutu muhasebesi için transcript yedeği, oturum meta verileri eksik veya daha küçük olduğunda daha büyük prompt odaklı toplamı tercih eder; böylece özel sağlayıcı oturumları `0` token görüntülerine düşmez.
|
||||
- Çıktı, birden çok ajan yapılandırıldığında ajan başına oturum depolarını içerir.
|
||||
- Genel bakış, mevcut olduğunda Gateway + düğüm ana makine hizmet kurulum/çalışma durumu bilgilerini içerir.
|
||||
- Genel bakış, güncelleme kanalı + git SHA bilgisini içerir (kaynak checkout'lar için).
|
||||
- Güncelleme bilgisi Genel Bakış'ta gösterilir; bir güncelleme varsa status, `openclaw update` çalıştırmak için bir ipucu yazdırır (bkz. [Güncelleme](/install/updating)).
|
||||
- Salt okunur status yüzeyleri (`status`, `status --json`, `status --all`), mümkün olduğunda hedeflenen yapılandırma yolları için desteklenen SecretRef'leri çözümler.
|
||||
- Desteklenen bir kanal SecretRef'i yapılandırılmış ancak mevcut komut yolunda kullanılamıyorsa status salt okunur kalır ve çökmek yerine bozulmuş çıktı bildirir. İnsan tarafından okunabilir çıktı “configured token unavailable in this command path” gibi uyarılar gösterir ve JSON çıktısı `secretDiagnostics` içerir.
|
||||
- Komut yerel SecretRef çözümlemesi başarılı olduğunda status çözümlenmiş anlık görüntüyü tercih eder ve son çıktıdan geçici “secret unavailable” kanal işaretlerini temizler.
|
||||
- `status --all`, bir Secrets genel bakış satırı ve rapor üretimini durdurmadan gizli tanılamalarını özetleyen (okunabilirlik için kısaltılmış) bir tanı bölümü içerir.
|
||||
- `--deep` canlı probları çalıştırır (WhatsApp Web + Telegram + Discord + Slack + Signal).
|
||||
- `--usage`, normalize edilmiş sağlayıcı kullanım pencerelerini `X% kaldı` olarak yazdırır.
|
||||
- Oturum durumu çıktısı artık `Runtime:` ile `Runner:` alanlarını ayırır. `Runtime`, yürütme yolunu ve sandbox durumunu gösterir (`direct`, `docker/*`), `Runner` ise oturumun gömülü Pi, CLI destekli bir sağlayıcı ya da `codex (acp/acpx)` gibi ACP harness backend’i kullanıp kullanmadığını belirtir.
|
||||
- MiniMax’in ham `usage_percent` / `usagePercent` alanları kalan kotayı gösterir; bu nedenle OpenClaw görüntülemeden önce bunları tersine çevirir. Mevcut olduğunda sayı tabanlı alanlar önceliklidir. `model_remains` yanıtları sohbet modeli girdisini tercih eder, gerektiğinde pencere etiketini zaman damgalarından türetir ve plan etiketine model adını ekler.
|
||||
- Geçerli oturum anlık görüntüsü seyrek olduğunda, `/status` en son transkript kullanım günlüğünden token ve önbellek sayaçlarını geri doldurabilir. Mevcut sıfır olmayan canlı değerler yine transkript yedek değerlerine göre önceliklidir.
|
||||
- Transkript yedeği, canlı oturum girdisinde eksik olduğunda etkin çalışma zamanı model etiketini de geri getirebilir. Bu transkript modeli seçili modelden farklıysa, durum bağlam penceresini seçili model yerine geri getirilen çalışma zamanı modeline göre çözümler.
|
||||
- İstem boyutu muhasebesi için, oturum meta verisi eksikse veya daha küçükse transkript yedeği istem odaklı daha büyük toplamı tercih eder; böylece özel sağlayıcı oturumları `0` token gösterimine düşmez.
|
||||
- Çıktı, birden fazla aracı yapılandırıldığında aracı başına oturum depolarını içerir.
|
||||
- Genel bakış, mevcut olduğunda Gateway + Node ana makine hizmeti kurulum/çalışma durumu bilgilerini içerir.
|
||||
- Genel bakış, güncelleme kanalını + git SHA’sını içerir (kaynak kod checkout’ları için).
|
||||
- Güncelleme bilgisi Genel Bakış’ta gösterilir; bir güncelleme mevcutsa status, `openclaw update` çalıştırmanız için bir ipucu yazdırır (bkz. [Güncelleme](/tr/install/updating)).
|
||||
- Salt okunur durum yüzeyleri (`status`, `status --json`, `status --all`), mümkün olduğunda hedeflenen yapılandırma yolları için desteklenen SecretRef’leri çözümler.
|
||||
- Desteklenen bir kanal SecretRef’i yapılandırılmış ancak mevcut komut yolunda kullanılamıyorsa, status salt okunur kalır ve çökmek yerine bozulmuş çıktıyı bildirir. İnsan tarafından okunabilir çıktı “configured token unavailable in this command path” gibi uyarılar gösterir, JSON çıktısı ise `secretDiagnostics` içerir.
|
||||
- Komuta yerel SecretRef çözümlemesi başarılı olduğunda, status çözülmüş anlık görüntüyü tercih eder ve son çıktıdan geçici “secret unavailable” kanal işaretlerini temizler.
|
||||
- `status --all`, bir Secrets genel bakış satırı ve rapor oluşturmayı durdurmadan gizli tanılamayı özetleyen bir tanılama bölümü içerir (okunabilirlik için kısaltılmıştır).
|
||||
|
||||
@ -1,37 +1,37 @@
|
||||
---
|
||||
read_when:
|
||||
- qa-lab veya qa-channel’ı genişletme
|
||||
- qa-lab veya qa-channel genişletme
|
||||
- Depo destekli QA senaryoları ekleme
|
||||
- Gateway panosu etrafında daha yüksek gerçekçiliğe sahip QA otomasyonu oluşturma
|
||||
summary: qa-lab, qa-channel, tohumlu senaryolar ve protokol raporları için özel QA otomasyon yapısı
|
||||
title: QA Uçtan Uca Otomasyonu
|
||||
summary: qa-lab, qa-channel, önceden hazırlanmış senaryolar ve protokol raporları için özel QA otomasyonu yapısı
|
||||
title: QA uçtan uca otomasyonu
|
||||
x-i18n:
|
||||
generated_at: "2026-04-20T09:03:04Z"
|
||||
generated_at: "2026-04-23T13:58:00Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 34245ce871356caeab0d9e0eeeaa9fb4e408920a4a97ad27567fa365d8db17c7
|
||||
source_hash: a967a74d2e70b042e9443c5ec954902b820d2e5a22cbecd9be74af13b9085553
|
||||
source_path: concepts/qa-e2e-automation.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# QA Uçtan Uca Otomasyonu
|
||||
|
||||
Özel QA yığını, OpenClaw’ı tek birim testinin yapabileceğinden daha gerçekçi,
|
||||
Özel QA yığını, OpenClaw’ı tek bir birim testinin yapabileceğinden daha gerçekçi,
|
||||
kanal biçimli bir şekilde çalıştırmak için tasarlanmıştır.
|
||||
|
||||
Mevcut parçalar:
|
||||
|
||||
- `extensions/qa-channel`: DM, kanal, ileti dizisi,
|
||||
tepki, düzenleme ve silme yüzeylerine sahip sentetik mesaj kanalı.
|
||||
- `extensions/qa-lab`: transkripti gözlemlemek,
|
||||
gelen mesajları enjekte etmek ve bir Markdown raporu dışa aktarmak için hata ayıklayıcı arayüzü ve QA veri yolu.
|
||||
- `extensions/qa-channel`: DM, kanal, ileti dizisi, tepki,
|
||||
düzenleme ve silme yüzeylerine sahip sentetik mesaj kanalı.
|
||||
- `extensions/qa-lab`: dökümü gözlemlemek,
|
||||
gelen mesajları enjekte etmek ve bir Markdown raporu dışa aktarmak için hata ayıklayıcı UI’si ve QA veri yolu.
|
||||
- `qa/`: başlangıç görevi ve temel QA
|
||||
senaryoları için depo destekli tohum varlıklar.
|
||||
|
||||
Mevcut QA operatörü akışı iki panelli bir QA sitesidir:
|
||||
|
||||
- Sol: aracıyla birlikte Gateway panosu (Control UI).
|
||||
- Sağ: Slack benzeri transkripti ve senaryo planını gösteren QA Lab.
|
||||
- Sol: ajanla birlikte Gateway panosu (Kontrol UI’si).
|
||||
- Sağ: Slack benzeri dökümü ve senaryo planını gösteren QA Lab.
|
||||
|
||||
Bunu şu komutla çalıştırın:
|
||||
|
||||
@ -40,12 +40,12 @@ pnpm qa:lab:up
|
||||
```
|
||||
|
||||
Bu, QA sitesini derler, Docker destekli gateway hattını başlatır ve
|
||||
bir operatörün veya otomasyon döngüsünün aracıya bir QA
|
||||
bir operatörün veya otomasyon döngüsünün ajana bir QA
|
||||
görevi verebildiği, gerçek kanal davranışını gözlemleyebildiği ve neyin işe yaradığını,
|
||||
neyin başarısız olduğunu veya neyin engelli kaldığını kaydedebildiği QA Lab sayfasını açığa çıkarır.
|
||||
|
||||
Docker imajını her seferinde yeniden derlemeden daha hızlı QA Lab UI yinelemesi için,
|
||||
yığını bağlama ile bağlanmış bir QA Lab paketiyle başlatın:
|
||||
Docker imajını her seferinde yeniden derlemeden daha hızlı QA Lab UI geliştirmesi için,
|
||||
yığını bind-mount edilen bir QA Lab paketiyle başlatın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa docker-build-image
|
||||
@ -55,108 +55,109 @@ pnpm qa:lab:watch
|
||||
```
|
||||
|
||||
`qa:lab:up:fast`, Docker servislerini önceden derlenmiş bir imaj üzerinde tutar ve
|
||||
`extensions/qa-lab/web/dist` dizinini `qa-lab` konteynerine bağlama ile bağlar. `qa:lab:watch`
|
||||
bu paketi değişikliklerde yeniden derler ve QA Lab
|
||||
varlık karması değiştiğinde tarayıcı otomatik olarak yeniden yüklenir.
|
||||
`extensions/qa-lab/web/dist` dizinini `qa-lab` konteynerine bind-mount eder. `qa:lab:watch`
|
||||
bu paketi değişiklik olduğunda yeniden derler ve QA Lab varlık karması değiştiğinde
|
||||
tarayıcı otomatik olarak yeniden yüklenir.
|
||||
|
||||
Taşıma katmanında gerçek bir Matrix smoke hattı için şunu çalıştırın:
|
||||
Taşıma katmanı açısından gerçek bir Matrix duman testi hattı için şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa matrix
|
||||
```
|
||||
|
||||
Bu hat, Docker içinde tek kullanımlık bir Tuwunel homeserver sağlar,
|
||||
geçici sürücü, SUT ve gözlemci kullanıcılarını kaydeder, bir özel oda oluşturur,
|
||||
ardından gerçek Matrix Plugin’i bir QA gateway alt süreci içinde çalıştırır. Canlı taşıma hattı,
|
||||
alt süreç yapılandırmasını test edilen taşıma ile sınırlı tutar; böylece Matrix,
|
||||
Bu hat, Docker içinde atılabilir bir Tuwunel homeserver kurar, geçici
|
||||
sürücü, SUT ve gözlemci kullanıcılarını kaydeder, bir özel oda oluşturur, ardından
|
||||
gerçek Matrix plugin’ini bir QA gateway alt süreci içinde çalıştırır. Canlı taşıma hattı,
|
||||
alt süreç yapılandırmasını test edilen taşımayla sınırlı tutar; bu nedenle Matrix,
|
||||
alt süreç yapılandırmasında `qa-channel` olmadan çalışır. Yapılandırılmış rapor çıktılarını ve
|
||||
birleşik stdout/stderr günlüğünü seçilen Matrix QA çıktı dizinine yazar. Dıştaki
|
||||
`scripts/run-node.mjs` derleme/başlatıcı çıktısını da yakalamak için
|
||||
`OPENCLAW_RUN_NODE_OUTPUT_LOG=<path>` değerini depo içindeki bir günlük dosyasına ayarlayın.
|
||||
birleştirilmiş stdout/stderr günlüğünü seçilen Matrix QA çıktı dizinine yazar.
|
||||
Dıştaki `scripts/run-node.mjs` derleme/başlatıcı çıktısını da yakalamak için,
|
||||
`OPENCLAW_RUN_NODE_OUTPUT_LOG=<path>` değerini depo içi bir günlük dosyasına ayarlayın.
|
||||
|
||||
Taşıma katmanında gerçek bir Telegram smoke hattı için şunu çalıştırın:
|
||||
Taşıma katmanı açısından gerçek bir Telegram duman testi hattı için şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa telegram
|
||||
```
|
||||
|
||||
Bu hat, tek kullanımlık bir sunucu sağlamak yerine bir gerçek özel Telegram grubunu hedefler.
|
||||
Bu hat, atılabilir bir sunucu kurmak yerine tek bir gerçek özel Telegram grubunu hedefler.
|
||||
`OPENCLAW_QA_TELEGRAM_GROUP_ID`,
|
||||
`OPENCLAW_QA_TELEGRAM_DRIVER_BOT_TOKEN` ve
|
||||
`OPENCLAW_QA_TELEGRAM_SUT_BOT_TOKEN` gerektirir; ayrıca aynı
|
||||
özel grupta iki farklı bot gerekir. SUT botunun bir Telegram kullanıcı adı olmalıdır ve
|
||||
bottan bota gözlem, her iki botta da Bot-to-Bot Communication Mode
|
||||
özelliği `@BotFather` içinde etkinleştirildiğinde en iyi şekilde çalışır.
|
||||
Herhangi bir senaryo başarısız olduğunda komut sıfır olmayan bir kodla çıkar. Başarısız çıkan bir kod olmadan
|
||||
çıktı almak istediğinizde `--allow-failures` kullanın.
|
||||
özel grupta iki farklı bot gerekir. SUT botunun bir Telegram kullanıcı adına sahip olması gerekir ve
|
||||
botlar arası gözlem, her iki botta da
|
||||
`@BotFather` içinde Bot-to-Bot Communication Mode etkin olduğunda en iyi şekilde çalışır.
|
||||
Herhangi bir senaryo başarısız olduğunda komut sıfır olmayan bir çıkış koduyla sonlanır.
|
||||
Başarısız çıkış kodu olmadan çıktı almak istediğinizde `--allow-failures` kullanın.
|
||||
Telegram raporu ve özeti, kanaryadan başlayarak sürücü mesajı
|
||||
gönderme isteğinden gözlemlenen SUT yanıtına kadar her yanıt için RTT’yi içerir.
|
||||
|
||||
Canlı taşıma hatları artık her birinin kendi senaryo listesi biçimini icat etmesi yerine
|
||||
tek ve daha küçük bir sözleşmeyi paylaşır:
|
||||
tek bir daha küçük sözleşmeyi paylaşır:
|
||||
|
||||
`qa-channel`, geniş sentetik ürün davranışı paketidir ve canlı taşıma kapsama matrisinin
|
||||
bir parçası değildir.
|
||||
`qa-channel`, geniş sentetik ürün davranışı paketi olarak kalır ve
|
||||
canlı taşıma kapsam matrisinin parçası değildir.
|
||||
|
||||
| Hat | Canary | Mention gating | Allowlist block | Üst düzey yanıt | Yeniden başlatma sonrası sürdürme | İleti dizisi takibi | İleti dizisi yalıtımı | Tepki gözlemi | Yardım komutu |
|
||||
| -------- | ------ | -------------- | --------------- | --------------- | --------------------------------- | ------------------- | -------------------- | ------------- | ------------- |
|
||||
| Matrix | x | x | x | x | x | x | x | x | |
|
||||
| Telegram | x | | | | | | | | x |
|
||||
| Hat | Kanarya | Mention gating | İzin listesi engeli | Üst düzey yanıt | Yeniden başlatma sonrası sürdürme | İleti dizisi devamı | İleti dizisi yalıtımı | Tepki gözlemi | Yardım komutu |
|
||||
| -------- | ------- | -------------- | ------------------- | --------------- | --------------------------------- | ------------------- | --------------------- | ------------- | ------------- |
|
||||
| Matrix | x | x | x | x | x | x | x | x | |
|
||||
| Telegram | x | | | | | | | | x |
|
||||
|
||||
Bu, `qa-channel`’ı geniş ürün davranışı paketi olarak korurken Matrix,
|
||||
Telegram ve gelecekteki canlı taşıma katmanlarının tek bir açık taşıma-sözleşmesi
|
||||
kontrol listesini paylaşmasını sağlar.
|
||||
Bu, `qa-channel`ı geniş ürün davranışı paketi olarak tutarken Matrix,
|
||||
Telegram ve gelecekteki canlı taşımaların açık bir taşıma sözleşmesi kontrol listesini paylaşmasını sağlar.
|
||||
|
||||
QA yoluna Docker’ı dahil etmeden tek kullanımlık bir Linux VM hattı için şunu çalıştırın:
|
||||
Docker’ı QA yoluna dahil etmeden atılabilir bir Linux VM hattı için şunu çalıştırın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa suite --runner multipass --scenario channel-chat-baseline
|
||||
```
|
||||
|
||||
Bu, yeni bir Multipass konuğunu başlatır, bağımlılıkları kurar, konuğun içinde OpenClaw’ı derler,
|
||||
`qa suite` komutunu çalıştırır, ardından normal QA raporunu ve
|
||||
özeti konuğun içinden ana makinedeki `.artifacts/qa-e2e/...` dizinine geri kopyalar.
|
||||
Bu, yeni bir Multipass konuğu başlatır, bağımlılıkları kurar, OpenClaw’ı konuğun içinde derler,
|
||||
`qa suite` çalıştırır, ardından normal QA raporunu ve
|
||||
özetini ana makinede `.artifacts/qa-e2e/...` içine geri kopyalar.
|
||||
Bu, ana makinedeki `qa suite` ile aynı senaryo seçimi davranışını yeniden kullanır.
|
||||
Ana makine ve Multipass suite çalıştırmaları, varsayılan olarak yalıtılmış gateway worker’ları ile
|
||||
seçilen birden fazla senaryoyu paralel olarak yürütür. `qa-channel` için varsayılan eşzamanlılık 4’tür
|
||||
ve seçilen senaryo sayısıyla sınırlandırılır. Worker sayısını ayarlamak için
|
||||
`--concurrency <count>`, seri yürütme için ise `--concurrency 1` kullanın.
|
||||
Herhangi bir senaryo başarısız olduğunda komut sıfır olmayan bir kodla çıkar. Başarısız çıkan bir kod olmadan
|
||||
çıktı almak istediğinizde `--allow-failures` kullanın.
|
||||
Ana makine ve Multipass paket çalıştırmaları, varsayılan olarak yalıtılmış gateway çalışanlarıyla
|
||||
birden fazla seçili senaryoyu paralel olarak yürütür. `qa-channel` varsayılan olarak
|
||||
4 eşzamanlılığa sahiptir ve seçilen senaryo sayısıyla sınırlandırılır. Çalışan sayısını ayarlamak için
|
||||
`--concurrency <count>` veya seri yürütme için `--concurrency 1` kullanın.
|
||||
Herhangi bir senaryo başarısız olduğunda komut sıfır olmayan bir çıkış koduyla sonlanır.
|
||||
Başarısız çıkış kodu olmadan çıktı almak istediğinizde `--allow-failures` kullanın.
|
||||
Canlı çalıştırmalar, konuk için pratik olan desteklenen QA kimlik doğrulama girdilerini iletir:
|
||||
ortam değişkeni tabanlı sağlayıcı anahtarları, QA canlı sağlayıcı yapılandırma yolu ve
|
||||
mevcutsa `CODEX_HOME`. Konuğun bağlanmış çalışma alanı üzerinden geri yazabilmesi için
|
||||
varsa `CODEX_HOME`. Konuğun bağlanan çalışma alanı üzerinden geri yazabilmesi için
|
||||
`--output-dir` değerini depo kökü altında tutun.
|
||||
|
||||
## Depo destekli tohumlar
|
||||
|
||||
Tohum varlıkları `qa/` içinde bulunur:
|
||||
Tohum varlıklar `qa/` altında bulunur:
|
||||
|
||||
- `qa/scenarios/index.md`
|
||||
- `qa/scenarios/<theme>/*.md`
|
||||
|
||||
Bunlar kasıtlı olarak git içinde tutulur; böylece QA planı hem insanlar hem de
|
||||
aracı tarafından görülebilir.
|
||||
ajan tarafından görünür olur.
|
||||
|
||||
`qa-lab` genel amaçlı bir markdown çalıştırıcısı olarak kalmalıdır. Her senaryo markdown dosyası,
|
||||
tek bir test çalıştırmasının kaynak doğrusu olmalı ve şunları tanımlamalıdır:
|
||||
tek bir test çalıştırmasının doğruluk kaynağıdır ve şunları tanımlamalıdır:
|
||||
|
||||
- senaryo meta verileri
|
||||
- isteğe bağlı kategori, yetenek, hat ve risk meta verileri
|
||||
- doküman ve kod referansları
|
||||
- belge ve kod referansları
|
||||
- isteğe bağlı Plugin gereksinimleri
|
||||
- isteğe bağlı gateway yapılandırma yaması
|
||||
- yürütülebilir `qa-flow`
|
||||
|
||||
`qa-flow`’u destekleyen yeniden kullanılabilir çalışma zamanı yüzeyi,
|
||||
genel ve kesitler arası kalabilir. Örneğin markdown senaryoları,
|
||||
özel durumlu bir çalıştırıcı eklemeden, gömülü Control UI’ı
|
||||
Gateway `browser.request` sınırı üzerinden yöneten tarayıcı tarafı yardımcılarla
|
||||
taşıma tarafı yardımcılarını birleştirebilir.
|
||||
`qa-flow`u destekleyen yeniden kullanılabilir çalışma zamanı yüzeyinin genel amaçlı ve
|
||||
yatay kesen bir yapıda kalmasına izin verilir. Örneğin markdown senaryoları,
|
||||
özel durumlu bir çalıştırıcı eklemeden, gömülü Kontrol UI’sini
|
||||
Gateway `browser.request` bağlantı noktası üzerinden süren tarayıcı tarafı yardımcılarla birlikte
|
||||
taşıma tarafı yardımcıları birleştirebilir.
|
||||
|
||||
Senaryo dosyaları kaynak ağacı klasörüne göre değil, ürün yeteneğine göre gruplanmalıdır.
|
||||
Senaryo dosyaları kaynak ağacı klasörüne göre değil, ürün yeteneğine göre gruplandırılmalıdır.
|
||||
Dosyalar taşındığında senaryo kimliklerini sabit tutun; uygulama izlenebilirliği için
|
||||
`docsRefs` ve `codeRefs` kullanın.
|
||||
|
||||
Temel liste aşağıdakileri kapsayacak kadar geniş kalmalıdır:
|
||||
Temel liste, aşağıdakileri kapsayacak kadar geniş kalmalıdır:
|
||||
|
||||
- DM ve kanal sohbeti
|
||||
- ileti dizisi davranışı
|
||||
@ -164,40 +165,40 @@ Temel liste aşağıdakileri kapsayacak kadar geniş kalmalıdır:
|
||||
- Cron geri çağrıları
|
||||
- bellekten geri çağırma
|
||||
- model değiştirme
|
||||
- alt aracı devri
|
||||
- depoyu okuma ve doküman okuma
|
||||
- alt ajan devri
|
||||
- depo okuma ve belge okuma
|
||||
- Lobster Invaders gibi küçük bir derleme görevi
|
||||
|
||||
## Sağlayıcı sahte hatları
|
||||
|
||||
`qa suite` iki yerel sağlayıcı sahte hattına sahiptir:
|
||||
|
||||
- `mock-openai`, senaryo farkındalığına sahip OpenClaw sahtesidir. Depo destekli QA ve
|
||||
eşdeğerlik kapıları için varsayılan deterministik sahte hat olarak kalır.
|
||||
- `mock-openai`, senaryo farkındalığı olan OpenClaw sahtesidir. Depo destekli QA ve eşlik denetimleri için
|
||||
varsayılan deterministik sahte hat olmaya devam eder.
|
||||
- `aimock`, deneysel protokol,
|
||||
fikstür, kaydet/yeniden oynat ve kaos kapsamı için AIMock destekli bir sağlayıcı sunucusu başlatır.
|
||||
Bu ek niteliğindedir ve `mock-openai` senaryo yönlendiricisinin yerini almaz.
|
||||
fixture, kayıt/yeniden oynatma ve kaos kapsamı için AIMock destekli bir sağlayıcı sunucusu başlatır. Bu ek niteliğindedir ve
|
||||
`mock-openai` senaryo dağıtıcısının yerini almaz.
|
||||
|
||||
Sağlayıcı hattı uygulaması `extensions/qa-lab/src/providers/` altında bulunur.
|
||||
Her sağlayıcı; varsayılanlarına, yerel sunucu başlatmasına, gateway model yapılandırmasına,
|
||||
auth-profile hazırlama gereksinimlerine ve canlı/sahte yetenek işaretlerine sahiptir. Ortak suite ve
|
||||
Her sağlayıcı kendi varsayılanlarına, yerel sunucu başlatmasına, gateway model yapılandırmasına,
|
||||
auth-profile hazırlık gereksinimlerine ve canlı/sahte yetenek işaretlerine sahiptir. Paylaşılan paket ve
|
||||
gateway kodu, sağlayıcı adlarına göre dallanmak yerine sağlayıcı kayıt defteri üzerinden yönlendirme yapmalıdır.
|
||||
|
||||
## Taşıma bağdaştırıcıları
|
||||
|
||||
`qa-lab`, markdown QA senaryoları için genel bir taşıma sınırına sahiptir.
|
||||
`qa-channel`, bu sınırdaki ilk bağdaştırıcıdır; ancak tasarım hedefi daha geniştir:
|
||||
gelecekteki gerçek veya sentetik kanallar, taşıma katmanına özgü bir QA çalıştırıcısı eklemek yerine
|
||||
aynı suite çalıştırıcısına takılabilmelidir.
|
||||
`qa-lab`, markdown QA senaryoları için genel amaçlı bir taşıma bağlantı noktası sahibi olur.
|
||||
`qa-channel` bu bağlantı noktasındaki ilk bağdaştırıcıdır, ancak tasarım hedefi daha geniştir:
|
||||
gelecekteki gerçek veya sentetik kanallar, taşımaya özgü bir QA çalıştırıcısı eklemek yerine
|
||||
aynı paket çalıştırıcısına takılmalıdır.
|
||||
|
||||
Mimari düzeyde ayrım şu şekildedir:
|
||||
Mimari düzeyde ayrım şöyledir:
|
||||
|
||||
- `qa-lab`, genel senaryo yürütme, worker eşzamanlılığı, çıktı yazma ve raporlamadan sorumludur.
|
||||
- taşıma bağdaştırıcısı; gateway yapılandırması, hazır olma durumu, gelen ve giden gözlem, taşıma eylemleri ve normalize edilmiş taşıma durumundan sorumludur.
|
||||
- `qa/scenarios/` altındaki markdown senaryo dosyaları test çalıştırmasını tanımlar; bunları yürüten yeniden kullanılabilir çalışma zamanı yüzeyini `qa-lab` sağlar.
|
||||
- `qa-lab`, genel senaryo yürütme, çalışan eşzamanlılığı, çıktı yazımı ve raporlamanın sahibidir.
|
||||
- taşıma bağdaştırıcısı, gateway yapılandırması, hazır olma durumu, gelen ve giden gözlem, taşıma eylemleri ve normalize edilmiş taşıma durumunun sahibidir.
|
||||
- `qa/scenarios/` altındaki markdown senaryo dosyaları test çalıştırmasını tanımlar; `qa-lab`, bunları yürüten yeniden kullanılabilir çalışma zamanı yüzeyini sağlar.
|
||||
|
||||
Yeni kanal bağdaştırıcıları için bakımcıya yönelik benimseme yönergeleri
|
||||
[Testing](/tr/help/testing#adding-a-channel-to-qa) bölümünde bulunur.
|
||||
Yeni kanal bağdaştırıcıları için bakımcı odaklı benimseme rehberi
|
||||
[Testing](/tr/help/testing#adding-a-channel-to-qa) içinde yer alır.
|
||||
|
||||
## Raporlama
|
||||
|
||||
@ -207,10 +208,10 @@ Rapor şu sorulara yanıt vermelidir:
|
||||
- Ne işe yaradı
|
||||
- Ne başarısız oldu
|
||||
- Ne engelli kaldı
|
||||
- Hangi takip senaryolarını eklemeye değer
|
||||
- Hangi takip senaryolarını eklemek faydalı olur
|
||||
|
||||
Karakter ve üslup kontrolleri için, aynı senaryoyu birden çok canlı model
|
||||
referansı üzerinde çalıştırın ve değerlendirilen bir Markdown raporu yazın:
|
||||
Karakter ve stil kontrolleri için, aynı senaryoyu birden fazla canlı model
|
||||
referansı üzerinde çalıştırın ve değerlendirilmiş bir Markdown raporu yazın:
|
||||
|
||||
```bash
|
||||
pnpm openclaw qa character-eval \
|
||||
@ -230,39 +231,39 @@ pnpm openclaw qa character-eval \
|
||||
```
|
||||
|
||||
Komut, Docker değil, yerel QA gateway alt süreçlerini çalıştırır. Karakter değerlendirme
|
||||
senaryoları kişiliği `SOUL.md` üzerinden ayarlamalı, ardından sohbet,
|
||||
çalışma alanı yardımı ve küçük dosya görevleri gibi sıradan kullanıcı turlarını yürütmelidir. Aday modele
|
||||
değerlendirildiği söylenmemelidir. Komut her tam transkripti korur,
|
||||
senaryoları personayı `SOUL.md` üzerinden ayarlamalı, ardından sohbet, çalışma alanı yardımı
|
||||
ve küçük dosya görevleri gibi sıradan kullanıcı dönüşlerini çalıştırmalıdır. Aday modele
|
||||
değerlendirildiği söylenmemelidir. Komut, her tam dökümü korur,
|
||||
temel çalışma istatistiklerini kaydeder, ardından değerlendirme modellerinden hızlı modda
|
||||
`xhigh` akıl yürütme ile çalıştırmaları doğallık, hava ve mizaha göre sıralamalarını ister.
|
||||
`xhigh` muhakeme ile doğal olma, hava ve mizaha göre çalıştırmaları sıralamalarını ister.
|
||||
Sağlayıcıları karşılaştırırken `--blind-judge-models` kullanın: değerlendirme istemi yine de
|
||||
her transkripti ve çalışma durumunu alır, ancak aday referansları
|
||||
`candidate-01` gibi nötr etiketlerle değiştirilir; rapor ayrıştırma sonrasında sıralamaları gerçek referanslarla eşler.
|
||||
her dökümü ve çalışma durumunu alır, ancak aday referansları `candidate-01` gibi
|
||||
nötr etiketlerle değiştirilir; rapor, ayrıştırmadan sonra sıralamaları gerçek referanslara geri eşler.
|
||||
Aday çalıştırmalar varsayılan olarak `high` düşünme düzeyini kullanır; bunu destekleyen OpenAI modelleri için
|
||||
`xhigh` kullanılır. Belirli bir adayı satır içinde
|
||||
`--model provider/model,thinking=<level>` ile geçersiz kılın. `--thinking <level>` hâlâ genel
|
||||
yedek değeri ayarlar ve eski `--model-thinking <provider/model=level>` biçimi
|
||||
`--model provider/model,thinking=<level>` ile geçersiz kılın. `--thinking <level>` yine de
|
||||
genel bir yedek ayarlar ve eski `--model-thinking <provider/model=level>` biçimi
|
||||
uyumluluk için korunur.
|
||||
OpenAI aday referansları varsayılan olarak hızlı modu kullanır; böylece sağlayıcının desteklediği yerlerde
|
||||
öncelikli işleme kullanılır. Tek bir aday veya değerlendirici için geçersiz kılma gerektiğinde
|
||||
satır içinde `,fast`, `,no-fast` veya `,fast=false` ekleyin. Yalnızca her aday model için
|
||||
hızlı modu zorla açmak istediğinizde `--fast` geçin. Aday ve değerlendirici süreleri
|
||||
kıyaslama analizi için rapora kaydedilir, ancak değerlendirici istemleri açıkça
|
||||
OpenAI aday referansları varsayılan olarak hızlı mod kullanır; böylece sağlayıcının desteklediği yerlerde
|
||||
öncelikli işleme kullanılır. Tek bir adayın veya değerlendiricinin geçersiz kılınması gerektiğinde
|
||||
satır içinde `,fast`, `,no-fast` veya `,fast=false` ekleyin. Hızlı modu
|
||||
her aday model için zorla açmak istediğinizde yalnızca `--fast` geçin. Kıyaslama analizi için
|
||||
aday ve değerlendirici süreleri rapora kaydedilir, ancak değerlendirme istemleri açıkça
|
||||
hıza göre sıralama yapılmamasını söyler.
|
||||
Aday ve değerlendirici model çalıştırmaları varsayılan olarak 16 eşzamanlılık kullanır.
|
||||
Sağlayıcı sınırları veya yerel gateway baskısı bir çalıştırmayı çok gürültülü hâle getiriyorsa
|
||||
Aday ve değerlendirici model çalıştırmaları varsayılan olarak 16 eşzamanlılık kullanır. Sağlayıcı sınırları
|
||||
veya yerel gateway yükü bir çalıştırmayı fazla gürültülü hale getiriyorsa
|
||||
`--concurrency` veya `--judge-concurrency` değerini düşürün.
|
||||
Aday `--model` geçirilmediğinde karakter değerlendirmesi varsayılan olarak
|
||||
Aday `--model` geçirilmediğinde, karakter değerlendirmesi varsayılan olarak
|
||||
`openai/gpt-5.4`, `openai/gpt-5.2`, `openai/gpt-5`, `anthropic/claude-opus-4-6`,
|
||||
`anthropic/claude-sonnet-4-6`, `zai/glm-5.1`,
|
||||
`moonshot/kimi-k2.5` ve
|
||||
`google/gemini-3.1-pro-preview` kullanır.
|
||||
Değerlendirici `--judge-model` geçirilmediğinde değerlendiriciler varsayılan olarak
|
||||
Değerlendirici `--judge-model` geçirilmediğinde, değerlendiriciler varsayılan olarak
|
||||
`openai/gpt-5.4,thinking=xhigh,fast` ve
|
||||
`anthropic/claude-opus-4-6,thinking=high` kullanır.
|
||||
`anthropic/claude-opus-4-6,thinking=high` olur.
|
||||
|
||||
## İlgili dokümanlar
|
||||
## İlgili belgeler
|
||||
|
||||
- [Testing](/tr/help/testing)
|
||||
- [QA Channel](/tr/channels/qa-channel)
|
||||
- [Dashboard](/web/dashboard)
|
||||
- [Dashboard](/tr/web/dashboard)
|
||||
|
||||
File diff suppressed because it is too large
Load Diff
@ -2,14 +2,14 @@
|
||||
read_when:
|
||||
- OpenClaw'da OpenAI modellerini kullanmak istiyorsunuz
|
||||
- API anahtarları yerine Codex abonelik kimlik doğrulamasını istiyorsunuz
|
||||
- Daha katı GPT-5 ajan yürütme davranışına ihtiyacınız var
|
||||
summary: OpenClaw'da OpenAI'yi API anahtarları veya Codex aboneliği üzerinden kullanma
|
||||
- Daha sıkı GPT-5 ajan yürütme davranışına ihtiyacınız var
|
||||
summary: OpenClaw'da API anahtarları veya Codex aboneliği üzerinden OpenAI kullanın
|
||||
title: OpenAI
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T09:09:38Z"
|
||||
generated_at: "2026-04-23T13:58:04Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: c3d847e53c2faee5363071dfdcb1f4150b64577674161e000844f579482198d1
|
||||
source_hash: ac42660234e1971440f6de3b04adb1d3a1fddca20219fb68936c36e4c2f95265
|
||||
source_path: providers/openai.md
|
||||
workflow: 15
|
||||
---
|
||||
@ -18,25 +18,25 @@ x-i18n:
|
||||
|
||||
OpenAI, GPT modelleri için geliştirici API'leri sağlar. OpenClaw iki kimlik doğrulama yolunu destekler:
|
||||
|
||||
- **API anahtarı** — kullanım bazlı faturalandırma ile doğrudan OpenAI Platform erişimi (`openai/*` modelleri)
|
||||
- **Codex aboneliği** — abonelik erişimi ile ChatGPT/Codex oturumu açma (`openai-codex/*` modelleri)
|
||||
- **API anahtarı** — kullanım bazlı faturalandırmayla doğrudan OpenAI Platform erişimi (`openai/*` modelleri)
|
||||
- **Codex aboneliği** — abonelik erişimiyle ChatGPT/Codex oturumu açma (`openai-codex/*` modelleri)
|
||||
|
||||
OpenAI, OpenClaw gibi harici araçlar ve iş akışlarında abonelik OAuth kullanımını açıkça destekler.
|
||||
OpenAI, OpenClaw gibi harici araçlarda ve iş akışlarında abonelik OAuth kullanımını açıkça destekler.
|
||||
|
||||
## OpenClaw özellik kapsamı
|
||||
|
||||
| OpenAI yeteneği | OpenClaw yüzeyi | Durum |
|
||||
| ------------------------ | ---------------------------------------- | -------------------------------------------------------- |
|
||||
| Sohbet / Responses | `openai/<model>` model sağlayıcısı | Evet |
|
||||
| Codex abonelik modelleri | `openai-codex/<model>` model sağlayıcısı | Evet |
|
||||
| Sunucu taraflı web arama | Yerel OpenAI Responses aracı | Evet, web arama etkin olduğunda ve sağlayıcı sabitlenmediğinde |
|
||||
| Görseller | `image_generate` | Evet |
|
||||
| Videolar | `video_generate` | Evet |
|
||||
| Metinden konuşmaya | `messages.tts.provider: "openai"` / `tts` | Evet |
|
||||
| Toplu konuşmadan metne | `tools.media.audio` / medya anlama | Evet |
|
||||
| Akış konuşmadan metne | Voice Call `streaming.provider: "openai"` | Evet |
|
||||
| Gerçek zamanlı ses | Voice Call `realtime.provider: "openai"` | Evet |
|
||||
| Embeddings | bellek embedding sağlayıcısı | Evet |
|
||||
| OpenAI yeteneği | OpenClaw yüzeyi | Durum |
|
||||
| ------------------------- | ----------------------------------------- | ------------------------------------------------------ |
|
||||
| Sohbet / Yanıtlar | `openai/<model>` model sağlayıcısı | Evet |
|
||||
| Codex abonelik modelleri | `openai-codex/<model>` model sağlayıcısı | Evet |
|
||||
| Sunucu taraflı web arama | Yerel OpenAI Responses aracı | Evet, web arama etkin olduğunda ve hiçbir sağlayıcı sabitlenmediğinde |
|
||||
| Görseller | `image_generate` | Evet |
|
||||
| Videolar | `video_generate` | Evet |
|
||||
| Metinden konuşmaya | `messages.tts.provider: "openai"` / `tts` | Evet |
|
||||
| Toplu konuşmadan metne | `tools.media.audio` / medya anlama | Evet |
|
||||
| Akışlı konuşmadan metne | Voice Call `streaming.provider: "openai"` | Evet |
|
||||
| Gerçek zamanlı ses | Voice Call `realtime.provider: "openai"` | Evet |
|
||||
| Embeddings | bellek embedding sağlayıcısı | Evet |
|
||||
|
||||
## Başlarken
|
||||
|
||||
@ -44,13 +44,13 @@ x-i18n:
|
||||
|
||||
<Tabs>
|
||||
<Tab title="API anahtarı (OpenAI Platform)">
|
||||
**En uygun:** doğrudan API erişimi ve kullanım bazlı faturalandırma.
|
||||
**Şunun için en iyisi:** doğrudan API erişimi ve kullanım bazlı faturalandırma.
|
||||
|
||||
<Steps>
|
||||
<Step title="API anahtarınızı alın">
|
||||
[OpenAI Platform panosundan](https://platform.openai.com/api-keys) bir API anahtarı oluşturun veya kopyalayın.
|
||||
</Step>
|
||||
<Step title="İlk kurulumu çalıştırın">
|
||||
<Step title="Onboarding'i çalıştırın">
|
||||
```bash
|
||||
openclaw onboard --auth-choice openai-api-key
|
||||
```
|
||||
@ -68,15 +68,15 @@ x-i18n:
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Rota özeti
|
||||
### Yol özeti
|
||||
|
||||
| Model başvurusu | Rota | Kimlik doğrulama |
|
||||
| Model ref | Yol | Kimlik doğrulama |
|
||||
|-----------|-------|------|
|
||||
| `openai/gpt-5.4` | Doğrudan OpenAI Platform API | `OPENAI_API_KEY` |
|
||||
| `openai/gpt-5.4-pro` | Doğrudan OpenAI Platform API | `OPENAI_API_KEY` |
|
||||
|
||||
<Note>
|
||||
ChatGPT/Codex oturum açma işlemi `openai/*` değil, `openai-codex/*` üzerinden yönlendirilir.
|
||||
ChatGPT/Codex oturum açma `openai/*` üzerinden değil, `openai-codex/*` üzerinden yönlendirilir.
|
||||
</Note>
|
||||
|
||||
### Yapılandırma örneği
|
||||
@ -89,13 +89,13 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Warning>
|
||||
OpenClaw, doğrudan API yolunda `openai/gpt-5.3-codex-spark` sunmaz. Canlı OpenAI API istekleri bu modeli reddeder. Spark yalnızca Codex içindir.
|
||||
OpenClaw, doğrudan API yolunda `openai/gpt-5.3-codex-spark` modelini **sunmaz**. Canlı OpenAI API istekleri bu modeli reddeder. Spark yalnızca Codex içindir.
|
||||
</Warning>
|
||||
|
||||
</Tab>
|
||||
|
||||
<Tab title="Codex aboneliği">
|
||||
**En uygun:** ayrı bir API anahtarı yerine ChatGPT/Codex aboneliğinizi kullanmak. Codex bulutu ChatGPT oturumu açmayı gerektirir.
|
||||
**Şunun için en iyisi:** ayrı bir API anahtarı yerine ChatGPT/Codex aboneliğinizi kullanmak. Codex cloud, ChatGPT oturumu açmayı gerektirir.
|
||||
|
||||
<Steps>
|
||||
<Step title="Codex OAuth'u çalıştırın">
|
||||
@ -109,7 +109,7 @@ x-i18n:
|
||||
openclaw models auth login --provider openai-codex
|
||||
```
|
||||
|
||||
Başsız veya callback'e elverişsiz kurulumlar için, localhost tarayıcı callback'i yerine ChatGPT cihaz kodu akışıyla oturum açmak üzere `--device-code` ekleyin:
|
||||
Başsız veya callback'e elverişsiz kurulumlar için, localhost tarayıcı callback'i yerine ChatGPT device-code akışıyla oturum açmak üzere `--device-code` ekleyin:
|
||||
|
||||
```bash
|
||||
openclaw models auth login --provider openai-codex --device-code
|
||||
@ -127,15 +127,15 @@ x-i18n:
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Rota özeti
|
||||
### Yol özeti
|
||||
|
||||
| Model başvurusu | Rota | Kimlik doğrulama |
|
||||
| Model ref | Yol | Kimlik doğrulama |
|
||||
|-----------|-------|------|
|
||||
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Codex oturumu açma |
|
||||
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Codex oturumu açma (hak kazanımına bağlı) |
|
||||
| `openai-codex/gpt-5.4` | ChatGPT/Codex OAuth | Codex oturum açma |
|
||||
| `openai-codex/gpt-5.3-codex-spark` | ChatGPT/Codex OAuth | Codex oturum açma (hak sahipliğine bağlı) |
|
||||
|
||||
<Note>
|
||||
Bu rota kasıtlı olarak `openai/gpt-5.4` yolundan ayrıdır. Doğrudan Platform erişimi için API anahtarıyla `openai/*`, Codex abonelik erişimi için `openai-codex/*` kullanın.
|
||||
Bu yol, bilerek `openai/gpt-5.4` yolundan ayrı tutulur. Doğrudan Platform erişimi için API anahtarıyla `openai/*`, Codex abonelik erişimi için `openai-codex/*` kullanın.
|
||||
</Note>
|
||||
|
||||
### Yapılandırma örneği
|
||||
@ -147,19 +147,19 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Note>
|
||||
İlk kurulum artık OAuth materyalini `~/.codex` içinden içe aktarmıyor. Tarayıcı OAuth'u (varsayılan) veya yukarıdaki cihaz kodu akışı ile oturum açın — OpenClaw oluşan kimlik bilgilerini kendi ajan auth deposunda yönetir.
|
||||
Onboarding artık OAuth materyalini `~/.codex` içinden içe aktarmıyor. Varsayılan olarak tarayıcı OAuth ile veya yukarıdaki device-code akışıyla oturum açın — OpenClaw oluşan kimlik bilgilerini kendi ajan kimlik doğrulama deposunda yönetir.
|
||||
</Note>
|
||||
|
||||
### Bağlam penceresi sınırı
|
||||
|
||||
OpenClaw model meta verisini ve çalışma zamanı bağlam sınırını ayrı değerler olarak ele alır.
|
||||
OpenClaw, model metadata'sını ve çalışma zamanı bağlam sınırını ayrı değerler olarak ele alır.
|
||||
|
||||
`openai-codex/gpt-5.4` için:
|
||||
|
||||
- Yerel `contextWindow`: `1050000`
|
||||
- Varsayılan çalışma zamanı `contextTokens` sınırı: `272000`
|
||||
|
||||
Daha küçük varsayılan sınır pratikte daha iyi gecikme ve kalite özelliklerine sahiptir. Bunu `contextTokens` ile geçersiz kılın:
|
||||
Daha küçük varsayılan sınır, pratikte daha iyi gecikme ve kalite özelliklerine sahiptir. Bunu `contextTokens` ile geçersiz kılın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -174,23 +174,23 @@ x-i18n:
|
||||
```
|
||||
|
||||
<Note>
|
||||
Yerel model meta verisini bildirmek için `contextWindow` kullanın. Çalışma zamanı bağlam bütçesini sınırlamak için `contextTokens` kullanın.
|
||||
Yerel model metadata'sını belirtmek için `contextWindow` kullanın. Çalışma zamanı bağlam bütçesini sınırlamak için `contextTokens` kullanın.
|
||||
</Note>
|
||||
|
||||
</Tab>
|
||||
</Tabs>
|
||||
|
||||
## Görsel üretimi
|
||||
## Görsel oluşturma
|
||||
|
||||
Paketli `openai` Plugin'i, görsel üretimini `image_generate` aracı üzerinden kaydeder.
|
||||
Paketlenmiş `openai` Plugin, `image_generate` aracı üzerinden görsel oluşturmayı kaydeder.
|
||||
|
||||
| Yetenek | Değer |
|
||||
| ------------------------ | ----------------------------------- |
|
||||
| Varsayılan model | `openai/gpt-image-2` |
|
||||
| İstek başına azami görsel | 4 |
|
||||
| Düzenleme modu | Etkin (en fazla 5 başvuru görseli) |
|
||||
| Boyut geçersiz kılmaları | Desteklenir, 2K/4K boyutlar dahil |
|
||||
| En boy oranı / çözünürlük | OpenAI Images API'ye iletilmez |
|
||||
| Yetenek | Değer |
|
||||
| ------------------------ | ---------------------------------- |
|
||||
| Varsayılan model | `openai/gpt-image-2` |
|
||||
| İstek başına en fazla görsel | 4 |
|
||||
| Düzenleme modu | Etkin (en fazla 5 referans görsel) |
|
||||
| Boyut geçersiz kılmaları | Desteklenir, 2K/4K boyutları dahil |
|
||||
| En-boy oranı / çözünürlük | OpenAI Images API'ye iletilmez |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -203,33 +203,33 @@ Paketli `openai` Plugin'i, görsel üretimini `image_generate` aracı üzerinden
|
||||
```
|
||||
|
||||
<Note>
|
||||
Paylaşılan araç parametreleri, sağlayıcı seçimi ve failover davranışı için bkz. [Görsel Üretimi](/tr/tools/image-generation).
|
||||
Paylaşılan araç parametreleri, sağlayıcı seçimi ve failover davranışı için [Görsel Oluşturma](/tr/tools/image-generation) bölümüne bakın.
|
||||
</Note>
|
||||
|
||||
`gpt-image-2`, hem OpenAI metinden görsel üretimi hem de görsel düzenleme için varsayılandır. `gpt-image-1` açık model geçersiz kılması olarak kullanılabilir olmaya devam eder, ancak yeni OpenAI görsel iş akışları `openai/gpt-image-2` kullanmalıdır.
|
||||
`gpt-image-2`, hem OpenAI metinden görsel oluşturma hem de görsel düzenleme için varsayılandır. `gpt-image-1` açık bir model geçersiz kılması olarak kullanılabilir olmaya devam eder, ancak yeni OpenAI görsel iş akışları `openai/gpt-image-2` kullanmalıdır.
|
||||
|
||||
Üret:
|
||||
Oluştur:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="A polished launch poster for OpenClaw on macOS" size=3840x2160 count=1
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="macOS üzerinde OpenClaw için cilalı bir lansman posteri" size=3840x2160 count=1
|
||||
```
|
||||
|
||||
Düzenle:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Preserve the object shape, change the material to translucent glass" image=/path/to/reference.png size=1024x1536
|
||||
/tool image_generate model=openai/gpt-image-2 prompt="Nesnenin şeklini koru, malzemeyi yarı saydam cama dönüştür" image=/path/to/reference.png size=1024x1536
|
||||
```
|
||||
|
||||
## Video üretimi
|
||||
## Video oluşturma
|
||||
|
||||
Paketli `openai` Plugin'i, video üretimini `video_generate` aracı üzerinden kaydeder.
|
||||
Paketlenmiş `openai` Plugin, `video_generate` aracı üzerinden video oluşturmayı kaydeder.
|
||||
|
||||
| Yetenek | Değer |
|
||||
| ---------------- | ----------------------------------------------------------------------------------- |
|
||||
| Varsayılan model | `openai/sora-2` |
|
||||
| Modlar | Metinden videoya, görselden videoya, tek video düzenleme |
|
||||
| Başvuru girdileri | 1 görsel veya 1 video |
|
||||
| Boyut geçersiz kılmaları | Desteklenir |
|
||||
| Yetenek | Değer |
|
||||
| --------------- | --------------------------------------------------------------------------------- |
|
||||
| Varsayılan model | `openai/sora-2` |
|
||||
| Modlar | Metinden videoya, görselden videoya, tek video düzenleme |
|
||||
| Referans girdileri | 1 görsel veya 1 video |
|
||||
| Boyut geçersiz kılmaları | Desteklenir |
|
||||
| Diğer geçersiz kılmalar | `aspectRatio`, `resolution`, `audio`, `watermark` bir araç uyarısıyla yok sayılır |
|
||||
|
||||
```json5
|
||||
@ -243,25 +243,25 @@ Paketli `openai` Plugin'i, video üretimini `video_generate` aracı üzerinden k
|
||||
```
|
||||
|
||||
<Note>
|
||||
Paylaşılan araç parametreleri, sağlayıcı seçimi ve failover davranışı için bkz. [Video Üretimi](/tr/tools/video-generation).
|
||||
Paylaşılan araç parametreleri, sağlayıcı seçimi ve failover davranışı için [Video Oluşturma](/tr/tools/video-generation) bölümüne bakın.
|
||||
</Note>
|
||||
|
||||
## GPT-5 istem katkısı
|
||||
|
||||
OpenClaw, sağlayıcılar arasında GPT-5 ailesi çalıştırmaları için paylaşılan bir GPT-5 istem katkısı ekler. Model kimliğine göre uygulanır; bu nedenle `openai/gpt-5.4`, `openai-codex/gpt-5.4`, `openrouter/openai/gpt-5.4`, `opencode/gpt-5.4` ve diğer uyumlu GPT-5 başvuruları aynı katmanı alır. Daha eski GPT-4.x modelleri almaz.
|
||||
OpenClaw, sağlayıcılar genelinde GPT-5 ailesi çalıştırmaları için paylaşılan bir GPT-5 istem katkısı ekler. Model kimliğine göre uygulanır; bu nedenle `openai/gpt-5.4`, `openai-codex/gpt-5.4`, `openrouter/openai/gpt-5.4`, `opencode/gpt-5.4` ve uyumlu diğer GPT-5 ref'leri aynı katmanı alır. Daha eski GPT-4.x modelleri almaz.
|
||||
|
||||
Paketli yerel Codex harness sağlayıcısı (`codex/*`), Codex uygulama sunucusu geliştirici yönergeleri üzerinden aynı GPT-5 davranışını ve Heartbeat katmanını kullanır; böylece `codex/gpt-5.x` oturumları, istemin geri kalanına Codex sahip olsa bile aynı takip etme ve proaktif Heartbeat rehberliğini korur.
|
||||
Paketlenmiş yerel Codex harness sağlayıcısı (`codex/*`), Codex uygulama sunucusu geliştirici talimatları üzerinden aynı GPT-5 davranışını ve Heartbeat katmanını kullanır; bu nedenle `codex/gpt-5.x` oturumları, Codex harness isteminin geri kalanına sahip olsa da aynı takip etme ve proaktif Heartbeat rehberliğini korur.
|
||||
|
||||
GPT-5 katkısı; persona sürekliliği, yürütme güvenliği, araç disiplini, çıktı biçimi, tamamlama denetimleri ve doğrulama için etiketli bir davranış sözleşmesi ekler. Kanala özgü yanıt ve sessiz mesaj davranışı paylaşılan OpenClaw sistem isteminde ve giden teslimat ilkesinde kalır. GPT-5 rehberliği eşleşen modeller için her zaman etkindir. Dostça etkileşim tarzı katmanı ayrıdır ve yapılandırılabilir.
|
||||
GPT-5 katkısı; persona sürekliliği, yürütme güvenliği, araç disiplini, çıktı şekli, tamamlanma kontrolleri ve doğrulama için etiketli bir davranış sözleşmesi ekler. Kanala özgü yanıt ve sessiz mesaj davranışı, paylaşılan OpenClaw sistem isteminde ve giden teslim politikası içinde kalır. GPT-5 rehberliği eşleşen modeller için her zaman etkindir. Dostça etkileşim stili katmanı ayrıdır ve yapılandırılabilir.
|
||||
|
||||
| Değer | Etki |
|
||||
| ---------------------- | ------------------------------------------- |
|
||||
| `"friendly"` (varsayılan) | Dostça etkileşim tarzı katmanını etkinleştir |
|
||||
| `"friendly"` (varsayılan) | Dostça etkileşim stili katmanını etkinleştirir |
|
||||
| `"on"` | `"friendly"` için takma ad |
|
||||
| `"off"` | Yalnızca dostça tarz katmanını devre dışı bırak |
|
||||
| `"off"` | Yalnızca dostça stil katmanını devre dışı bırakır |
|
||||
|
||||
<Tabs>
|
||||
<Tab title="Config">
|
||||
<Tab title="Yapılandırma">
|
||||
```json5
|
||||
{
|
||||
agents: {
|
||||
@ -282,28 +282,28 @@ GPT-5 katkısı; persona sürekliliği, yürütme güvenliği, araç disiplini,
|
||||
</Tabs>
|
||||
|
||||
<Tip>
|
||||
Değerler çalışma zamanında büyük/küçük harf duyarsızdır; bu nedenle `"Off"` ve `"off"` her ikisi de dostça tarz katmanını devre dışı bırakır.
|
||||
Değerler çalışma zamanında büyük/küçük harfe duyarsızdır; bu nedenle `"Off"` ve `"off"` her ikisi de dostça stil katmanını devre dışı bırakır.
|
||||
</Tip>
|
||||
|
||||
<Note>
|
||||
Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.promptOverlays.gpt5.personality` ayarı yapılmadığında uyumluluk geri dönüşü olarak hâlâ okunur.
|
||||
Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.promptOverlays.gpt5.personality` ayarı belirlenmediğinde uyumluluk için geri dönüş olarak hâlâ okunur.
|
||||
</Note>
|
||||
|
||||
## Ses ve konuşma
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Konuşma sentezi (TTS)">
|
||||
Paketli `openai` Plugin'i, konuşma sentezini `messages.tts` yüzeyi için kaydeder.
|
||||
Paketlenmiş `openai` Plugin, `messages.tts` yüzeyi için konuşma sentezini kaydeder.
|
||||
|
||||
| Ayar | Config yolu | Varsayılan |
|
||||
| Ayar | Yapılandırma yolu | Varsayılan |
|
||||
|---------|------------|---------|
|
||||
| Model | `messages.tts.providers.openai.model` | `gpt-4o-mini-tts` |
|
||||
| Ses | `messages.tts.providers.openai.voice` | `coral` |
|
||||
| Hız | `messages.tts.providers.openai.speed` | (ayarsız) |
|
||||
| Yönergeler | `messages.tts.providers.openai.instructions` | (ayarsız, yalnızca `gpt-4o-mini-tts`) |
|
||||
| Hız | `messages.tts.providers.openai.speed` | (ayarlanmadı) |
|
||||
| Talimatlar | `messages.tts.providers.openai.instructions` | (ayarlanmadı, yalnızca `gpt-4o-mini-tts`) |
|
||||
| Biçim | `messages.tts.providers.openai.responseFormat` | sesli notlar için `opus`, dosyalar için `mp3` |
|
||||
| API anahtarı | `messages.tts.providers.openai.apiKey` | `OPENAI_API_KEY` değerine geri döner |
|
||||
| Base URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
| API anahtarı | `messages.tts.providers.openai.apiKey` | Geri dönüş olarak `OPENAI_API_KEY` kullanır |
|
||||
| Temel URL | `messages.tts.providers.openai.baseUrl` | `https://api.openai.com/v1` |
|
||||
|
||||
Kullanılabilir modeller: `gpt-4o-mini-tts`, `tts-1`, `tts-1-hd`. Kullanılabilir sesler: `alloy`, `ash`, `ballad`, `cedar`, `coral`, `echo`, `fable`, `juniper`, `marin`, `onyx`, `nova`, `sage`, `shimmer`, `verse`.
|
||||
|
||||
@ -320,23 +320,20 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
```
|
||||
|
||||
<Note>
|
||||
Sohbet API uç noktasını etkilemeden TTS base URL'sini geçersiz kılmak için `OPENAI_TTS_BASE_URL` ayarlayın.
|
||||
Sohbet API uç noktasını etkilemeden TTS temel URL'sini geçersiz kılmak için `OPENAI_TTS_BASE_URL` ayarlayın.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Konuşmadan metne">
|
||||
Paketli `openai` Plugin'i, toplu konuşmadan metne desteğini
|
||||
OpenClaw'un medya anlama transkripsiyon yüzeyi üzerinden kaydeder.
|
||||
Paketlenmiş `openai` Plugin, OpenClaw'ın medya anlama transkripsiyon yüzeyi üzerinden toplu konuşmadan metne dönüştürmeyi kaydeder.
|
||||
|
||||
- Varsayılan model: `gpt-4o-transcribe`
|
||||
- Uç nokta: OpenAI REST `/v1/audio/transcriptions`
|
||||
- Girdi yolu: multipart ses dosyası yükleme
|
||||
- OpenClaw'da gelen ses transkripsiyonunun
|
||||
`tools.media.audio` kullandığı her yerde desteklenir; buna Discord ses kanalı segmentleri ve kanal
|
||||
ses ekleri dahildir
|
||||
- OpenClaw'da, gelen ses transkripsiyonu `tools.media.audio` kullandığı her yerde desteklenir; buna Discord ses kanalı segmentleri ve kanal ses ekleri dahildir
|
||||
|
||||
Gelen ses transkripsiyonu için OpenAI'yi zorlamak üzere:
|
||||
Gelen ses transkripsiyonu için OpenAI'ı zorunlu kılmak için:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -356,47 +353,171 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
}
|
||||
```
|
||||
|
||||
Dil ve istem ipuçları, paylaşılan ses medya config'i veya çağrı başına transkripsiyon isteği tarafından sağlandığında OpenAI'ye iletilir.
|
||||
Dil ve istem ipuçları, paylaşılan ses medya yapılandırması veya çağrı başına transkripsiyon isteği tarafından sağlandığında OpenAI'a iletilir.
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Gerçek zamanlı transkripsiyon">
|
||||
Paketli `openai` Plugin'i, Voice Call Plugin'i için gerçek zamanlı transkripsiyon kaydeder.
|
||||
Paketlenmiş `openai` Plugin, Voice Call Plugin için gerçek zamanlı transkripsiyonu kaydeder.
|
||||
|
||||
| Ayar | Config yolu | Varsayılan |
|
||||
| Ayar | Yapılandırma yolu | Varsayılan |
|
||||
|---------|------------|---------|
|
||||
| Model | `plugins.entries.voice-call.config.streaming.providers.openai.model` | `gpt-4o-transcribe` |
|
||||
| Dil | `...openai.language` | (ayarsız) |
|
||||
| İstem | `...openai.prompt` | (ayarsız) |
|
||||
| Dil | `...openai.language` | (ayarlanmadı) |
|
||||
| İstem | `...openai.prompt` | (ayarlanmadı) |
|
||||
| Sessizlik süresi | `...openai.silenceDurationMs` | `800` |
|
||||
| VAD eşiği | `...openai.vadThreshold` | `0.5` |
|
||||
| API anahtarı | `...openai.apiKey` | `OPENAI_API_KEY` değerine geri döner |
|
||||
| API anahtarı | `...openai.apiKey` | Geri dönüş olarak `OPENAI_API_KEY` kullanır |
|
||||
|
||||
<Note>
|
||||
`wss://api.openai.com/v1/realtime` adresine G.711 u-law (`g711_ulaw` / `audio/pcmu`) ses ile bir WebSocket bağlantısı kullanır. Bu akış sağlayıcısı Voice Call'un gerçek zamanlı transkripsiyon yolu içindir; Discord ses şu anda kısa segmentler kaydeder ve bunun yerine toplu `tools.media.audio` transkripsiyon yolunu kullanır.
|
||||
`wss://api.openai.com/v1/realtime` adresine G.711 u-law (`g711_ulaw` / `audio/pcmu`) ses ile bir WebSocket bağlantısı kullanır. Bu akış sağlayıcısı, Voice Call'ın gerçek zamanlı transkripsiyon yolu içindir; Discord voice ise şu anda kısa segmentler kaydeder ve bunun yerine toplu `tools.media.audio` transkripsiyon yolunu kullanır.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Gerçek zamanlı ses">
|
||||
Paketli `openai` Plugin'i, Voice Call Plugin'i için gerçek zamanlı ses kaydeder.
|
||||
Paketlenmiş `openai` Plugin, Voice Call Plugin için gerçek zamanlı sesi kaydeder.
|
||||
|
||||
| Ayar | Config yolu | Varsayılan |
|
||||
| Ayar | Yapılandırma yolu | Varsayılan |
|
||||
|---------|------------|---------|
|
||||
| Model | `plugins.entries.voice-call.config.realtime.providers.openai.model` | `gpt-realtime` |
|
||||
| Ses | `...openai.voice` | `alloy` |
|
||||
| Sıcaklık | `...openai.temperature` | `0.8` |
|
||||
| VAD eşiği | `...openai.vadThreshold` | `0.5` |
|
||||
| Sessizlik süresi | `...openai.silenceDurationMs` | `500` |
|
||||
| API anahtarı | `...openai.apiKey` | `OPENAI_API_KEY` değerine geri döner |
|
||||
| API anahtarı | `...openai.apiKey` | Geri dönüş olarak `OPENAI_API_KEY` kullanır |
|
||||
|
||||
<Note>
|
||||
`azureEndpoint` ve `azureDeployment` config anahtarları üzerinden Azure OpenAI'yi destekler. Çift yönlü araç çağrısını destekler. G.711 u-law ses biçimini kullanır.
|
||||
`azureEndpoint` ve `azureDeployment` yapılandırma anahtarları üzerinden Azure OpenAI'ı destekler. Çift yönlü araç çağrımını destekler. G.711 u-law ses biçimini kullanır.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
## Azure OpenAI uç noktaları
|
||||
|
||||
Paketlenmiş `openai` sağlayıcısı, temel URL'yi geçersiz kılarak görsel oluşturma için bir Azure OpenAI kaynağını hedefleyebilir. Görsel oluşturma yolunda OpenClaw, `models.providers.openai.baseUrl` üzerindeki Azure ana makine adlarını algılar ve otomatik olarak Azure'ın istek şekline geçer.
|
||||
|
||||
<Note>
|
||||
Gerçek zamanlı ses ayrı bir yapılandırma yolu kullanır
|
||||
(`plugins.entries.voice-call.config.realtime.providers.openai.azureEndpoint`)
|
||||
ve `models.providers.openai.baseUrl` değerinden etkilenmez. Azure
|
||||
ayarları için [Ses ve konuşma](#voice-and-speech) altındaki **Gerçek zamanlı
|
||||
ses** accordion bölümüne bakın.
|
||||
</Note>
|
||||
|
||||
Azure OpenAI'ı şu durumlarda kullanın:
|
||||
|
||||
- Zaten bir Azure OpenAI aboneliğiniz, kotanız veya kurumsal anlaşmanız varsa
|
||||
- Azure'ın sağladığı bölgesel veri yerleşimi veya uyumluluk kontrollerine ihtiyacınız varsa
|
||||
- Trafiği mevcut bir Azure kiracılığı içinde tutmak istiyorsanız
|
||||
|
||||
### Yapılandırma
|
||||
|
||||
Paketlenmiş `openai` sağlayıcısı üzerinden Azure görsel oluşturma için
|
||||
`models.providers.openai.baseUrl` değerini Azure kaynağınıza yönlendirin ve
|
||||
`apiKey` değerini Azure OpenAI anahtarına ayarlayın (OpenAI Platform anahtarı değil):
|
||||
|
||||
```json5
|
||||
{
|
||||
models: {
|
||||
providers: {
|
||||
openai: {
|
||||
baseUrl: "https://<your-resource>.openai.azure.com",
|
||||
apiKey: "<azure-openai-api-key>",
|
||||
},
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
OpenClaw, Azure görsel oluşturma yolu için şu Azure ana makine soneklerini tanır:
|
||||
|
||||
- `*.openai.azure.com`
|
||||
- `*.services.ai.azure.com`
|
||||
- `*.cognitiveservices.azure.com`
|
||||
|
||||
Tanınan bir Azure ana makinesindeki görsel oluşturma istekleri için OpenClaw:
|
||||
|
||||
- `Authorization: Bearer` yerine `api-key` üstbilgisini gönderir
|
||||
- Deployment kapsamlı yollar kullanır (`/openai/deployments/{deployment}/...`)
|
||||
- Her isteğe `?api-version=...` ekler
|
||||
|
||||
Diğer temel URL'ler (genel OpenAI, OpenAI uyumlu proxy'ler) standart
|
||||
OpenAI görsel istek şeklini korur.
|
||||
|
||||
<Note>
|
||||
`openai` sağlayıcısının görsel oluşturma yolu için Azure yönlendirme
|
||||
OpenClaw 2026.4.22 veya sonrasını gerektirir. Daha eski sürümler herhangi bir özel
|
||||
`openai.baseUrl` değerini genel OpenAI uç noktası gibi ele alır ve Azure
|
||||
görsel deployment'larında başarısız olur.
|
||||
</Note>
|
||||
|
||||
### API sürümü
|
||||
|
||||
Azure görsel oluşturma yolu için belirli bir Azure preview veya GA sürümünü sabitlemek üzere
|
||||
`AZURE_OPENAI_API_VERSION` ayarlayın:
|
||||
|
||||
```bash
|
||||
export AZURE_OPENAI_API_VERSION="2024-12-01-preview"
|
||||
```
|
||||
|
||||
Değişken ayarlanmadığında varsayılan `2024-12-01-preview` olur.
|
||||
|
||||
### Model adları deployment adlarıdır
|
||||
|
||||
Azure OpenAI, modelleri deployment'lara bağlar. Paketlenmiş `openai` sağlayıcısı üzerinden yönlendirilen
|
||||
Azure görsel oluşturma istekleri için OpenClaw'daki `model` alanı, genel
|
||||
OpenAI model kimliği değil, Azure portalında yapılandırdığınız **Azure deployment adı**
|
||||
olmalıdır.
|
||||
|
||||
`gpt-image-2` sunan `gpt-image-2-prod` adlı bir deployment oluşturursanız:
|
||||
|
||||
```
|
||||
/tool image_generate model=openai/gpt-image-2-prod prompt="Temiz bir poster" size=1024x1024 count=1
|
||||
```
|
||||
|
||||
Aynı deployment-adı kuralı, paketlenmiş `openai` sağlayıcısı üzerinden yönlendirilen
|
||||
görsel oluşturma çağrıları için de geçerlidir.
|
||||
|
||||
### Bölgesel kullanılabilirlik
|
||||
|
||||
Azure görsel oluşturma şu anda yalnızca bazı bölgelerde kullanılabilir
|
||||
(örneğin `eastus2`, `swedencentral`, `polandcentral`, `westus3`,
|
||||
`uaenorth`). Bir deployment oluşturmadan önce Microsoft'un güncel bölge
|
||||
listesini kontrol edin ve belirli modelin bölgenizde sunulduğunu doğrulayın.
|
||||
|
||||
### Parametre farkları
|
||||
|
||||
Azure OpenAI ve genel OpenAI her zaman aynı görsel parametrelerini kabul etmez.
|
||||
Azure, genel OpenAI'ın izin verdiği seçenekleri reddedebilir (örneğin belirli
|
||||
`background` değerleri `gpt-image-2` üzerinde) veya bunları yalnızca belirli model
|
||||
sürümlerinde sunabilir. Bu farklar OpenClaw'dan değil, Azure'dan ve alttaki modelden gelir.
|
||||
Bir Azure isteği doğrulama hatasıyla başarısız olursa, Azure portalında
|
||||
belirli deployment'ınız ve API sürümünüz tarafından desteklenen parametre
|
||||
kümesini kontrol edin.
|
||||
|
||||
<Note>
|
||||
Azure OpenAI yerel taşıma ve uyumluluk davranışı kullanır ancak
|
||||
OpenClaw'ın gizli atıf üstbilgilerini almaz. Ayrıntılar için
|
||||
[Gelişmiş yapılandırma](#advanced-configuration) altındaki **Yerel ve OpenAI-compatible
|
||||
yollar** accordion bölümüne bakın.
|
||||
</Note>
|
||||
|
||||
<Tip>
|
||||
`openai` sağlayıcısından ayrı bir Azure OpenAI Responses sağlayıcısı için,
|
||||
[Sunucu taraflı Compaction](#server-side-compaction-responses-api) accordion bölümündeki
|
||||
`azure-openai-responses/*` model ref'lerine bakın.
|
||||
</Tip>
|
||||
|
||||
<Note>
|
||||
Azure sohbet ve Responses trafiği, temel URL geçersiz kılmasına ek olarak
|
||||
Azure'a özgü sağlayıcı/API yapılandırması gerektirir. Görsel oluşturmanın ötesinde
|
||||
Azure model çağrıları istiyorsanız, yalnızca `openai.baseUrl` değerinin yeterli
|
||||
olduğunu varsaymak yerine onboarding akışını veya uygun Azure API/kimlik doğrulama
|
||||
şeklini ayarlayan bir sağlayıcı yapılandırmasını kullanın.
|
||||
</Note>
|
||||
|
||||
## Gelişmiş yapılandırma
|
||||
|
||||
<AccordionGroup>
|
||||
@ -404,16 +525,16 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
OpenClaw, hem `openai/*` hem de `openai-codex/*` için WebSocket öncelikli ve SSE geri dönüşlü (`"auto"`) kullanır.
|
||||
|
||||
`"auto"` modunda OpenClaw:
|
||||
- SSE'ye geri dönmeden önce erken bir WebSocket hatasını bir kez yeniden dener
|
||||
- Bir hatadan sonra WebSocket'i yaklaşık 60 saniye boyunca bozulmuş olarak işaretler ve soğuma süresince SSE kullanır
|
||||
- Yeniden denemeler ve yeniden bağlantılar için kararlı oturum ve dönüş kimliği başlıkları ekler
|
||||
- SSE'ye geri dönmeden önce bir erken WebSocket hatasını yeniden dener
|
||||
- Bir hatadan sonra WebSocket'i yaklaşık 60 saniye boyunca bozulmuş olarak işaretler ve soğuma süresinde SSE kullanır
|
||||
- Yeniden denemeler ve yeniden bağlantılar için kararlı oturum ve sıra kimliği üstbilgileri ekler
|
||||
- Taşıma varyantları arasında kullanım sayaçlarını (`input_tokens` / `prompt_tokens`) normalize eder
|
||||
|
||||
| Değer | Davranış |
|
||||
|-------|----------|
|
||||
| `"auto"` (varsayılan) | Önce WebSocket, SSE geri dönüşü |
|
||||
| `"sse"` | Yalnızca SSE'yi zorla |
|
||||
| `"websocket"` | Yalnızca WebSocket'i zorla |
|
||||
| `"sse"` | Yalnızca SSE'yi zorunlu kıl |
|
||||
| `"websocket"` | Yalnızca WebSocket'i zorunlu kıl |
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -431,15 +552,15 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
|
||||
İlgili OpenAI belgeleri:
|
||||
- [WebSocket ile Realtime API](https://platform.openai.com/docs/guides/realtime-websocket)
|
||||
- [Akış API yanıtları (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
- [Akışlı API yanıtları (SSE)](https://platform.openai.com/docs/guides/streaming-responses)
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="WebSocket hazırlığı">
|
||||
OpenClaw, ilk dönüş gecikmesini azaltmak için `openai/*` için WebSocket hazırlığını varsayılan olarak etkinleştirir.
|
||||
<Accordion title="WebSocket warm-up">
|
||||
OpenClaw, ilk sıra gecikmesini azaltmak için `openai/*` için varsayılan olarak WebSocket warm-up özelliğini etkinleştirir.
|
||||
|
||||
```json5
|
||||
// Hazırlığı devre dışı bırak
|
||||
// Warm-up'ı devre dışı bırak
|
||||
{
|
||||
agents: {
|
||||
defaults: {
|
||||
@ -458,10 +579,10 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
<a id="openai-fast-mode"></a>
|
||||
|
||||
<Accordion title="Hızlı mod">
|
||||
OpenClaw, hem `openai/*` hem de `openai-codex/*` için paylaşılan bir hızlı mod anahtarı sunar:
|
||||
OpenClaw, hem `openai/*` hem de `openai-codex/*` için paylaşılan bir hızlı mod düğmesi sunar:
|
||||
|
||||
- **Sohbet/UI:** `/fast status|on|off`
|
||||
- **Config:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
- **Yapılandırma:** `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
|
||||
Etkinleştirildiğinde OpenClaw, hızlı modu OpenAI öncelikli işlemeye eşler (`service_tier = "priority"`). Mevcut `service_tier` değerleri korunur ve hızlı mod `reasoning` veya `text.verbosity` değerlerini yeniden yazmaz.
|
||||
|
||||
@ -479,13 +600,13 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
```
|
||||
|
||||
<Note>
|
||||
Oturum geçersiz kılmaları config'i geçer. Sessions UI içinde oturum geçersiz kılmasını temizlemek, oturumu yapılandırılmış varsayılana geri döndürür.
|
||||
Oturum geçersiz kılmaları yapılandırmaya üstün gelir. Sessions UI içinde oturum geçersiz kılmasını temizlemek, oturumu yapılandırılmış varsayılana geri döndürür.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Öncelikli işleme (service_tier)">
|
||||
OpenAI API'si, `service_tier` üzerinden öncelikli işlemeyi açığa çıkarır. Bunu OpenClaw'da model başına ayarlayın:
|
||||
OpenAI'ın API'si, `service_tier` aracılığıyla öncelikli işleme sunar. Bunu OpenClaw'da model başına ayarlayın:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -503,16 +624,16 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
Desteklenen değerler: `auto`, `default`, `flex`, `priority`.
|
||||
|
||||
<Warning>
|
||||
`serviceTier`, yalnızca yerel OpenAI uç noktalarına (`api.openai.com`) ve yerel Codex uç noktalarına (`chatgpt.com/backend-api`) iletilir. Sağlayıcılardan herhangi birini bir proxy üzerinden yönlendirirseniz OpenClaw `service_tier` değerine dokunmaz.
|
||||
`serviceTier` yalnızca yerel OpenAI uç noktalarına (`api.openai.com`) ve yerel Codex uç noktalarına (`chatgpt.com/backend-api`) iletilir. Her iki sağlayıcıyı da bir proxy üzerinden yönlendirirseniz OpenClaw, `service_tier` değerini değiştirmeden bırakır.
|
||||
</Warning>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Sunucu taraflı Compaction (Responses API)">
|
||||
Doğrudan OpenAI Responses modelleri için (`api.openai.com` üzerindeki `openai/*`), OpenClaw sunucu taraflı Compaction'ı otomatik etkinleştirir:
|
||||
Doğrudan OpenAI Responses modelleri için (`api.openai.com` üzerindeki `openai/*`), OpenClaw sunucu taraflı Compaction özelliğini otomatik etkinleştirir:
|
||||
|
||||
- `store: true` zorlar (`supportsStore: false` ayarlayan model uyumluluğu yoksa)
|
||||
- `context_management: [{ type: "compaction", compact_threshold: ... }]` ekler
|
||||
- `store: true` zorunlu kılınır (`supportsStore: false` ayarlayan model compat durumu hariç)
|
||||
- `context_management: [{ type: "compaction", compact_threshold: ... }]` eklenir
|
||||
- Varsayılan `compact_threshold`: `contextWindow` değerinin %70'i (veya mevcut değilse `80000`)
|
||||
|
||||
<Tabs>
|
||||
@ -569,13 +690,13 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
</Tabs>
|
||||
|
||||
<Note>
|
||||
`responsesServerCompaction`, yalnızca `context_management` eklemesini denetler. Doğrudan OpenAI Responses modelleri, uyumluluk `supportsStore: false` ayarlamadığı sürece yine de `store: true` zorlar.
|
||||
`responsesServerCompaction` yalnızca `context_management` eklemesini kontrol eder. Doğrudan OpenAI Responses modelleri, compat `supportsStore: false` ayarlamadığı sürece yine de `store: true` zorunlu kılar.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Katı ajan odaklı GPT modu">
|
||||
`openai/*` ve `openai-codex/*` üzerindeki GPT-5 ailesi çalıştırmaları için OpenClaw daha katı bir gömülü yürütme sözleşmesi kullanabilir:
|
||||
<Accordion title="Sıkı ajan odaklı GPT modu">
|
||||
`openai/*` ve `openai-codex/*` üzerindeki GPT-5 ailesi çalıştırmaları için OpenClaw, daha sıkı bir gömülü yürütme sözleşmesi kullanabilir:
|
||||
|
||||
```json5
|
||||
{
|
||||
@ -588,32 +709,32 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
```
|
||||
|
||||
`strict-agentic` ile OpenClaw:
|
||||
- Bir araç eylemi mevcut olduğunda artık yalnızca plan içeren bir dönüşü başarılı ilerleme olarak değerlendirmez
|
||||
- Dönüşü şimdi-harekete-geç yönlendirmesiyle yeniden dener
|
||||
- Önemli işler için `update_plan` özelliğini otomatik etkinleştirir
|
||||
- Model hareket etmeden planlamaya devam ederse açık bir engelli durum gösterir
|
||||
- Artık bir araç eylemi mevcut olduğunda yalnızca plan içeren bir sırayı başarılı ilerleme olarak değerlendirmez
|
||||
- Sırayı hemen harekete geç yönlendirmesiyle yeniden dener
|
||||
- Önemli işler için `update_plan` özelliğini otomatik olarak etkinleştirir
|
||||
- Model eyleme geçmeden plan yapmaya devam ederse açık bir engellenmiş durum gösterir
|
||||
|
||||
<Note>
|
||||
Yalnızca OpenAI ve Codex GPT-5 ailesi çalıştırmaları için kapsamlandırılmıştır. Diğer sağlayıcılar ve daha eski model aileleri varsayılan davranışı korur.
|
||||
Yalnızca OpenAI ve Codex GPT-5 ailesi çalıştırmalarıyla sınırlıdır. Diğer sağlayıcılar ve daha eski model aileleri varsayılan davranışı korur.
|
||||
</Note>
|
||||
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Yerel ve OpenAI uyumlu rotalar">
|
||||
OpenClaw, doğrudan OpenAI, Codex ve Azure OpenAI uç noktalarını genel OpenAI uyumlu `/v1` proxy'lerinden farklı ele alır:
|
||||
<Accordion title="Yerel ve OpenAI-compatible yollar">
|
||||
OpenClaw, doğrudan OpenAI, Codex ve Azure OpenAI uç noktalarını genel OpenAI-compatible `/v1` proxy'lerinden farklı ele alır:
|
||||
|
||||
**Yerel rotalar** (`openai/*`, `openai-codex/*`, Azure OpenAI):
|
||||
- `reasoning: { effort: "none" }` değerini yalnızca OpenAI `none` effort'u destekleyen modeller için korur
|
||||
- `reasoning.effort: "none"` değerini reddeden modeller veya proxy'ler için devre dışı reasoning'i çıkarır
|
||||
- Araç şemalarını varsayılan olarak katı moda alır
|
||||
- Gizli ilişkilendirme başlıklarını yalnızca doğrulanmış yerel ana makinelere ekler
|
||||
- OpenAI'ye özgü istek biçimlendirmesini korur (`service_tier`, `store`, reasoning-compat, prompt-cache ipuçları)
|
||||
**Yerel yollar** (`openai/*`, `openai-codex/*`, Azure OpenAI):
|
||||
- `reasoning: { effort: "none" }` değerini yalnızca OpenAI `none` effort desteği olan modeller için korur
|
||||
- `reasoning.effort: "none"` değerini reddeden modeller veya proxy'ler için devre dışı reasoning'i atlar
|
||||
- Araç şemalarını varsayılan olarak sıkı moda ayarlar
|
||||
- Gizli atıf üstbilgilerini yalnızca doğrulanmış yerel ana makinelerde ekler
|
||||
- OpenAI'ya özgü istek şekillendirmesini korur (`service_tier`, `store`, reasoning-compat, istem önbelleği ipuçları)
|
||||
|
||||
**Proxy/uyumlu rotalar:**
|
||||
- Daha gevşek uyumluluk davranışı kullanır
|
||||
- Katı araç şemalarını veya yalnızca yerel başlıkları zorlamaz
|
||||
**Proxy/compatible yollar:**
|
||||
- Daha gevşek compat davranışı kullanır
|
||||
- Sıkı araç şemalarını veya yalnızca yerel üstbilgileri zorunlu kılmaz
|
||||
|
||||
Azure OpenAI yerel taşıma ve uyumluluk davranışını kullanır ancak gizli ilişkilendirme başlıklarını almaz.
|
||||
Azure OpenAI, yerel taşıma ve compat davranışı kullanır ancak gizli atıf üstbilgilerini almaz.
|
||||
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
@ -622,12 +743,12 @@ Eski `plugins.entries.openai.config.personality`, paylaşılan `agents.defaults.
|
||||
|
||||
<CardGroup cols={2}>
|
||||
<Card title="Model seçimi" href="/tr/concepts/model-providers" icon="layers">
|
||||
Sağlayıcıları, model başvurularını ve failover davranışını seçme.
|
||||
Sağlayıcıları, model ref'lerini ve failover davranışını seçme.
|
||||
</Card>
|
||||
<Card title="Görsel üretimi" href="/tr/tools/image-generation" icon="image">
|
||||
<Card title="Görsel oluşturma" href="/tr/tools/image-generation" icon="image">
|
||||
Paylaşılan görsel aracı parametreleri ve sağlayıcı seçimi.
|
||||
</Card>
|
||||
<Card title="Video üretimi" href="/tr/tools/video-generation" icon="video">
|
||||
<Card title="Video oluşturma" href="/tr/tools/video-generation" icon="video">
|
||||
Paylaşılan video aracı parametreleri ve sağlayıcı seçimi.
|
||||
</Card>
|
||||
<Card title="OAuth ve kimlik doğrulama" href="/tr/gateway/authentication" icon="key">
|
||||
|
||||
@ -1,50 +1,51 @@
|
||||
---
|
||||
read_when:
|
||||
- Testleri çalıştırma veya düzeltme
|
||||
summary: Vitest ile testleri yerelde nasıl çalıştıracağınız ve force/coverage modlarını ne zaman kullanmanız gerektiği
|
||||
summary: Testler yerelde nasıl çalıştırılır (`vitest`) ve force/coverage modları ne zaman kullanılmalıdır
|
||||
title: Testler
|
||||
x-i18n:
|
||||
generated_at: "2026-04-22T04:27:51Z"
|
||||
generated_at: "2026-04-23T13:58:00Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: ed665840ef2c7728da8ec923eb3ea2878d9b20a841cb2fe4116a7f6334567b8e
|
||||
source_hash: e0bcecb0868b3b68361e5ef78afc3170f2a481771bda8f7d54200b1d778d044a
|
||||
source_path: reference/test.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Testler
|
||||
|
||||
- Tam test kiti (suiteler, canlı, Docker): [Testing](/tr/help/testing)
|
||||
- Tam test kiti (suite’ler, canlı, Docker): [Testing](/tr/help/testing)
|
||||
|
||||
- `pnpm test:force`: Varsayılan denetim portunu elinde tutan artakalmış gateway sürecini sonlandırır, ardından sunucu testleri çalışan bir örnekle çakışmasın diye yalıtılmış bir gateway portuyla tam Vitest paketini çalıştırır. Önceki bir gateway çalıştırması 18789 portunu dolu bıraktığında bunu kullanın.
|
||||
- `pnpm test:coverage`: V8 kapsamıyla birim paketini çalıştırır (`vitest.unit.config.ts` üzerinden). Bu, tüm depo için tüm dosyaları kapsayan kapsam değil, yüklenmiş dosya birim kapsam geçididir. Eşikler satırlar/fonksiyonlar/ifadeler için %70, dallar için %55’tir. `coverage.all` false olduğu için geçit, her parçalanmış hat kaynak dosyasını kapsanmamış saymak yerine birim kapsam paketi tarafından yüklenen dosyaları ölçer.
|
||||
- `pnpm test:coverage:changed`: Birim kapsamını yalnızca `origin/main` sonrasındaki değişmiş dosyalar için çalıştırır.
|
||||
- `pnpm test:changed`: Git’te değişen yolları, fark yalnızca yönlendirilebilir kaynak/test dosyalarına dokunuyorsa kapsamlı Vitest hatlarına genişletir. Yapılandırma/kurulum değişiklikleri, gerektiğinde bağlantı düzenlemeleri geniş çapta yeniden çalışsın diye yine yerel kök proje çalıştırmasına geri düşer.
|
||||
- `pnpm changed:lanes`: `origin/main` karşısındaki farkın tetiklediği mimari hatları gösterir.
|
||||
- `pnpm check:changed`: `origin/main` karşısındaki fark için akıllı changed geçidini çalıştırır. Çekirdek işi çekirdek test hatlarıyla, eklenti işini eklenti test hatlarıyla, yalnızca test işini sadece test typecheck/testleriyle çalıştırır, herkese açık Plugin SDK veya plugin-contract değişikliklerini eklenti doğrulamasına genişletir ve yalnızca release metadata sürüm artışlarını hedeflenmiş sürüm/yapılandırma/kök-bağımlılık denetimlerinde tutar.
|
||||
- `pnpm test`: Açık dosya/dizin hedeflerini kapsamlı Vitest hatları üzerinden yönlendirir. Hedefsiz çalıştırmalar sabit shard grupları kullanır ve yerelde paralel yürütme için yaprak yapılandırmalara genişler; eklenti grubu her zaman tek bir dev kök proje süreci yerine eklenti başına shard yapılandırmalarına genişler.
|
||||
- Tam ve eklenti shard çalıştırmaları `.artifacts/vitest-shard-timings.json` içinde yerel zamanlama verilerini günceller; sonraki çalıştırmalar bu zamanlamaları yavaş ve hızlı shard’ları dengelemek için kullanır. Yerel zamanlama artifact’ini yok saymak için `OPENCLAW_TEST_PROJECTS_TIMINGS=0` ayarlayın.
|
||||
- Seçili `plugin-sdk` ve `commands` test dosyaları artık yalnızca `test/setup.ts` tutan özel hafif hatlar üzerinden yönlendirilir; çalışma zamanı ağır durumlar mevcut hatlarında kalır.
|
||||
- Seçili `plugin-sdk` ve `commands` yardımcı kaynak dosyaları ayrıca `pnpm test:changed` komutunu bu hafif hatlardaki açık kardeş testlere eşler; böylece küçük yardımcı düzenlemeleri ağır çalışma zamanı destekli paketleri yeniden çalıştırmaz.
|
||||
- `auto-reply` artık üç özel yapılandırmaya da bölünür (`core`, `top-level`, `reply`); böylece reply harness daha hafif top-level status/token/helper testlerine baskın çıkmaz.
|
||||
- Temel Vitest yapılandırması artık varsayılan olarak `pool: "threads"` ve `isolate: false` kullanır; paylaşılan yalıtımsız çalıştırıcı depo yapılandırmaları genelinde etkindir.
|
||||
- `pnpm test:force`: Varsayılan kontrol portunu tutan takılı kalmış Gateway süreçlerini sonlandırır, ardından sunucu testlerinin çalışan bir örnekle çakışmaması için yalıtılmış bir Gateway portuyla tam Vitest suite’ini çalıştırır. Önceki bir Gateway çalıştırması 18789 portunu dolu bıraktıysa bunu kullanın.
|
||||
- `pnpm test:coverage`: Birim suite’ini V8 coverage ile (`vitest.unit.config.ts` üzerinden) çalıştırır. Bu, depo genelinde tüm dosyaları kapsayan bir coverage kapısı değil, yüklenen dosyalara yönelik birim coverage kapısıdır. Eşikler satırlar/fonksiyonlar/ifadeler için %70, branch’ler için %55’tir. `coverage.all` false olduğu için kapı, bölünmüş lane kaynak dosyalarının tamamını kapsanmamış saymak yerine birim coverage suite’i tarafından yüklenen dosyaları ölçer.
|
||||
- `pnpm test:coverage:changed`: Yalnızca `origin/main` ile kıyaslandığında değişen dosyalar için birim coverage çalıştırır.
|
||||
- `pnpm test:changed`: Diff yalnızca yönlendirilebilir kaynak/test dosyalarına dokunuyorsa değişen git yollarını kapsamlı Vitest lane’lerine genişletir. Yapılandırma/kurulum değişiklikleri ise yerel root project çalıştırmasına geri düşer; böylece bağlantı düzenlemeleri gerektiğinde daha geniş yeniden çalıştırılır.
|
||||
- `pnpm changed:lanes`: `origin/main` karşısındaki diff’in tetiklediği mimari lane’leri gösterir.
|
||||
- `pnpm check:changed`: `origin/main` karşısındaki diff için akıllı değişenler kapısını çalıştırır. Çekirdek değişiklikleri çekirdek test lane’leriyle, extension çalışmalarını extension test lane’leriyle, yalnızca test değişikliklerini sadece test typecheck/testleriyle çalıştırır; genel Plugin SDK veya plugin-contract değişikliklerini extension doğrulamasına genişletir ve sürüm metadatasına yönelik değişikliklerde hedefli sürüm/yapılandırma/root bağımlılığı kontrollerini korur.
|
||||
- `pnpm test`: Açıkça belirtilen dosya/dizin hedeflerini kapsamlı Vitest lane’leri üzerinden yönlendirir. Hedef belirtilmeyen çalıştırmalar sabit shard grupları kullanır ve yerel paralel çalıştırma için leaf config’lere genişler; extension grubu her zaman tek büyük bir root-project süreci yerine extension başına shard config’lerine genişler.
|
||||
- Tam ve extension shard çalıştırmaları yerel zamanlama verisini `.artifacts/vitest-shard-timings.json` içinde günceller; sonraki çalıştırmalar bu zamanlamaları yavaş ve hızlı shard’ları dengelemek için kullanır. Yerel zamanlama artifact’ını yok saymak için `OPENCLAW_TEST_PROJECTS_TIMINGS=0` ayarlayın.
|
||||
- Seçili `plugin-sdk` ve `commands` test dosyaları artık yalnızca `test/setup.ts` tutan özel hafif lane’ler üzerinden yönlendirilir; çalışma zamanı açısından ağır durumlar mevcut lane’lerinde kalır.
|
||||
- Seçili `plugin-sdk` ve `commands` yardımcı kaynak dosyaları da `pnpm test:changed` komutunu bu hafif lane’lerdeki açık kardeş testlere eşler; böylece küçük yardımcı düzenlemeleri, çalışma zamanı destekli ağır suite’lerin yeniden çalıştırılmasını önler.
|
||||
- `auto-reply` artık üç özel config’e de ayrılır (`core`, `top-level`, `reply`); böylece reply harness daha hafif üst düzey durum/token/helper testlerine baskın gelmez.
|
||||
- Temel Vitest config artık varsayılan olarak `pool: "threads"` ve `isolate: false` kullanır; paylaşılan yalıtılmamış runner depo genelindeki config’lerde etkindir.
|
||||
- `pnpm test:channels`, `vitest.channels.config.ts` dosyasını çalıştırır.
|
||||
- `pnpm test:extensions` ve `pnpm test extensions` tüm extension/plugin shard’larını çalıştırır. Ağır kanal extension’ları ve OpenAI özel shard’lar olarak çalışır; diğer extension grupları toplu kalır. Tek bir paketlenmiş plugin hattı için `pnpm test extensions/<id>` kullanın.
|
||||
- `pnpm test:perf:imports`: Açık dosya/dizin hedefleri için kapsamlı hat yönlendirmesini kullanmaya devam ederken Vitest import-duration + import-breakdown raporlamasını etkinleştirir.
|
||||
- `pnpm test:perf:imports:changed`: Aynı import profillemesi, ancak yalnızca `origin/main` sonrasındaki değişmiş dosyalar için.
|
||||
- `pnpm test:perf:changed:bench -- --ref <git-ref>` aynı commit edilmiş git farkı için yönlendirilmiş changed-mode yolunu yerel kök proje çalıştırmasına karşı kıyaslar.
|
||||
- `pnpm test:perf:changed:bench -- --worktree` önce commit etmeden mevcut worktree değişiklik kümesini kıyaslar.
|
||||
- `pnpm test:extensions` ve `pnpm test extensions` tüm extension/plugin shard’larını çalıştırır. Ağır kanal extension’ları ve OpenAI özel shard’lar olarak çalışır; diğer extension grupları toplu kalır. Tek bir paketlenmiş plugin lane’i için `pnpm test extensions/<id>` kullanın.
|
||||
- `pnpm test:perf:imports`: Açık dosya/dizin hedefleri için yine kapsamlı lane yönlendirmesini kullanırken Vitest import süresi + import dökümü raporlamasını etkinleştirir.
|
||||
- `pnpm test:perf:imports:changed`: Aynı import profillemesi, ancak yalnızca `origin/main` ile kıyaslandığında değişen dosyalar için.
|
||||
- `pnpm test:perf:changed:bench -- --ref <git-ref>`: Aynı commit edilmiş git diff’i için yönlendirilmiş changed-mode yolunu yerel root-project çalıştırmasıyla kıyaslar.
|
||||
- `pnpm test:perf:changed:bench -- --worktree`: Mevcut worktree değişiklik kümesini önce commit etmeden kıyaslar.
|
||||
- `pnpm test:perf:profile:main`: Vitest ana iş parçacığı için bir CPU profili yazar (`.artifacts/vitest-main-profile`).
|
||||
- `pnpm test:perf:profile:runner`: Birim çalıştırıcı için CPU + heap profilleri yazar (`.artifacts/vitest-runner-profile`).
|
||||
- Gateway entegrasyonu: `OPENCLAW_TEST_INCLUDE_GATEWAY=1 pnpm test` veya `pnpm test:gateway` ile isteğe bağlı etkinleştirilir.
|
||||
- `pnpm test:e2e`: Gateway uçtan uca smoke testlerini çalıştırır (çoklu örnek WS/HTTP/node eşleştirmesi). Varsayılan olarak `vitest.e2e.config.ts` içinde uyarlamalı worker’larla `threads` + `isolate: false` kullanır; `OPENCLAW_E2E_WORKERS=<n>` ile ayarlayın ve ayrıntılı günlükler için `OPENCLAW_E2E_VERBOSE=1` ayarlayın.
|
||||
- `pnpm test:live`: Sağlayıcı canlı testlerini çalıştırır (minimax/zai). Atlananları çalıştırmak için API anahtarları ve `LIVE=1` (veya sağlayıcıya özgü `*_LIVE_TEST=1`) gerekir.
|
||||
- `pnpm test:docker:openwebui`: Docker’lı OpenClaw + Open WebUI başlatır, Open WebUI üzerinden oturum açar, `/api/models` denetler, ardından `/api/chat/completions` üzerinden gerçek proxy’lenmiş bir sohbet çalıştırır. Kullanılabilir bir canlı model anahtarı gerektirir (örneğin `~/.profile` içindeki OpenAI), harici bir Open WebUI image’ı çeker ve normal birim/e2e paketleri gibi CI açısından kararlı olması beklenmez.
|
||||
- `pnpm test:docker:mcp-channels`: Tohumlanmış bir Gateway kapsayıcısı ve `openclaw mcp serve` başlatan ikinci bir istemci kapsayıcısı başlatır; ardından yönlendirilmiş konuşma keşfini, transcript okumalarını, ek meta verilerini, canlı olay kuyruğu davranışını, giden gönderim yönlendirmesini ve Claude tarzı kanal + izin bildirimlerini gerçek stdio köprüsü üzerinden doğrular. Claude bildirim doğrulaması ham stdio MCP çerçevelerini doğrudan okur; böylece smoke, köprünün gerçekten ne yaydığını yansıtır.
|
||||
- `pnpm test:perf:profile:runner`: Birim runner için CPU + heap profilleri yazar (`.artifacts/vitest-runner-profile`).
|
||||
- Gateway entegrasyonu: `OPENCLAW_TEST_INCLUDE_GATEWAY=1 pnpm test` veya `pnpm test:gateway` ile isteğe bağlı olarak etkinleştirilir.
|
||||
- `pnpm test:e2e`: Gateway uçtan uca smoke testlerini çalıştırır (çoklu örnek WS/HTTP/Node eşleştirmesi). Varsayılan olarak `vitest.e2e.config.ts` içinde `threads` + `isolate: false` ve uyarlanabilir worker’lar kullanır; `OPENCLAW_E2E_WORKERS=<n>` ile ayarlayın ve ayrıntılı loglar için `OPENCLAW_E2E_VERBOSE=1` ayarlayın.
|
||||
- `pnpm test:live`: Sağlayıcı canlı testlerini çalıştırır (minimax/zai). Atlanmaması için API anahtarları ve `LIVE=1` (veya sağlayıcıya özel `*_LIVE_TEST=1`) gerekir.
|
||||
- `pnpm test:docker:all`: Paylaşılan canlı test imajını ve Docker E2E imajını bir kez oluşturur, ardından Docker smoke lane’lerini varsayılan olarak eşzamanlılık 4 ile `OPENCLAW_SKIP_DOCKER_BUILD=1` kullanarak çalıştırır. `OPENCLAW_DOCKER_ALL_PARALLELISM=<n>` ile ayarlayın. `OPENCLAW_DOCKER_ALL_FAIL_FAST=0` ayarlanmadığı sürece çalıştırıcı ilk hatadan sonra havuzlanmış yeni lane planlamayı durdurur ve her lane için `OPENCLAW_DOCKER_ALL_LANE_TIMEOUT_MS` ile değiştirilebilen 120 dakikalık bir zaman aşımı vardır. Başlangıca veya sağlayıcıya duyarlı lane’ler paralel havuzdan sonra tek başına çalışır. Lane başına loglar `.artifacts/docker-tests/<run-id>/` altına yazılır.
|
||||
- `pnpm test:docker:openwebui`: Docker üzerinde çalışan OpenClaw + Open WebUI’ı başlatır, Open WebUI üzerinden oturum açar, `/api/models` yolunu kontrol eder, ardından `/api/chat/completions` üzerinden gerçek bir proxy’lenmiş sohbet çalıştırır. Kullanılabilir bir canlı model anahtarı gerektirir (örneğin `~/.profile` içindeki OpenAI), harici bir Open WebUI imajı çeker ve normal birim/e2e suite’leri gibi CI açısından kararlı olması beklenmez.
|
||||
- `pnpm test:docker:mcp-channels`: Tohumlanmış bir Gateway container’ı ve `openclaw mcp serve` başlatan ikinci bir istemci container’ı çalıştırır; ardından yönlendirilmiş konuşma keşfini, transkript okumalarını, ek metadata’sını, canlı olay kuyruğu davranışını, giden gönderim yönlendirmesini ve gerçek stdio köprüsü üzerinden Claude tarzı kanal + izin bildirimlerini doğrular. Claude bildirim doğrulaması ham stdio MCP karelerini doğrudan okur; böylece smoke testi köprünün gerçekten ne yaydığını yansıtır.
|
||||
|
||||
## Yerel PR geçidi
|
||||
## Yerel PR kapısı
|
||||
|
||||
Yerel PR land/geçit denetimleri için şunları çalıştırın:
|
||||
PR birleştirme/kapı kontrollerini yerelde çalıştırmak için şunları çalıştırın:
|
||||
|
||||
- `pnpm check:changed`
|
||||
- `pnpm check`
|
||||
@ -53,27 +54,27 @@ Yerel PR land/geçit denetimleri için şunları çalıştırın:
|
||||
- `pnpm test`
|
||||
- `pnpm check:docs`
|
||||
|
||||
Eğer `pnpm test` yoğun yüklü bir hostta dalgalanırsa, bunu bir regresyon saymadan önce bir kez yeniden çalıştırın, sonra `pnpm test <path/to/test>` ile yalıtın. Bellek kısıtlı host’lar için şunları kullanın:
|
||||
Eğer `pnpm test` yüklü bir host üzerinde takılmalı biçimde başarısız olursa, bunu regresyon saymadan önce bir kez daha çalıştırın; ardından `pnpm test <path/to/test>` ile izole edin. Bellek kısıtlı host’lar için şunları kullanın:
|
||||
|
||||
- `OPENCLAW_VITEST_MAX_WORKERS=1 pnpm test`
|
||||
- `OPENCLAW_VITEST_FS_MODULE_CACHE_PATH=/tmp/openclaw-vitest-cache pnpm test:changed`
|
||||
|
||||
## Model gecikme kıyası (yerel anahtarlar)
|
||||
## Model gecikmesi kıyaslaması (yerel anahtarlar)
|
||||
|
||||
Betik: [`scripts/bench-model.ts`](https://github.com/openclaw/openclaw/blob/main/scripts/bench-model.ts)
|
||||
|
||||
Kullanım:
|
||||
|
||||
- `source ~/.profile && pnpm tsx scripts/bench-model.ts --runs 10`
|
||||
- İsteğe bağlı env: `MINIMAX_API_KEY`, `MINIMAX_BASE_URL`, `MINIMAX_MODEL`, `ANTHROPIC_API_KEY`
|
||||
- İsteğe bağlı ortam değişkenleri: `MINIMAX_API_KEY`, `MINIMAX_BASE_URL`, `MINIMAX_MODEL`, `ANTHROPIC_API_KEY`
|
||||
- Varsayılan istem: “Reply with a single word: ok. No punctuation or extra text.”
|
||||
|
||||
Son çalışma (2025-12-31, 20 çalıştırma):
|
||||
Son çalıştırma (2025-12-31, 20 çalıştırma):
|
||||
|
||||
- minimax medyan 1279ms (en düşük 1114, en yüksek 2431)
|
||||
- opus medyan 2454ms (en düşük 1224, en yüksek 3170)
|
||||
- minimax medyan 1279ms (min 1114, maks 2431)
|
||||
- opus medyan 2454ms (min 1224, maks 3170)
|
||||
|
||||
## CLI başlangıç kıyası
|
||||
## CLI başlangıç kıyaslaması
|
||||
|
||||
Betik: [`scripts/bench-cli-startup.ts`](https://github.com/openclaw/openclaw/blob/main/scripts/bench-cli-startup.ts)
|
||||
|
||||
@ -98,17 +99,17 @@ Kullanım:
|
||||
|
||||
- `startup`: `--version`, `--help`, `health`, `health --json`, `status --json`, `status`
|
||||
- `real`: `health`, `status`, `status --json`, `sessions`, `sessions --json`, `agents list --json`, `gateway status`, `gateway status --json`, `gateway health --json`, `config get gateway.port`
|
||||
- `all`: her iki ön ayar
|
||||
- `all`: her iki ön ayar da
|
||||
|
||||
Çıktı, her komut için `sampleCount`, ortalama, p50, p95, min/max, exit-code/signal dağılımı ve en yüksek RSS özetlerini içerir. İsteğe bağlı `--cpu-prof-dir` / `--heap-prof-dir`, çalıştırma başına V8 profilleri yazar; böylece zamanlama ve profil yakalama aynı harness’i kullanır.
|
||||
Çıktı, her komut için `sampleCount`, ortalama, p50, p95, min/maks, exit-code/signal dağılımı ve maksimum RSS özetlerini içerir. İsteğe bağlı `--cpu-prof-dir` / `--heap-prof-dir`, her çalıştırma için V8 profilleri yazar; böylece zamanlama ve profil yakalama aynı harness’i kullanır.
|
||||
|
||||
Kaydedilmiş çıktı kuralları:
|
||||
Kaydedilen çıktı kuralları:
|
||||
|
||||
- `pnpm test:startup:bench:smoke`, hedefli smoke artifact’ini `.artifacts/cli-startup-bench-smoke.json` içine yazar
|
||||
- `pnpm test:startup:bench:save`, tam paket artifact’ini `.artifacts/cli-startup-bench-all.json` içine `runs=5` ve `warmup=1` ile yazar
|
||||
- `pnpm test:startup:bench:update`, depo içinde tutulan temel fixture’ı `test/fixtures/cli-startup-bench.json` içinde `runs=5` ve `warmup=1` ile yeniler
|
||||
- `pnpm test:startup:bench:smoke`, hedeflenmiş smoke artifact’ını `.artifacts/cli-startup-bench-smoke.json` yoluna yazar
|
||||
- `pnpm test:startup:bench:save`, tam suite artifact’ını `runs=5` ve `warmup=1` ile `.artifacts/cli-startup-bench-all.json` yoluna yazar
|
||||
- `pnpm test:startup:bench:update`, depoya işlenmiş baseline fixture’ını `runs=5` ve `warmup=1` ile `test/fixtures/cli-startup-bench.json` yolunda yeniler
|
||||
|
||||
Depoda tutulan fixture:
|
||||
Depoya işlenmiş fixture:
|
||||
|
||||
- `test/fixtures/cli-startup-bench.json`
|
||||
- `pnpm test:startup:bench:update` ile yenileyin
|
||||
@ -116,19 +117,19 @@ Depoda tutulan fixture:
|
||||
|
||||
## Onboarding E2E (Docker)
|
||||
|
||||
Docker isteğe bağlıdır; buna yalnızca kapsayıcılaştırılmış onboarding smoke testleri için ihtiyaç vardır.
|
||||
Docker isteğe bağlıdır; buna yalnızca container tabanlı onboarding smoke testleri için ihtiyaç vardır.
|
||||
|
||||
Temiz bir Linux kapsayıcısında tam soğuk başlangıç akışı:
|
||||
Temiz bir Linux container’ında tam soğuk başlangıç akışı:
|
||||
|
||||
```bash
|
||||
scripts/e2e/onboard-docker.sh
|
||||
```
|
||||
|
||||
Bu betik etkileşimli sihirbazı bir pseudo-tty üzerinden sürer, config/workspace/session dosyalarını doğrular, ardından gateway’i başlatır ve `openclaw health` çalıştırır.
|
||||
Bu betik, etkileşimli sihirbazı bir pseudo-tty üzerinden yürütür, config/workspace/session dosyalarını doğrular, ardından Gateway’i başlatır ve `openclaw health` çalıştırır.
|
||||
|
||||
## QR içe aktarma smoke (Docker)
|
||||
## QR içe aktarma smoke testi (Docker)
|
||||
|
||||
`qrcode-terminal` bileşeninin desteklenen Docker Node çalışma zamanlarında (varsayılan Node 24, uyumlu Node 22) yüklendiğini doğrular:
|
||||
`qrcode-terminal` bileşeninin desteklenen Docker Node çalışma zamanlarında yüklendiğini doğrular (varsayılan Node 24, uyumlu Node 22):
|
||||
|
||||
```bash
|
||||
pnpm test:docker:qr
|
||||
|
||||
@ -1,30 +1,30 @@
|
||||
---
|
||||
read_when:
|
||||
- Agent aracılığıyla görüntü oluşturma
|
||||
- Görüntü oluşturma provider'larını ve modellerini yapılandırma
|
||||
- Görselleri aracı üzerinden oluşturma
|
||||
- Görsel oluşturma sağlayıcılarını ve modellerini yapılandırma
|
||||
- '`image_generate` aracı parametrelerini anlama'
|
||||
summary: Yapılandırılmış provider'ları kullanarak görüntüler oluşturun ve düzenleyin (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra, xAI)
|
||||
title: Görüntü Oluşturma
|
||||
summary: Yapılandırılmış sağlayıcıları (OpenAI, Google Gemini, fal, MiniMax, ComfyUI, Vydra, xAI) kullanarak görseller oluşturun ve düzenleyin
|
||||
title: Görsel Oluşturma
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T09:11:18Z"
|
||||
generated_at: "2026-04-23T13:58:00Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 228049c74dd3437544cda6418da665aed375c0494ef36a6927d15c28d7783bbd
|
||||
source_hash: 0fbd8eda2cb0867d1426b9349f6778c231051d600ebe451534efbee0e215c871
|
||||
source_path: tools/image-generation.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Görüntü Oluşturma
|
||||
# Görsel Oluşturma
|
||||
|
||||
`image_generate` aracı, agent'ın yapılandırılmış provider'larınızı kullanarak görüntüler oluşturmasına ve düzenlemesine izin verir. Oluşturulan görüntüler, agent yanıtında otomatik olarak medya eki olarak teslim edilir.
|
||||
`image_generate` aracı, aracının yapılandırılmış sağlayıcılarınızı kullanarak görseller oluşturmasına ve düzenlemesine olanak tanır. Oluşturulan görseller, aracının yanıtında otomatik olarak medya ekleri olarak teslim edilir.
|
||||
|
||||
<Note>
|
||||
Araç yalnızca en az bir görüntü oluşturma provider'ı kullanılabilir olduğunda görünür. Agent araçlarınızda `image_generate` görünmüyorsa `agents.defaults.imageGenerationModel` yapılandırın veya bir provider API anahtarı ayarlayın.
|
||||
Araç yalnızca en az bir görsel oluşturma sağlayıcısı mevcut olduğunda görünür. Aracınızın araçlarında `image_generate` görmüyorsanız, `agents.defaults.imageGenerationModel` yapılandırın veya bir sağlayıcı API anahtarı ayarlayın.
|
||||
</Note>
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
1. En az bir provider için API anahtarı ayarlayın (örneğin `OPENAI_API_KEY` veya `GEMINI_API_KEY`).
|
||||
1. En az bir sağlayıcı için bir API anahtarı ayarlayın (örneğin `OPENAI_API_KEY` veya `GEMINI_API_KEY`).
|
||||
2. İsteğe bağlı olarak tercih ettiğiniz modeli ayarlayın:
|
||||
|
||||
```json5
|
||||
@ -39,23 +39,23 @@ Araç yalnızca en az bir görüntü oluşturma provider'ı kullanılabilir oldu
|
||||
}
|
||||
```
|
||||
|
||||
3. Agent'a şunu sorun: _"Dost canlısı bir ıstakoz maskotu görüntüsü oluştur."_
|
||||
3. Aracıya şunu sorun: _"Dost canlısı bir ıstakoz maskotunun görselini oluştur."_
|
||||
|
||||
Agent `image_generate` aracını otomatik olarak çağırır. Araç allowlist'e ekleme gerekmez — bir provider kullanılabilir olduğunda varsayılan olarak etkindir.
|
||||
Aracı `image_generate` aracını otomatik olarak çağırır. Araç izin listesi gerekmez — bir sağlayıcı mevcut olduğunda varsayılan olarak etkindir.
|
||||
|
||||
## Desteklenen provider'lar
|
||||
## Desteklenen sağlayıcılar
|
||||
|
||||
| Provider | Varsayılan model | Düzenleme desteği | API anahtarı |
|
||||
| -------- | -------------------------------- | ---------------------------------- | ------------------------------------------------------ |
|
||||
| OpenAI | `gpt-image-2` | Evet (en fazla 5 görüntü) | `OPENAI_API_KEY` |
|
||||
| Google | `gemini-3.1-flash-image-preview` | Evet | `GEMINI_API_KEY` veya `GOOGLE_API_KEY` |
|
||||
| fal | `fal-ai/flux/dev` | Evet | `FAL_KEY` |
|
||||
| MiniMax | `image-01` | Evet (özne referansı) | `MINIMAX_API_KEY` veya MiniMax OAuth (`minimax-portal`) |
|
||||
| ComfyUI | `workflow` | Evet (1 görüntü, workflow tarafından yapılandırılır) | bulut için `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` |
|
||||
| Vydra | `grok-imagine` | Hayır | `VYDRA_API_KEY` |
|
||||
| xAI | `grok-imagine-image` | Evet (en fazla 5 görüntü) | `XAI_API_KEY` |
|
||||
| Sağlayıcı | Varsayılan model | Düzenleme desteği | API anahtarı |
|
||||
| --------- | ------------------------------- | ---------------------------------- | ----------------------------------------------------- |
|
||||
| OpenAI | `gpt-image-2` | Evet (en fazla 5 görsel) | `OPENAI_API_KEY` |
|
||||
| Google | `gemini-3.1-flash-image-preview`| Evet | `GEMINI_API_KEY` veya `GOOGLE_API_KEY` |
|
||||
| fal | `fal-ai/flux/dev` | Evet | `FAL_KEY` |
|
||||
| MiniMax | `image-01` | Evet (özne referansı) | `MINIMAX_API_KEY` veya MiniMax OAuth (`minimax-portal`) |
|
||||
| ComfyUI | `workflow` | Evet (1 görsel, iş akışı yapılandırmalı) | bulut için `COMFY_API_KEY` veya `COMFY_CLOUD_API_KEY` |
|
||||
| Vydra | `grok-imagine` | Hayır | `VYDRA_API_KEY` |
|
||||
| xAI | `grok-imagine-image` | Evet (en fazla 5 görsel) | `XAI_API_KEY` |
|
||||
|
||||
Çalışma zamanında kullanılabilir provider'ları ve modelleri incelemek için `action: "list"` kullanın:
|
||||
Çalışma zamanında kullanılabilir sağlayıcıları ve modelleri incelemek için `action: "list"` kullanın:
|
||||
|
||||
```
|
||||
/tool image_generate action=list
|
||||
@ -63,22 +63,22 @@ Agent `image_generate` aracını otomatik olarak çağırır. Araç allowlist'e
|
||||
|
||||
## Araç parametreleri
|
||||
|
||||
| Parametre | Tür | Açıklama |
|
||||
| ------------ | -------- | --------------------------------------------------------------------------------- |
|
||||
| `prompt` | string | Görüntü oluşturma istemi (`action: "generate"` için gereklidir) |
|
||||
| `action` | string | Provider'ları incelemek için `"generate"` (varsayılan) veya `"list"` |
|
||||
| `model` | string | Provider/model geçersiz kılması, örn. `openai/gpt-image-2` |
|
||||
| `image` | string | Düzenleme modu için tek referans görüntü yolu veya URL'si |
|
||||
| `images` | string[] | Düzenleme modu için birden çok referans görüntü (en fazla 5) |
|
||||
| `size` | string | Boyut ipucu: `1024x1024`, `1536x1024`, `1024x1536`, `2048x2048`, `3840x2160` |
|
||||
| Parametre | Tür | Açıklama |
|
||||
| ------------ | -------- | ----------------------------------------------------------------------------------- |
|
||||
| `prompt` | string | Görsel oluşturma istemi (`action: "generate"` için gereklidir) |
|
||||
| `action` | string | Sağlayıcıları incelemek için `"generate"` (varsayılan) veya `"list"` |
|
||||
| `model` | string | Sağlayıcı/model geçersiz kılması, ör. `openai/gpt-image-2` |
|
||||
| `image` | string | Düzenleme modu için tek referans görsel yolu veya URL |
|
||||
| `images` | string[] | Düzenleme modu için birden çok referans görsel (en fazla 5) |
|
||||
| `size` | string | Boyut ipucu: `1024x1024`, `1536x1024`, `1024x1536`, `2048x2048`, `3840x2160` |
|
||||
| `aspectRatio`| string | En-boy oranı: `1:1`, `2:3`, `3:2`, `3:4`, `4:3`, `4:5`, `5:4`, `9:16`, `16:9`, `21:9` |
|
||||
| `resolution` | string | Çözünürlük ipucu: `1K`, `2K` veya `4K` |
|
||||
| `count` | number | Oluşturulacak görüntü sayısı (1–4) |
|
||||
| `filename` | string | Çıktı dosya adı ipucu |
|
||||
| `resolution` | string | Çözünürlük ipucu: `1K`, `2K` veya `4K` |
|
||||
| `count` | number | Oluşturulacak görsel sayısı (1–4) |
|
||||
| `filename` | string | Çıktı dosya adı ipucu |
|
||||
|
||||
Tüm provider'lar tüm parametreleri desteklemez. Bir geri dönüş provider'ı tam istenen geometri yerine yakın bir geometri seçeneğini desteklediğinde OpenClaw, gönderimden önce en yakın desteklenen boyuta, en-boy oranına veya çözünürlüğe yeniden eşler. Gerçekten desteklenmeyen geçersiz kılmalar ise yine araç sonucunda raporlanır.
|
||||
Tüm sağlayıcılar tüm parametreleri desteklemez. Bir yedek sağlayıcı tam istenen seçenek yerine yakın bir geometri seçeneğini desteklediğinde, OpenClaw göndermeden önce en yakın desteklenen boyuta, en-boy oranına veya çözünürlüğe yeniden eşler. Gerçekten desteklenmeyen geçersiz kılmalar yine de araç sonucunda bildirilir.
|
||||
|
||||
Araç sonuçları uygulanan ayarları bildirir. OpenClaw provider geri dönüşü sırasında geometriyi yeniden eşlediğinde, döndürülen `size`, `aspectRatio` ve `resolution` değerleri gerçekten gönderileni yansıtır; `details.normalization` ise istenenden uygulanana yapılan çeviriyi yakalar.
|
||||
Araç sonuçları uygulanan ayarları bildirir. OpenClaw, sağlayıcı yedeğine geçiş sırasında geometriyi yeniden eşlediğinde, döndürülen `size`, `aspectRatio` ve `resolution` değerleri gerçekte gönderileni yansıtır ve `details.normalization` istekten uygulanan değere yapılan çeviriyi yakalar.
|
||||
|
||||
## Yapılandırma
|
||||
|
||||
@ -97,93 +97,96 @@ Araç sonuçları uygulanan ayarları bildirir. OpenClaw provider geri dönüş
|
||||
}
|
||||
```
|
||||
|
||||
### Provider seçim sırası
|
||||
### Sağlayıcı seçim sırası
|
||||
|
||||
Bir görüntü oluşturulurken OpenClaw provider'ları şu sırayla dener:
|
||||
Bir görsel oluşturulurken OpenClaw sağlayıcıları şu sırayla dener:
|
||||
|
||||
1. Araç çağrısından gelen **`model` parametresi** (agent bir tane belirtirse)
|
||||
2. Yapılandırmadan **`imageGenerationModel.primary`**
|
||||
1. Araç çağrısındaki **`model` parametresi** (araç belirtiyorsa)
|
||||
2. Yapılandırmadaki **`imageGenerationModel.primary`**
|
||||
3. Sırayla **`imageGenerationModel.fallbacks`**
|
||||
4. **Otomatik algılama** — yalnızca auth destekli provider varsayılanlarını kullanır:
|
||||
- önce geçerli varsayılan provider
|
||||
- sonra provider-id sırasına göre kayıtlı kalan görüntü oluşturma provider'ları
|
||||
4. **Otomatik algılama** — yalnızca kimlik doğrulama destekli sağlayıcı varsayılanlarını kullanır:
|
||||
- önce geçerli varsayılan sağlayıcı
|
||||
- ardından sağlayıcı kimliği sırasına göre kalan kayıtlı görsel oluşturma sağlayıcıları
|
||||
|
||||
Bir provider başarısız olursa (kimlik doğrulama hatası, hız sınırı vb.), sonraki aday otomatik olarak denenir. Hepsi başarısız olursa, hata her denemeden ayrıntıları içerir.
|
||||
Bir sağlayıcı başarısız olursa (kimlik doğrulama hatası, hız sınırı vb.), sıradaki aday otomatik olarak denenir. Tümü başarısız olursa, hata her denemeye ilişkin ayrıntıları içerir.
|
||||
|
||||
Notlar:
|
||||
|
||||
- Otomatik algılama auth farkındalığına sahiptir. Bir provider varsayılanı ancak
|
||||
OpenClaw o provider için gerçekten kimlik doğrulaması yapabiliyorsa aday listesine girer.
|
||||
- Otomatik algılama varsayılan olarak etkindir. Görüntü oluşturmanın yalnızca açık `model`, `primary` ve `fallbacks`
|
||||
girdilerini kullanmasını istiyorsanız
|
||||
`agents.defaults.mediaGenerationAutoProviderFallback: false` ayarlayın.
|
||||
- Şu anda kayıtlı provider'ları, bunların
|
||||
varsayılan modellerini ve auth env-var ipuçlarını incelemek için `action: "list"` kullanın.
|
||||
- Otomatik algılama kimlik doğrulama farkındadır. Bir sağlayıcı varsayılanı yalnızca
|
||||
OpenClaw o sağlayıcı için gerçekten kimlik doğrulaması yapabildiğinde aday listesine girer.
|
||||
- Otomatik algılama varsayılan olarak etkindir. Görsel oluşturmanın yalnızca açıkça belirtilen `model`, `primary` ve `fallbacks`
|
||||
girdilerini kullanmasını istiyorsanız `agents.defaults.mediaGenerationAutoProviderFallback: false`
|
||||
ayarlayın.
|
||||
- Şu anda kayıtlı sağlayıcıları, bunların varsayılan modellerini ve kimlik doğrulama ortam değişkeni ipuçlarını incelemek için `action: "list"` kullanın.
|
||||
|
||||
### Görüntü düzenleme
|
||||
### Görsel düzenleme
|
||||
|
||||
OpenAI, Google, fal, MiniMax, ComfyUI ve xAI referans görüntüleri düzenlemeyi destekler. Bir referans görüntü yolu veya URL'si geçin:
|
||||
OpenAI, Google, fal, MiniMax, ComfyUI ve xAI referans görselleri düzenlemeyi destekler. Bir referans görsel yolu veya URL'si verin:
|
||||
|
||||
```
|
||||
"Bu fotoğrafın suluboya sürümünü oluştur" + image: "/path/to/photo.jpg"
|
||||
```
|
||||
|
||||
OpenAI, Google ve xAI, `images` parametresi üzerinden en fazla 5 referans görüntüyü destekler. fal, MiniMax ve ComfyUI 1 tane destekler.
|
||||
OpenAI, Google ve xAI `images` parametresi üzerinden en fazla 5 referans görseli destekler. fal, MiniMax ve ComfyUI 1 görsel destekler.
|
||||
|
||||
### OpenAI `gpt-image-2`
|
||||
|
||||
OpenAI görüntü oluşturma varsayılan olarak `openai/gpt-image-2` kullanır. Daha eski
|
||||
OpenAI görsel oluşturma varsayılan olarak `openai/gpt-image-2` kullanır. Eski
|
||||
`openai/gpt-image-1` modeli hâlâ açıkça seçilebilir, ancak yeni OpenAI
|
||||
görüntü oluşturma ve görüntü düzenleme istekleri `gpt-image-2` kullanmalıdır.
|
||||
görsel oluşturma ve görsel düzenleme istekleri `gpt-image-2` kullanmalıdır.
|
||||
|
||||
`gpt-image-2`, aynı `image_generate` aracı üzerinden hem metinden görüntü üretimini hem de referans görüntü
|
||||
düzenlemeyi destekler. OpenClaw `prompt`,
|
||||
`count`, `size` ve referans görüntüleri OpenAI'ye iletir. OpenAI
|
||||
`aspectRatio` veya `resolution` değerlerini doğrudan almaz; mümkün olduğunda OpenClaw bunları desteklenen bir
|
||||
`size` içine eşler, aksi halde araç bunları yok sayılan geçersiz kılmalar olarak raporlar.
|
||||
`gpt-image-2`, aynı `image_generate` aracı üzerinden hem metinden görsel oluşturmayı hem de
|
||||
referans görsel düzenlemeyi destekler. OpenClaw `prompt`,
|
||||
`count`, `size` ve referans görselleri OpenAI'ye iletir. OpenAI doğrudan
|
||||
`aspectRatio` veya `resolution` almaz; mümkün olduğunda OpenClaw bunları desteklenen bir
|
||||
`size` değerine eşler, aksi takdirde araç bunları yok sayılan geçersiz kılmalar olarak bildirir.
|
||||
|
||||
Bir adet 4K yatay görüntü oluşturun:
|
||||
Bir adet 4K yatay görsel oluşturun:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="OpenClaw görüntü oluşturma için temiz bir editoryal poster" size=3840x2160 count=1
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="OpenClaw görsel oluşturma için temiz bir editoryal afiş" size=3840x2160 count=1
|
||||
```
|
||||
|
||||
İki kare görüntü oluşturun:
|
||||
İki kare görsel oluşturun:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Sakin bir üretkenlik uygulaması simgesi için iki görsel yön" size=1024x1024 count=2
|
||||
```
|
||||
|
||||
Bir yerel referans görüntüyü düzenleyin:
|
||||
Bir yerel referans görseli düzenleyin:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Özneyi koru, arka planı parlak bir stüdyo düzeniyle değiştir" image=/path/to/reference.png size=1024x1536
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="Özneyi koru, arka planı aydınlık bir stüdyo düzeniyle değiştir" image=/path/to/reference.png size=1024x1536
|
||||
```
|
||||
|
||||
Birden çok referansla düzenleyin:
|
||||
|
||||
```
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="İlk görüntüdeki karakter kimliğini ikinci görüntüdeki renk paletiyle birleştir" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024
|
||||
/tool image_generate action=generate model=openai/gpt-image-2 prompt="İlk görseldeki karakter kimliğini ikinci görseldeki renk paletiyle birleştir" images='["/path/to/character.png","/path/to/palette.jpg"]' size=1536x1024
|
||||
```
|
||||
|
||||
MiniMax görüntü oluşturma, her iki paketli MiniMax auth yolu üzerinden de kullanılabilir:
|
||||
OpenAI görsel oluşturmayı `api.openai.com` yerine bir Azure OpenAI dağıtımı
|
||||
üzerinden yönlendirmek için OpenAI sağlayıcı belgelerindeki
|
||||
[Azure OpenAI endpoints](/tr/providers/openai#azure-openai-endpoints) bölümüne bakın.
|
||||
|
||||
- API anahtarlı kurulumlar için `minimax/image-01`
|
||||
MiniMax görsel oluşturma, paketlenmiş her iki MiniMax kimlik doğrulama yolu üzerinden de kullanılabilir:
|
||||
|
||||
- API anahtarı kurulumları için `minimax/image-01`
|
||||
- OAuth kurulumları için `minimax-portal/image-01`
|
||||
|
||||
## Provider yetenekleri
|
||||
## Sağlayıcı yetenekleri
|
||||
|
||||
| Yetenek | OpenAI | Google | fal | MiniMax | ComfyUI | Vydra | xAI |
|
||||
| --------------------- | -------------------- | -------------------- | ------------------- | -------------------------- | ---------------------------------- | ------- | -------------------- |
|
||||
| Oluşturma | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 9) | Evet (workflow tanımlı çıktılar) | Evet (1) | Evet (en fazla 4) |
|
||||
| Düzenleme/referans | Evet (en fazla 5 görüntü) | Evet (en fazla 5 görüntü) | Evet (1 görüntü) | Evet (1 görüntü, özne referansı) | Evet (1 görüntü, workflow tarafından yapılandırılır) | Hayır | Evet (en fazla 5 görüntü) |
|
||||
| Boyut denetimi | Evet (4K'ya kadar) | Evet | Evet | Hayır | Hayır | Hayır | Hayır |
|
||||
| En-boy oranı | Hayır | Evet | Evet (yalnızca oluşturma) | Evet | Hayır | Hayır | Evet |
|
||||
| Oluşturma | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 4) | Evet (en fazla 9) | Evet (iş akışı tanımlı çıktılar) | Evet (1)| Evet (en fazla 4) |
|
||||
| Düzenleme/referans | Evet (en fazla 5 görsel) | Evet (en fazla 5 görsel) | Evet (1 görsel) | Evet (1 görsel, özne ref.) | Evet (1 görsel, iş akışı yapılandırmalı) | Hayır | Evet (en fazla 5 görsel) |
|
||||
| Boyut denetimi | Evet (4K'ye kadar) | Evet | Evet | Hayır | Hayır | Hayır | Hayır |
|
||||
| En-boy oranı | Hayır | Evet | Evet (yalnızca oluşturma) | Evet | Hayır | Hayır | Evet |
|
||||
| Çözünürlük (1K/2K/4K) | Hayır | Evet | Evet | Hayır | Hayır | Hayır | Evet (1K/2K) |
|
||||
|
||||
### xAI `grok-imagine-image`
|
||||
|
||||
Paketli xAI provider'ı yalnızca istem içeren istekler için `/v1/images/generations`
|
||||
Paketlenmiş xAI sağlayıcısı, yalnızca istem içeren istekler için `/v1/images/generations`
|
||||
ve `image` veya `images` mevcut olduğunda `/v1/images/edits` kullanır.
|
||||
|
||||
- Modeller: `xai/grok-imagine-image`, `xai/grok-imagine-image-pro`
|
||||
@ -191,21 +194,21 @@ ve `image` veya `images` mevcut olduğunda `/v1/images/edits` kullanır.
|
||||
- Referanslar: bir `image` veya en fazla beş `images`
|
||||
- En-boy oranları: `1:1`, `16:9`, `9:16`, `4:3`, `3:4`, `2:3`, `3:2`
|
||||
- Çözünürlükler: `1K`, `2K`
|
||||
- Çıktılar: OpenClaw tarafından yönetilen görüntü ekleri olarak döndürülür
|
||||
- Çıktılar: OpenClaw tarafından yönetilen görsel ekleri olarak döndürülür
|
||||
|
||||
OpenClaw, bu denetimler paylaşılan
|
||||
çapraz-provider `image_generate` sözleşmesinde var olana kadar xAI'ye özgü `quality`, `mask`, `user` veya
|
||||
ek yalnızca yerel en-boy oranlarını kasıtlı olarak sunmaz.
|
||||
sağlayıcılar arası `image_generate` sözleşmesinde yer alana kadar xAI'ye özgü `quality`, `mask`, `user` veya
|
||||
ek yalnızca yerel en-boy oranlarını kasıtlı olarak kullanıma sunmaz.
|
||||
|
||||
## İlgili
|
||||
|
||||
- [Araçlara Genel Bakış](/tr/tools) — kullanılabilir tüm agent araçları
|
||||
- [fal](/tr/providers/fal) — fal görüntü ve video provider kurulumu
|
||||
- [ComfyUI](/tr/providers/comfy) — yerel ComfyUI ve Comfy Cloud workflow kurulumu
|
||||
- [Google (Gemini)](/tr/providers/google) — Gemini görüntü provider kurulumu
|
||||
- [MiniMax](/tr/providers/minimax) — MiniMax görüntü provider kurulumu
|
||||
- [OpenAI](/tr/providers/openai) — OpenAI Images provider kurulumu
|
||||
- [Vydra](/tr/providers/vydra) — Vydra görüntü, video ve konuşma kurulumu
|
||||
- [xAI](/tr/providers/xai) — Grok görüntü, video, arama, kod yürütme ve TTS kurulumu
|
||||
- [Yapılandırma Başvurusu](/tr/gateway/configuration-reference#agent-defaults) — `imageGenerationModel` yapılandırması
|
||||
- [Modeller](/tr/concepts/models) — model yapılandırması ve failover
|
||||
- [Tools Overview](/tr/tools) — kullanılabilir tüm aracı araçları
|
||||
- [fal](/tr/providers/fal) — fal görsel ve video sağlayıcısı kurulumu
|
||||
- [ComfyUI](/tr/providers/comfy) — yerel ComfyUI ve Comfy Cloud iş akışı kurulumu
|
||||
- [Google (Gemini)](/tr/providers/google) — Gemini görsel sağlayıcısı kurulumu
|
||||
- [MiniMax](/tr/providers/minimax) — MiniMax görsel sağlayıcısı kurulumu
|
||||
- [OpenAI](/tr/providers/openai) — OpenAI Images sağlayıcısı kurulumu
|
||||
- [Vydra](/tr/providers/vydra) — Vydra görsel, video ve konuşma kurulumu
|
||||
- [xAI](/tr/providers/xai) — Grok görsel, video, arama, kod yürütme ve TTS kurulumu
|
||||
- [Configuration Reference](/tr/gateway/configuration-reference#agent-defaults) — `imageGenerationModel` yapılandırması
|
||||
- [Models](/tr/concepts/models) — model yapılandırması ve yedek geçişi
|
||||
|
||||
@ -1,27 +1,27 @@
|
||||
---
|
||||
read_when:
|
||||
- Plugin kurma veya yapılandırma
|
||||
- Plugin keşif ve yükleme kurallarını anlama
|
||||
- Codex/Claude uyumlu Plugin paketleriyle çalışma
|
||||
- Plugin'leri yükleme veya yapılandırma
|
||||
- Plugin keşfini ve yükleme kurallarını anlama
|
||||
- Codex/Claude uyumlu plugin paketleriyle çalışma
|
||||
sidebarTitle: Install and Configure
|
||||
summary: OpenClaw Plugin'lerini kurun, yapılandırın ve yönetin
|
||||
summary: OpenClaw plugin'lerini yükleyin, yapılandırın ve yönetin
|
||||
title: Plugin'ler
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T09:11:59Z"
|
||||
generated_at: "2026-04-23T13:58:02Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: dc944b53654552ca5cf6132c6ef16c71745a7bffc249daccaee40c513e04209c
|
||||
source_hash: 63aa1b5ed9e3aaa2117b78137a457582b00ea47d94af7da3780ddae38e8e3665
|
||||
source_path: tools/plugin.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Plugin'ler
|
||||
|
||||
Plugin'ler OpenClaw'u yeni yeteneklerle genişletir: kanallar, model provider'ları,
|
||||
Plugin'ler, OpenClaw'ı yeni yeteneklerle genişletir: kanallar, model sağlayıcıları,
|
||||
araçlar, Skills, konuşma, gerçek zamanlı transkripsiyon, gerçek zamanlı ses,
|
||||
medya anlama, görüntü oluşturma, video oluşturma, web getirme, web
|
||||
arama ve daha fazlası. Bazı Plugin'ler **çekirdektir** (OpenClaw ile gelir), diğerleri
|
||||
ise **haricidir** (topluluk tarafından npm'de yayımlanır).
|
||||
medya anlama, görsel oluşturma, video oluşturma, web getirme, web
|
||||
arama ve daha fazlası. Bazı plugin'ler **çekirdek**tir (OpenClaw ile birlikte gelir), bazıları ise
|
||||
**harici**dir (topluluk tarafından npm üzerinde yayımlanır).
|
||||
|
||||
## Hızlı başlangıç
|
||||
|
||||
@ -32,7 +32,7 @@ ise **haricidir** (topluluk tarafından npm'de yayımlanır).
|
||||
```
|
||||
</Step>
|
||||
|
||||
<Step title="Bir Plugin kurun">
|
||||
<Step title="Bir plugin yükleyin">
|
||||
```bash
|
||||
# npm'den
|
||||
openclaw plugins install @openclaw/voice-call
|
||||
@ -54,7 +54,7 @@ ise **haricidir** (topluluk tarafından npm'de yayımlanır).
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
Sohbete özgü denetimi tercih ediyorsanız `commands.plugins: true` etkinleştirin ve şunları kullanın:
|
||||
Sohbet tabanlı kontrolü tercih ediyorsanız, `commands.plugins: true` ayarını etkinleştirin ve şunları kullanın:
|
||||
|
||||
```text
|
||||
/plugin install clawhub:@openclaw/voice-call
|
||||
@ -62,52 +62,52 @@ Sohbete özgü denetimi tercih ediyorsanız `commands.plugins: true` etkinleşti
|
||||
/plugin enable voice-call
|
||||
```
|
||||
|
||||
Kurulum yolu CLI ile aynı çözücüyü kullanır: yerel yol/arşiv, açık
|
||||
`clawhub:<pkg>` veya yalın paket belirtimi (önce ClawHub, sonra npm geri dönüşü).
|
||||
Yükleme yolu, CLI ile aynı çözücüyü kullanır: yerel yol/arşiv, açık
|
||||
`clawhub:<pkg>` veya çıplak paket tanımı (önce ClawHub, sonra npm yedeği).
|
||||
|
||||
Yapılandırma geçersizse, kurulum normalde kapalı kalacak şekilde başarısız olur ve sizi
|
||||
`openclaw doctor --fix` komutuna yönlendirir. Tek kurtarma istisnası, şuraya katılan Plugin'ler için dar bir paketli-Plugin
|
||||
yeniden kurulum yoludur:
|
||||
Yapılandırma geçersizse, yükleme normalde güvenli şekilde başarısız olur ve sizi
|
||||
`openclaw doctor --fix` komutuna yönlendirir. Tek kurtarma istisnası, eklentiye açıkça katılan plugin'ler için
|
||||
dar kapsamlı bir paketlenmiş plugin yeniden yükleme yoludur:
|
||||
`openclaw.install.allowInvalidConfigRecovery`.
|
||||
|
||||
Paketlenmiş OpenClaw kurulumları her paketli Plugin'in
|
||||
çalışma zamanı bağımlılık ağacını istekli biçimde kurmaz. Paketli ve OpenClaw'a ait bir Plugin,
|
||||
Plugin yapılandırmasından, eski kanal yapılandırmasından veya varsayılan etkin manifest'ten etkin olduğunda,
|
||||
başlatma onu içe aktarmadan önce yalnızca o Plugin'in bildirilen çalışma zamanı bağımlılıklarını onarır.
|
||||
Harici Plugin'ler ve özel yükleme yolları yine de
|
||||
`openclaw plugins install` üzerinden kurulmalıdır.
|
||||
Paketlenmiş OpenClaw kurulumları, birlikte gelen her plugin'in
|
||||
çalışma zamanı bağımlılık ağacını önceden yüklemez. Birlikte gelen, OpenClaw'a ait bir plugin
|
||||
plugin yapılandırması, eski kanal yapılandırması veya varsayılan olarak etkin bir manifest üzerinden etkin olduğunda,
|
||||
başlangıç yalnızca o plugin'in bildirilen çalışma zamanı bağımlılıklarını
|
||||
içe aktarmadan önce onarır. Harici plugin'ler ve özel yükleme yolları yine de
|
||||
`openclaw plugins install` ile yüklenmelidir.
|
||||
|
||||
## Plugin türleri
|
||||
|
||||
OpenClaw iki Plugin biçimini tanır:
|
||||
OpenClaw iki plugin biçimini tanır:
|
||||
|
||||
| Biçim | Nasıl çalışır | Örnekler |
|
||||
| ---------- | ---------------------------------------------------------------- | ------------------------------------------------------ |
|
||||
| **Native** | `openclaw.plugin.json` + çalışma zamanı modülü; süreç içinde yürütülür | Resmi Plugin'ler, topluluk npm paketleri |
|
||||
| **Bundle** | Codex/Claude/Cursor uyumlu düzen; OpenClaw özelliklerine eşlenir | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` |
|
||||
| Biçim | Nasıl çalışır | Örnekler |
|
||||
| ---------- | ----------------------------------------------------------------- | ------------------------------------------------------ |
|
||||
| **Native** | `openclaw.plugin.json` + çalışma zamanı modülü; işlem içinde çalışır | Resmi plugin'ler, topluluk npm paketleri |
|
||||
| **Bundle** | Codex/Claude/Cursor uyumlu düzen; OpenClaw özelliklerine eşlenir | `.codex-plugin/`, `.claude-plugin/`, `.cursor-plugin/` |
|
||||
|
||||
Her ikisi de `openclaw plugins list` altında görünür. Bundle ayrıntıları için bkz. [Plugin Bundles](/tr/plugins/bundles).
|
||||
Her ikisi de `openclaw plugins list` altında görünür. Paket ayrıntıları için bkz. [Plugin Paketleri](/tr/plugins/bundles).
|
||||
|
||||
Bir native Plugin yazıyorsanız [Plugin Geliştirme](/tr/plugins/building-plugins)
|
||||
ve [Plugin SDK'ye Genel Bakış](/tr/plugins/sdk-overview) ile başlayın.
|
||||
Bir Native plugin yazıyorsanız, [Plugin Geliştirme](/tr/plugins/building-plugins)
|
||||
ve [Plugin SDK Genel Bakış](/tr/plugins/sdk-overview) ile başlayın.
|
||||
|
||||
## Resmi Plugin'ler
|
||||
## Resmi plugin'ler
|
||||
|
||||
### Kurulabilir (npm)
|
||||
### Yüklenebilir (npm)
|
||||
|
||||
| Plugin | Paket | Belgeler |
|
||||
| --------------- | --------------------- | ------------------------------------- |
|
||||
| Matrix | `@openclaw/matrix` | [Matrix](/tr/channels/matrix) |
|
||||
| Microsoft Teams | `@openclaw/msteams` | [Microsoft Teams](/tr/channels/msteams) |
|
||||
| Nostr | `@openclaw/nostr` | [Nostr](/tr/channels/nostr) |
|
||||
| Voice Call | `@openclaw/voice-call` | [Voice Call](/tr/plugins/voice-call) |
|
||||
| Zalo | `@openclaw/zalo` | [Zalo](/tr/channels/zalo) |
|
||||
| Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/tr/plugins/zalouser) |
|
||||
| Plugin | Paket | Belgeler |
|
||||
| --------------- | ---------------------- | ------------------------------------ |
|
||||
| Matrix | `@openclaw/matrix` | [Matrix](/tr/channels/matrix) |
|
||||
| Microsoft Teams | `@openclaw/msteams` | [Microsoft Teams](/tr/channels/msteams) |
|
||||
| Nostr | `@openclaw/nostr` | [Nostr](/tr/channels/nostr) |
|
||||
| Voice Call | `@openclaw/voice-call` | [Voice Call](/tr/plugins/voice-call) |
|
||||
| Zalo | `@openclaw/zalo` | [Zalo](/tr/channels/zalo) |
|
||||
| Zalo Personal | `@openclaw/zalouser` | [Zalo Personal](/tr/plugins/zalouser) |
|
||||
|
||||
### Çekirdek (OpenClaw ile gelir)
|
||||
### Çekirdek (OpenClaw ile birlikte gelir)
|
||||
|
||||
<AccordionGroup>
|
||||
<Accordion title="Model provider'ları (varsayılan olarak etkin)">
|
||||
<Accordion title="Model sağlayıcıları (varsayılan olarak etkin)">
|
||||
`anthropic`, `byteplus`, `cloudflare-ai-gateway`, `github-copilot`, `google`,
|
||||
`huggingface`, `kilocode`, `kimi-coding`, `minimax`, `mistral`, `qwen`,
|
||||
`moonshot`, `nvidia`, `openai`, `opencode`, `opencode-go`, `openrouter`,
|
||||
@ -115,22 +115,22 @@ ve [Plugin SDK'ye Genel Bakış](/tr/plugins/sdk-overview) ile başlayın.
|
||||
`vercel-ai-gateway`, `volcengine`, `xiaomi`, `zai`
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Bellek Plugin'leri">
|
||||
- `memory-core` — paketli bellek araması (varsayılan olarak `plugins.slots.memory` üzerinden)
|
||||
- `memory-lancedb` — otomatik geri çağırma/yakalama ile isteğe bağlı kurulan uzun vadeli bellek (`plugins.slots.memory = "memory-lancedb"` ayarlayın)
|
||||
<Accordion title="Bellek plugin'leri">
|
||||
- `memory-core` — paketlenmiş bellek araması (`plugins.slots.memory` aracılığıyla varsayılan)
|
||||
- `memory-lancedb` — istek üzerine yüklenen uzun süreli bellek, otomatik geri çağırma/yakalama ile (`plugins.slots.memory = "memory-lancedb"` ayarlayın)
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Konuşma provider'ları (varsayılan olarak etkin)">
|
||||
<Accordion title="Konuşma sağlayıcıları (varsayılan olarak etkin)">
|
||||
`elevenlabs`, `microsoft`
|
||||
</Accordion>
|
||||
|
||||
<Accordion title="Diğer">
|
||||
- `browser` — browser aracı, `openclaw browser` CLI, `browser.request` Gateway yöntemi, browser çalışma zamanı ve varsayılan browser denetim hizmeti için paketli browser Plugin'i (varsayılan olarak etkindir; değiştirmeden önce devre dışı bırakın)
|
||||
- `browser` — tarayıcı aracı, `openclaw browser` CLI, `browser.request` Gateway yöntemi, tarayıcı çalışma zamanı ve varsayılan tarayıcı kontrol hizmeti için paketlenmiş tarayıcı plugin'i (varsayılan olarak etkin; değiştirmeden önce devre dışı bırakın)
|
||||
- `copilot-proxy` — VS Code Copilot Proxy köprüsü (varsayılan olarak devre dışı)
|
||||
</Accordion>
|
||||
</AccordionGroup>
|
||||
|
||||
Üçüncü taraf Plugin'ler mi arıyorsunuz? Bkz. [Topluluk Plugin'leri](/tr/plugins/community).
|
||||
Üçüncü taraf plugin'ler mi arıyorsunuz? Bkz. [Topluluk Plugin'leri](/tr/plugins/community).
|
||||
|
||||
## Yapılandırma
|
||||
|
||||
@ -148,56 +148,56 @@ ve [Plugin SDK'ye Genel Bakış](/tr/plugins/sdk-overview) ile başlayın.
|
||||
}
|
||||
```
|
||||
|
||||
| Alan | Açıklama |
|
||||
| ---------------- | ------------------------------------------------------ |
|
||||
| `enabled` | Ana anahtar (varsayılan: `true`) |
|
||||
| `allow` | Plugin allowlist'i (isteğe bağlı) |
|
||||
| `deny` | Plugin denylist'i (isteğe bağlı; deny kazanır) |
|
||||
| `load.paths` | Ek Plugin dosyaları/dizinleri |
|
||||
| Alan | Açıklama |
|
||||
| ---------------- | --------------------------------------------------------- |
|
||||
| `enabled` | Ana anahtar (varsayılan: `true`) |
|
||||
| `allow` | Plugin izin listesi (isteğe bağlı) |
|
||||
| `deny` | Plugin engelleme listesi (isteğe bağlı; engelleme kazanır) |
|
||||
| `load.paths` | Ek plugin dosyaları/dizinleri |
|
||||
| `slots` | Ayrıcalıklı slot seçicileri (örn. `memory`, `contextEngine`) |
|
||||
| `entries.\<id\>` | Plugin başına anahtarlar + yapılandırma |
|
||||
| `entries.\<id\>` | Plugin başına açma/kapama + yapılandırma |
|
||||
|
||||
Yapılandırma değişiklikleri **Gateway yeniden başlatması gerektirir**. Gateway yapılandırma
|
||||
izleme + süreç içi yeniden başlatma etkin olarak çalışıyorsa (varsayılan `openclaw gateway` yolu),
|
||||
bu yeniden başlatma genellikle yapılandırma yazımı gerçekleştikten kısa süre sonra otomatik yapılır.
|
||||
izleme + işlem içi yeniden başlatma etkin şekilde çalışıyorsa (varsayılan `openclaw gateway` yolu),
|
||||
bu yeniden başlatma genellikle yapılandırma yazımı tamamlandıktan kısa süre sonra otomatik olarak gerçekleştirilir.
|
||||
|
||||
<Accordion title="Plugin durumları: devre dışı vs eksik vs geçersiz">
|
||||
- **Devre dışı**: Plugin vardır ama etkinleştirme kuralları onu kapatmıştır. Yapılandırma korunur.
|
||||
- **Eksik**: yapılandırma, keşfin bulamadığı bir Plugin kimliğine başvurur.
|
||||
- **Geçersiz**: Plugin vardır ama yapılandırması bildirilen şemayla eşleşmez.
|
||||
- **Devre dışı**: plugin vardır ama etkinleştirme kuralları onu kapatmıştır. Yapılandırma korunur.
|
||||
- **Eksik**: yapılandırma, keşif sırasında bulunmayan bir plugin kimliğine başvurur.
|
||||
- **Geçersiz**: plugin vardır ama yapılandırması bildirilen şemayla eşleşmez.
|
||||
</Accordion>
|
||||
|
||||
## Keşif ve öncelik
|
||||
|
||||
OpenClaw Plugin'leri şu sırayla tarar (ilk eşleşme kazanır):
|
||||
OpenClaw plugin'leri şu sırayla tarar (ilk eşleşme kazanır):
|
||||
|
||||
<Steps>
|
||||
<Step title="Yapılandırma yolları">
|
||||
`plugins.load.paths` — açık dosya veya dizin yolları.
|
||||
</Step>
|
||||
|
||||
<Step title="Çalışma alanı Plugin'leri">
|
||||
<Step title="Çalışma alanı plugin'leri">
|
||||
`\<workspace\>/.openclaw/<plugin-root>/*.ts` ve `\<workspace\>/.openclaw/<plugin-root>/*/index.ts`.
|
||||
</Step>
|
||||
|
||||
<Step title="Global Plugin'ler">
|
||||
<Step title="Genel plugin'ler">
|
||||
`~/.openclaw/<plugin-root>/*.ts` ve `~/.openclaw/<plugin-root>/*/index.ts`.
|
||||
</Step>
|
||||
|
||||
<Step title="Paketli Plugin'ler">
|
||||
OpenClaw ile gelir. Birçoğu varsayılan olarak etkindir (model provider'ları, konuşma).
|
||||
<Step title="Paketlenmiş plugin'ler">
|
||||
OpenClaw ile birlikte gelir. Birçoğu varsayılan olarak etkindir (model sağlayıcıları, konuşma).
|
||||
Diğerleri açık etkinleştirme gerektirir.
|
||||
</Step>
|
||||
</Steps>
|
||||
|
||||
### Etkinleştirme kuralları
|
||||
|
||||
- `plugins.enabled: false` tüm Plugin'leri devre dışı bırakır
|
||||
- `plugins.deny` her zaman `allow` üzerinde kazanır
|
||||
- `plugins.entries.\<id\>.enabled: false` o Plugin'i devre dışı bırakır
|
||||
- Çalışma alanı kaynaklı Plugin'ler varsayılan olarak **devre dışıdır** (açıkça etkinleştirilmelidir)
|
||||
- Paketli Plugin'ler, geçersiz kılınmadıkça yerleşik varsayılan açık kümesini izler
|
||||
- Ayrıcalıklı slot'lar o slot için seçilen Plugin'i zorla etkinleştirebilir
|
||||
- `plugins.enabled: false` tüm plugin'leri devre dışı bırakır
|
||||
- `plugins.deny` her zaman `allow`'a üstün gelir
|
||||
- `plugins.entries.\<id\>.enabled: false` o plugin'i devre dışı bırakır
|
||||
- Çalışma alanı kaynaklı plugin'ler **varsayılan olarak devre dışıdır** (açıkça etkinleştirilmelidir)
|
||||
- Paketlenmiş plugin'ler, üzerine yazılmadıkça yerleşik varsayılan açık kümesini izler
|
||||
- Ayrıcalıklı slot'lar, o slot için seçilen plugin'i zorla etkinleştirebilir
|
||||
|
||||
## Plugin slot'ları (ayrıcalıklı kategoriler)
|
||||
|
||||
@ -208,43 +208,43 @@ Bazı kategoriler ayrıcalıklıdır (aynı anda yalnızca biri etkin olabilir):
|
||||
plugins: {
|
||||
slots: {
|
||||
memory: "memory-core", // veya devre dışı bırakmak için "none"
|
||||
contextEngine: "legacy", // veya bir plugin id
|
||||
contextEngine: "legacy", // veya bir plugin kimliği
|
||||
},
|
||||
},
|
||||
}
|
||||
```
|
||||
|
||||
| Slot | Neyi denetler | Varsayılan |
|
||||
| Slot | Ne kontrol eder | Varsayılan |
|
||||
| --------------- | --------------------- | ------------------- |
|
||||
| `memory` | Etkin bellek Plugin'i | `memory-core` |
|
||||
| `memory` | Active Memory plugin'i | `memory-core` |
|
||||
| `contextEngine` | Etkin bağlam motoru | `legacy` (yerleşik) |
|
||||
|
||||
## CLI başvurusu
|
||||
|
||||
```bash
|
||||
openclaw plugins list # kompakt envanter
|
||||
openclaw plugins list --enabled # yalnızca yüklenen Plugin'ler
|
||||
openclaw plugins list --verbose # Plugin başına ayrıntı satırları
|
||||
openclaw plugins list --enabled # yalnızca yüklü plugin'ler
|
||||
openclaw plugins list --verbose # plugin başına ayrıntı satırları
|
||||
openclaw plugins list --json # makine tarafından okunabilir envanter
|
||||
openclaw plugins inspect <id> # derin ayrıntı
|
||||
openclaw plugins inspect <id> # ayrıntılı inceleme
|
||||
openclaw plugins inspect <id> --json # makine tarafından okunabilir
|
||||
openclaw plugins inspect --all # tüm filo tablosu
|
||||
openclaw plugins inspect --all # filo genelinde tablo
|
||||
openclaw plugins info <id> # inspect takma adı
|
||||
openclaw plugins doctor # tanılamalar
|
||||
openclaw plugins doctor # tanılama
|
||||
|
||||
openclaw plugins install <package> # kurulum (önce ClawHub, sonra npm)
|
||||
openclaw plugins install clawhub:<pkg> # yalnızca ClawHub'dan kur
|
||||
openclaw plugins install <spec> --force # mevcut kurulumu üzerine yaz
|
||||
openclaw plugins install <path> # yerel yoldan kur
|
||||
openclaw plugins install -l <path> # geliştirme için bağla (kopya yok)
|
||||
openclaw plugins install <package> # yükle (önce ClawHub, sonra npm)
|
||||
openclaw plugins install clawhub:<pkg> # yalnızca ClawHub'dan yükle
|
||||
openclaw plugins install <spec> --force # mevcut yüklemenin üzerine yaz
|
||||
openclaw plugins install <path> # yerel yoldan yükle
|
||||
openclaw plugins install -l <path> # geliştirme için bağla (kopyalama yok)
|
||||
openclaw plugins install <plugin> --marketplace <source>
|
||||
openclaw plugins install <plugin> --marketplace https://github.com/<owner>/<repo>
|
||||
openclaw plugins install <spec> --pin # tam çözümlenmiş npm belirtimini kaydet
|
||||
openclaw plugins install <spec> --pin # tam çözümlenmiş npm tanımını kaydet
|
||||
openclaw plugins install <spec> --dangerously-force-unsafe-install
|
||||
openclaw plugins update <id-or-npm-spec> # tek bir Plugin'i güncelle
|
||||
openclaw plugins update <id-or-npm-spec> # bir plugin'i güncelle
|
||||
openclaw plugins update <id-or-npm-spec> --dangerously-force-unsafe-install
|
||||
openclaw plugins update --all # hepsini güncelle
|
||||
openclaw plugins uninstall <id> # yapılandırma/kurulum kayıtlarını kaldır
|
||||
openclaw plugins update --all # tümünü güncelle
|
||||
openclaw plugins uninstall <id> # yapılandırma/yükleme kayıtlarını kaldır
|
||||
openclaw plugins uninstall <id> --keep-files
|
||||
openclaw plugins marketplace list <source>
|
||||
openclaw plugins marketplace list <source> --json
|
||||
@ -253,56 +253,61 @@ openclaw plugins enable <id>
|
||||
openclaw plugins disable <id>
|
||||
```
|
||||
|
||||
Paketli Plugin'ler OpenClaw ile gelir. Birçoğu varsayılan olarak etkindir (örneğin
|
||||
paketli model provider'ları, paketli konuşma provider'ları ve paketli browser
|
||||
Plugin'i). Diğer paketli Plugin'ler yine de `openclaw plugins enable <id>` gerektirir.
|
||||
Paketlenmiş plugin'ler OpenClaw ile birlikte gelir. Birçoğu varsayılan olarak etkindir (örneğin
|
||||
paketlenmiş model sağlayıcıları, paketlenmiş konuşma sağlayıcıları ve paketlenmiş browser
|
||||
plugin'i). Diğer paketlenmiş plugin'ler için yine de `openclaw plugins enable <id>` gerekir.
|
||||
|
||||
`--force`, mevcut kurulu Plugin'i veya hook paketini yerinde üzerine yazar. İzlenen npm
|
||||
Plugin'lerinin rutin yükseltmeleri için `openclaw plugins update <id-or-npm-spec>` kullanın. Kaynak yolu yönetilen kurulum hedefi üzerine
|
||||
kopyalamak yerine yeniden kullandığından `--link` ile desteklenmez.
|
||||
|
||||
`openclaw plugins update <id-or-npm-spec>`, izlenen kurulumlar için geçerlidir. Bir
|
||||
dist-tag veya tam sürüm içeren npm paket belirtimi vermek, paket adını
|
||||
izlenen Plugin kaydına geri çözer ve gelecekteki güncellemeler için yeni belirtimi kaydeder.
|
||||
Sürüm olmadan paket adı geçirmek, tam sabitlenmiş bir kurulumu
|
||||
kayıt defterinin varsayılan sürüm hattına geri taşır. Kurulu npm Plugin'i zaten
|
||||
çözümlenen sürüm ve kaydedilen artifact kimliğiyle eşleşiyorsa, OpenClaw güncellemeyi
|
||||
indirmeden, yeniden kurmadan veya yapılandırmayı yeniden yazmadan atlar.
|
||||
|
||||
`--pin` yalnızca npm içindir. Marketplace kurulumları npm belirtimi yerine
|
||||
marketplace kaynak meta verilerini kalıcılaştırdığı için `--marketplace` ile
|
||||
`--force`, mevcut yüklü bir plugin'in veya hook paketinin üzerine yerinde yazar. İzlenen npm
|
||||
plugin'lerinin rutin yükseltmeleri için `openclaw plugins update <id-or-npm-spec>` kullanın.
|
||||
Kaynak yolu yönetilen yükleme hedefine kopyalamak yerine yeniden kullanan `--link` ile
|
||||
desteklenmez.
|
||||
|
||||
`--dangerously-force-unsafe-install`, yerleşik tehlikeli kod tarayıcısından gelen yanlış
|
||||
pozitif sonuçlar için cam kırma geçersiz kılmasıdır. Plugin kurulumlarının
|
||||
ve Plugin güncellemelerinin yerleşik `critical` bulgularını geçerek devam etmesine izin verir, ancak yine de Plugin `before_install` ilke engellerini veya tarama başarısızlığı engellemelerini atlamaz.
|
||||
`plugins.allow` zaten ayarlıysa, `openclaw plugins install`
|
||||
yüklü plugin kimliğini etkinleştirmeden önce o izin listesine ekler; böylece yüklemeler
|
||||
yeniden başlatmadan sonra hemen yüklenebilir olur.
|
||||
|
||||
Bu CLI bayrağı yalnızca Plugin kurulum/güncelleme akışlarına uygulanır. Gateway destekli Skill
|
||||
bağımlılığı kurulumları bunun yerine eşleşen `dangerouslyForceUnsafeInstall`
|
||||
istek geçersiz kılmasını kullanır; `openclaw skills install` ise ayrı ClawHub
|
||||
Skill indirme/kurulum akışı olarak kalır.
|
||||
`openclaw plugins update <id-or-npm-spec>`, izlenen yüklemeler için geçerlidir. Dist-tag veya tam sürüm içeren
|
||||
bir npm paket tanımı geçirmek, paket adını yeniden izlenen plugin kaydına çözümler ve
|
||||
gelecekteki güncellemeler için yeni tanımı kaydeder.
|
||||
Sürüm belirtilmeden paket adını geçirmek, tam sabitlenmiş bir yüklemeyi yeniden
|
||||
kayıt defterinin varsayılan sürüm hattına taşır. Yüklü npm plugin'i zaten çözümlenen sürümle
|
||||
ve kaydedilmiş yapıt kimliğiyle eşleşiyorsa, OpenClaw güncellemeyi
|
||||
indirmeden, yeniden yüklemeden veya yapılandırmayı yeniden yazmadan atlar.
|
||||
|
||||
Uyumlu bundle'lar da aynı Plugin listeleme/inceleme/etkinleştirme/devre dışı bırakma
|
||||
akışına katılır. Geçerli çalışma zamanı desteği bundle Skills, Claude komut-Skills,
|
||||
Claude `settings.json` varsayılanları, Claude `.lsp.json` ve manifest'te bildirilen
|
||||
`lspServers` varsayılanları, Cursor komut-Skills ve uyumlu Codex kanca
|
||||
`--pin` yalnızca npm içindir. `--marketplace` ile desteklenmez; çünkü
|
||||
marketplace yüklemeleri npm tanımı yerine marketplace kaynak meta verisini saklar.
|
||||
|
||||
`--dangerously-force-unsafe-install`, yerleşik tehlikeli kod tarayıcısının yanlış
|
||||
pozitifleri için kullanılan acil durum geçersiz kılma seçeneğidir. Plugin yüklemelerinin
|
||||
ve plugin güncellemelerinin yerleşik `critical` bulgularını aşarak devam etmesine izin verir, ancak yine de
|
||||
plugin `before_install` ilke engellerini veya tarama başarısızlığı kaynaklı engellemeyi atlamaz.
|
||||
|
||||
Bu CLI bayrağı yalnızca plugin yükleme/güncelleme akışları için geçerlidir. Gateway destekli skill
|
||||
bağımlılığı yüklemeleri bunun yerine eşleşen `dangerouslyForceUnsafeInstall` istek
|
||||
geçersiz kılmasını kullanır; `openclaw skills install` ise ayrı ClawHub
|
||||
skill indirme/yükleme akışı olarak kalır.
|
||||
|
||||
Uyumlu paketler de aynı plugin listeleme/inceleme/etkinleştirme/devre dışı bırakma
|
||||
akışına katılır. Geçerli çalışma zamanı desteği; paket Skills, Claude command-skills,
|
||||
Claude `settings.json` varsayılanları, Claude `.lsp.json` ve manifestte bildirilen
|
||||
`lspServers` varsayılanları, Cursor command-skills ve uyumlu Codex hook
|
||||
dizinlerini içerir.
|
||||
|
||||
`openclaw plugins inspect <id>`, bundle destekli Plugin'ler için algılanan
|
||||
bundle yeteneklerini ve desteklenen veya desteklenmeyen MCP ve LSP sunucu girdilerini de bildirir.
|
||||
`openclaw plugins inspect <id>`, paket destekli plugin'ler için algılanan paket yeteneklerini ve
|
||||
desteklenen veya desteklenmeyen MCP ve LSP sunucu girişlerini de raporlar.
|
||||
|
||||
Marketplace kaynakları
|
||||
`~/.claude/plugins/known_marketplaces.json` içindeki bir Claude bilinen-marketplace adı, yerel bir marketplace kökü veya
|
||||
`marketplace.json` yolu, `owner/repo` gibi bir GitHub kısaltması, bir GitHub depo
|
||||
URL'si veya bir git URL'si olabilir. Uzak marketplace'ler için Plugin girdileri
|
||||
klonlanan marketplace deposu içinde kalmalı ve yalnızca göreli yol kaynakları kullanmalıdır.
|
||||
Marketplace kaynakları, `~/.claude/plugins/known_marketplaces.json` içindeki bir Claude bilinen-marketplace adı,
|
||||
yerel bir marketplace kökü veya `marketplace.json` yolu,
|
||||
`owner/repo` gibi bir GitHub kısa gösterimi, bir GitHub depo
|
||||
URL'si ya da bir git URL'si olabilir. Uzak marketplace'lerde plugin girdileri,
|
||||
klonlanan marketplace deposunun içinde kalmalı ve yalnızca göreli yol kaynaklarını kullanmalıdır.
|
||||
|
||||
Tam ayrıntılar için bkz. [`openclaw plugins` CLI başvurusu](/tr/cli/plugins).
|
||||
Tüm ayrıntılar için [`openclaw plugins` CLI başvurusuna](/tr/cli/plugins) bakın.
|
||||
|
||||
## Plugin API'ye genel bakış
|
||||
## Plugin API genel bakışı
|
||||
|
||||
Native Plugin'ler `register(api)` sunan bir giriş nesnesi dışa aktarır. Eski
|
||||
Plugin'ler hâlâ eski takma ad olarak `activate(api)` kullanabilir, ancak yeni Plugin'ler
|
||||
Native plugin'ler, `register(api)` sunan bir giriş nesnesi dışa aktarır. Daha eski
|
||||
plugin'ler hâlâ eski takma ad olarak `activate(api)` kullanabilir, ancak yeni plugin'ler
|
||||
`register` kullanmalıdır.
|
||||
|
||||
```typescript
|
||||
@ -323,48 +328,49 @@ export default definePluginEntry({
|
||||
});
|
||||
```
|
||||
|
||||
OpenClaw giriş nesnesini yükler ve Plugin
|
||||
etkinleştirmesi sırasında `register(api)` çağrısını yapar. Yükleyici eski Plugin'ler için hâlâ `activate(api)` çağrısına geri döner,
|
||||
ancak paketli Plugin'ler ve yeni harici Plugin'ler `register` çağrısını herkese açık sözleşme olarak görmelidir.
|
||||
OpenClaw giriş nesnesini yükler ve plugin
|
||||
etkinleştirmesi sırasında `register(api)` çağırır. Yükleyici eski plugin'ler için hâlâ `activate(api)` yöntemine geri döner,
|
||||
ancak birlikte gelen plugin'ler ve yeni harici plugin'ler
|
||||
`register`'ı genel sözleşme olarak ele almalıdır.
|
||||
|
||||
Yaygın kayıt yöntemleri:
|
||||
|
||||
| Yöntem | Ne kaydeder |
|
||||
| --------------------------------------- | --------------------------- |
|
||||
| `registerProvider` | Model provider'ı (LLM) |
|
||||
| `registerChannel` | Sohbet kanalı |
|
||||
| `registerTool` | Agent aracı |
|
||||
| `registerHook` / `on(...)` | Yaşam döngüsü kancaları |
|
||||
| `registerSpeechProvider` | Metinden konuşmaya / STT |
|
||||
| `registerRealtimeTranscriptionProvider` | Akışlı STT |
|
||||
| `registerRealtimeVoiceProvider` | Duplex gerçek zamanlı ses |
|
||||
| `registerMediaUnderstandingProvider` | Görüntü/ses analizi |
|
||||
| `registerImageGenerationProvider` | Görüntü oluşturma |
|
||||
| `registerMusicGenerationProvider` | Müzik oluşturma |
|
||||
| `registerVideoGenerationProvider` | Video oluşturma |
|
||||
| `registerWebFetchProvider` | Web getirme / scrape provider'ı |
|
||||
| `registerWebSearchProvider` | Web arama |
|
||||
| `registerHttpRoute` | HTTP uç noktası |
|
||||
| `registerCommand` / `registerCli` | CLI komutları |
|
||||
| `registerContextEngine` | Bağlam motoru |
|
||||
| `registerService` | Arka plan hizmeti |
|
||||
| Yöntem | Ne kaydeder |
|
||||
| --------------------------------------- | -------------------------- |
|
||||
| `registerProvider` | Model sağlayıcısı (LLM) |
|
||||
| `registerChannel` | Sohbet kanalı |
|
||||
| `registerTool` | Aracı aracı |
|
||||
| `registerHook` / `on(...)` | Yaşam döngüsü kancaları |
|
||||
| `registerSpeechProvider` | Metinden konuşmaya / STT |
|
||||
| `registerRealtimeTranscriptionProvider` | Akışlı STT |
|
||||
| `registerRealtimeVoiceProvider` | Çift yönlü gerçek zamanlı ses |
|
||||
| `registerMediaUnderstandingProvider` | Görsel/ses analizi |
|
||||
| `registerImageGenerationProvider` | Görsel oluşturma |
|
||||
| `registerMusicGenerationProvider` | Müzik oluşturma |
|
||||
| `registerVideoGenerationProvider` | Video oluşturma |
|
||||
| `registerWebFetchProvider` | Web getirme / kazıma sağlayıcısı |
|
||||
| `registerWebSearchProvider` | Web arama |
|
||||
| `registerHttpRoute` | HTTP uç noktası |
|
||||
| `registerCommand` / `registerCli` | CLI komutları |
|
||||
| `registerContextEngine` | Bağlam motoru |
|
||||
| `registerService` | Arka plan hizmeti |
|
||||
|
||||
Typed yaşam döngüsü kancaları için kanca guard davranışı:
|
||||
Türlendirilmiş yaşam döngüsü kancaları için kanca koruma davranışı:
|
||||
|
||||
- `before_tool_call`: `{ block: true }` nihaidir; daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_tool_call`: `{ block: false }` no-op'tur ve daha önceki bir engeli temizlemez.
|
||||
- `before_install`: `{ block: true }` nihaidir; daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_install`: `{ block: false }` no-op'tur ve daha önceki bir engeli temizlemez.
|
||||
- `message_sending`: `{ cancel: true }` nihaidir; daha düşük öncelikli işleyiciler atlanır.
|
||||
- `message_sending`: `{ cancel: false }` no-op'tur ve daha önceki bir iptali temizlemez.
|
||||
- `before_tool_call`: `{ block: true }` kesindir; daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_tool_call`: `{ block: false }` etkisizdir ve önceki bir engeli temizlemez.
|
||||
- `before_install`: `{ block: true }` kesindir; daha düşük öncelikli işleyiciler atlanır.
|
||||
- `before_install`: `{ block: false }` etkisizdir ve önceki bir engeli temizlemez.
|
||||
- `message_sending`: `{ cancel: true }` kesindir; daha düşük öncelikli işleyiciler atlanır.
|
||||
- `message_sending`: `{ cancel: false }` etkisizdir ve önceki bir iptali temizlemez.
|
||||
|
||||
Tam typed kanca davranışı için bkz. [SDK'ye Genel Bakış](/tr/plugins/sdk-overview#hook-decision-semantics).
|
||||
Türlendirilmiş kanca davranışının tamamı için bkz. [SDK Genel Bakış](/tr/plugins/sdk-overview#hook-decision-semantics).
|
||||
|
||||
## İlgili
|
||||
|
||||
- [Plugin Geliştirme](/tr/plugins/building-plugins) — kendi Plugin'inizi oluşturun
|
||||
- [Plugin Bundles](/tr/plugins/bundles) — Codex/Claude/Cursor bundle uyumluluğu
|
||||
- [Plugin Manifest'i](/tr/plugins/manifest) — manifest şeması
|
||||
- [Araç Kaydetme](/tr/plugins/building-plugins#registering-agent-tools) — bir Plugin'e agent araçları ekleyin
|
||||
- [Plugin İç Yapıları](/tr/plugins/architecture) — yetenek modeli ve yükleme işlem hattı
|
||||
- [Topluluk Plugin'leri](/tr/plugins/community) — üçüncü taraf listeler
|
||||
- [Plugin Geliştirme](/tr/plugins/building-plugins) — kendi plugin'inizi oluşturun
|
||||
- [Plugin Paketleri](/tr/plugins/bundles) — Codex/Claude/Cursor paket uyumluluğu
|
||||
- [Plugin Manifesti](/tr/plugins/manifest) — manifest şeması
|
||||
- [Araç Kaydetme](/tr/plugins/building-plugins#registering-agent-tools) — bir plugin içinde aracı araçları ekleyin
|
||||
- [Plugin İç Yapısı](/tr/plugins/architecture) — yetenek modeli ve yükleme hattı
|
||||
- [Topluluk Plugin'leri](/tr/plugins/community) — üçüncü taraf listeleri
|
||||
|
||||
@ -1,36 +1,35 @@
|
||||
---
|
||||
read_when:
|
||||
- Sohbet komutlarını kullanma veya yapılandırma
|
||||
- Komut yönlendirmesini veya izinlerini hata ayıklama
|
||||
summary: 'Slash komutları: metin ve yerel komutlar, yapılandırma ve desteklenen komutlar'
|
||||
title: Slash Komutları
|
||||
- Komut yönlendirmesini veya izinleri hata ayıklama
|
||||
summary: 'Eğik çizgi komutları: metin ve yerel, yapılandırma ve desteklenen komutlar'
|
||||
title: Eğik Çizgi Komutları
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T09:12:01Z"
|
||||
generated_at: "2026-04-23T13:58:32Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 0f6b454afa77cf02b2c307efcc99ef35d002cb560c427affaf03ac12b2b666e8
|
||||
source_hash: 13290dcdf649ae66603a92a0aca68460bb63ff476179cc2dded796aaa841d66c
|
||||
source_path: tools/slash-commands.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Slash Komutları
|
||||
# Eğik çizgi komutları
|
||||
|
||||
Komutlar Gateway tarafından işlenir. Çoğu komut, `/` ile başlayan **bağımsız** bir mesaj olarak gönderilmelidir.
|
||||
Yalnızca ana makinede çalışan bash sohbet komutu `! <cmd>` kullanır (`/bash <cmd>` bunun takma adıdır).
|
||||
Yalnızca ana makineye özel bash sohbet komutu `! <cmd>` kullanır (`/bash <cmd>` bunun bir takma adıdır).
|
||||
|
||||
İlişkili iki sistem vardır:
|
||||
Birbiriyle ilişkili iki sistem vardır:
|
||||
|
||||
- **Komutlar**: bağımsız `/...` mesajları.
|
||||
- **Yönergeler**: `/think`, `/fast`, `/verbose`, `/trace`, `/reasoning`, `/elevated`, `/exec`, `/model`, `/queue`.
|
||||
- Yönergeler, model mesajı görmeden önce mesajdan çıkarılır.
|
||||
- Normal sohbet mesajlarında (yalnızca yönerge olmayan), “satır içi ipuçları” olarak değerlendirilir ve kalıcı oturum ayarları olmaz.
|
||||
- Yalnızca yönergelerden oluşan mesajlarda (mesaj yalnızca yönergeler içeriyorsa), oturumda kalıcı olur ve bir onay yanıtı verir.
|
||||
- Yönergeler yalnızca **yetkili göndericiler** için uygulanır. `commands.allowFrom` ayarlıysa kullanılan tek
|
||||
izin listesi odur; aksi halde yetkilendirme kanal izin listeleri/eşleştirme ve `commands.useAccessGroups` üzerinden gelir.
|
||||
Yetkisiz göndericiler, yönergeleri düz metin olarak görür.
|
||||
- Normal sohbet mesajlarında (yalnızca yönerge olmayan), “satır içi ipuçları” olarak değerlendirilir ve oturum ayarlarını **kalıcı hale getirmez**.
|
||||
- Yalnızca yönergeden oluşan mesajlarda (mesaj yalnızca yönergeler içeriyorsa), oturumda kalıcı olur ve bir onay yanıtı verir.
|
||||
- Yönergeler yalnızca **yetkili gönderenler** için uygulanır. `commands.allowFrom` ayarlanmışsa, kullanılan tek izin listesi budur; aksi halde yetkilendirme kanal izin listeleri/eşleştirme ve `commands.useAccessGroups` üzerinden gelir.
|
||||
Yetkisiz gönderenlerde yönergeler düz metin olarak değerlendirilir.
|
||||
|
||||
Ayrıca birkaç **satır içi kısayol** da vardır (yalnızca izin listesinde/yetkili göndericiler için): `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
Bunlar hemen çalışır, model mesajı görmeden önce çıkarılır ve kalan metin normal akıştan devam eder.
|
||||
Ayrıca birkaç **satır içi kısayol** da vardır (yalnızca izin listesinde olan/yetkili gönderenler): `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
Bunlar hemen çalışır, model mesajı görmeden önce çıkarılır ve kalan metin normal akıştan geçmeye devam eder.
|
||||
|
||||
## Yapılandırma
|
||||
|
||||
@ -59,111 +58,109 @@ Bunlar hemen çalışır, model mesajı görmeden önce çıkarılır ve kalan m
|
||||
}
|
||||
```
|
||||
|
||||
- `commands.text` (varsayılan `true`) sohbet mesajlarında `/...` ayrıştırmasını etkinleştirir.
|
||||
- Yerel komut desteği olmayan yüzeylerde (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), bunu `false` yapsanız bile metin komutları çalışmaya devam eder.
|
||||
- `commands.native` (varsayılan `"auto"`) yerel komutları kaydeder.
|
||||
- Otomatik: Discord/Telegram için açık; Slack için kapalıdır (slash komutları ekleyene kadar); yerel desteği olmayan sağlayıcılarda yok sayılır.
|
||||
- Sağlayıcı başına geçersiz kılmak için `channels.discord.commands.native`, `channels.telegram.commands.native` veya `channels.slack.commands.native` ayarlayın (bool veya `"auto"`).
|
||||
- `false`, başlangıçta Discord/Telegram üzerinde daha önce kaydedilmiş komutları temizler. Slack komutları Slack uygulamasında yönetilir ve otomatik kaldırılmaz.
|
||||
- `commands.nativeSkills` (varsayılan `"auto"`) desteklendiğinde **skill** komutlarını yerel olarak kaydeder.
|
||||
- Otomatik: Discord/Telegram için açık; Slack için kapalıdır (Slack her skill için ayrı slash komut gerektirir).
|
||||
- Sağlayıcı başına geçersiz kılmak için `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` veya `channels.slack.commands.nativeSkills` ayarlayın (bool veya `"auto"`).
|
||||
- `commands.bash` (varsayılan `false`) ana makine kabuk komutlarını çalıştırmak için `! <cmd>` komutunu etkinleştirir (`/bash <cmd>` takma addır; `tools.elevated` izin listeleri gerektirir).
|
||||
- `commands.bashForegroundMs` (varsayılan `2000`) arka plan moduna geçmeden önce bash'in ne kadar bekleyeceğini kontrol eder (`0`, hemen arka plana alır).
|
||||
- `commands.config` (varsayılan `false`) `/config` komutunu etkinleştirir (`openclaw.json` okur/yazar).
|
||||
- `commands.mcp` (varsayılan `false`) `/mcp` komutunu etkinleştirir (`mcp.servers` altındaki OpenClaw tarafından yönetilen MCP yapılandırmasını okur/yazar).
|
||||
- `commands.plugins` (varsayılan `false`) `/plugins` komutunu etkinleştirir (plugin keşfi/durumu artı kurulum + etkinleştirme/devre dışı bırakma denetimleri).
|
||||
- `commands.debug` (varsayılan `false`) `/debug` komutunu etkinleştirir (yalnızca çalışma zamanına ait geçersiz kılmalar).
|
||||
- `commands.restart` (varsayılan `true`) `/restart` ve gateway restart aracı eylemlerini etkinleştirir.
|
||||
- `commands.ownerAllowFrom` (isteğe bağlı) yalnızca sahibe açık komut/araç yüzeyleri için açık sahip izin listesini ayarlar. Bu, `commands.allowFrom` değerinden ayrıdır.
|
||||
- Kanal başına `channels.<channel>.commands.enforceOwnerForCommands` (isteğe bağlı, varsayılan `false`), yalnızca sahibe açık komutların o yüzeyde çalışması için **sahip kimliği** gerektirir. `true` olduğunda gönderen ya çözümlenmiş bir sahip adayıyla eşleşmeli (örneğin `commands.ownerAllowFrom` içindeki bir girdi veya sağlayıcının yerel sahip meta verisi) ya da dahili mesaj kanalında iç `operator.admin` kapsamına sahip olmalıdır. Kanal `allowFrom` içindeki joker bir girdi veya boş/çözümlenmemiş sahip aday listesi **yeterli değildir** — yalnızca sahibe açık komutlar o kanalda kapalı şekilde başarısız olur. Sahibe açık komutların yalnızca `ownerAllowFrom` ve standart komut izin listeleriyle denetlenmesini istiyorsanız bunu kapalı bırakın.
|
||||
- `commands.ownerDisplay`, sahip kimliklerinin sistem isteminde nasıl görüneceğini belirler: `raw` veya `hash`.
|
||||
- `commands.ownerDisplaySecret`, `commands.ownerDisplay="hash"` olduğunda kullanılan HMAC gizlisini isteğe bağlı olarak ayarlar.
|
||||
- `commands.allowFrom` (isteğe bağlı), komut yetkilendirmesi için sağlayıcı başına izin listesi ayarlar. Yapılandırıldığında komutlar ve yönergeler için
|
||||
tek yetkilendirme kaynağı budur (kanal izin listeleri/eşleştirme ve `commands.useAccessGroups`
|
||||
yok sayılır). Genel varsayılan için `"*"` kullanın; sağlayıcıya özgü anahtarlar bunu geçersiz kılar.
|
||||
- `commands.useAccessGroups` (varsayılan `true`), `commands.allowFrom` ayarlı değilse komutlar için izin listelerini/ilkeleri uygular.
|
||||
- `commands.text` (varsayılan `true`), sohbet mesajlarında `/...` ayrıştırmasını etkinleştirir.
|
||||
- Yerel komutları olmayan yüzeylerde (WhatsApp/WebChat/Signal/iMessage/Google Chat/Microsoft Teams), bunu `false` olarak ayarlasanız bile metin komutları çalışmaya devam eder.
|
||||
- `commands.native` (varsayılan `"auto"`), yerel komutları kaydeder.
|
||||
- Otomatik: Discord/Telegram için açık; Slack için kapalıdır (eğik çizgi komutları ekleyene kadar); yerel destek sunmayan sağlayıcılarda yok sayılır.
|
||||
- Sağlayıcı başına geçersiz kılmak için `channels.discord.commands.native`, `channels.telegram.commands.native` veya `channels.slack.commands.native` ayarını kullanın (bool veya `"auto"`).
|
||||
- `false`, başlangıçta Discord/Telegram üzerindeki daha önce kaydedilmiş komutları temizler. Slack komutları Slack uygulamasında yönetilir ve otomatik olarak kaldırılmaz.
|
||||
- `commands.nativeSkills` (varsayılan `"auto"`), desteklendiğinde **Skill** komutlarını yerel olarak kaydeder.
|
||||
- Otomatik: Discord/Telegram için açık; Slack için kapalıdır (Slack her Skill için ayrı bir eğik çizgi komutu oluşturulmasını gerektirir).
|
||||
- Sağlayıcı başına geçersiz kılmak için `channels.discord.commands.nativeSkills`, `channels.telegram.commands.nativeSkills` veya `channels.slack.commands.nativeSkills` ayarını kullanın (bool veya `"auto"`).
|
||||
- `commands.bash` (varsayılan `false`), ana makinenin kabuk komutlarını çalıştırmak için `! <cmd>` kullanımını etkinleştirir (`/bash <cmd>` bunun bir takma adıdır; `tools.elevated` izin listeleri gerekir).
|
||||
- `commands.bashForegroundMs` (varsayılan `2000`), arka plan moduna geçmeden önce bash’in ne kadar bekleyeceğini kontrol eder (`0`, hemen arka plana alır).
|
||||
- `commands.config` (varsayılan `false`), `/config` komutunu etkinleştirir (`openclaw.json` dosyasını okur/yazar).
|
||||
- `commands.mcp` (varsayılan `false`), `/mcp` komutunu etkinleştirir (OpenClaw tarafından yönetilen `mcp.servers` altındaki MCP yapılandırmasını okur/yazar).
|
||||
- `commands.plugins` (varsayılan `false`), `/plugins` komutunu etkinleştirir (plugin keşfi/durumu ile kurulum + etkinleştirme/devre dışı bırakma kontrolleri).
|
||||
- `commands.debug` (varsayılan `false`), `/debug` komutunu etkinleştirir (yalnızca çalışma zamanı geçersiz kılmaları).
|
||||
- `commands.restart` (varsayılan `true`), `/restart` komutunu ve gateway yeniden başlatma araç eylemlerini etkinleştirir.
|
||||
- `commands.ownerAllowFrom` (isteğe bağlı), yalnızca sahip için olan komut/araç yüzeyleri için açık sahip izin listesini ayarlar. Bu, `commands.allowFrom` değerinden ayrıdır.
|
||||
- Kanal başına `channels.<channel>.commands.enforceOwnerForCommands` (isteğe bağlı, varsayılan `false`), bu yüzeyde yalnızca sahip için olan komutların çalışması için **sahip kimliği** gerektirir. `true` olduğunda gönderenin ya çözülmüş bir sahip adayıyla eşleşmesi gerekir (örneğin `commands.ownerAllowFrom` içindeki bir giriş veya sağlayıcıya özgü yerel sahip meta verisi) ya da dahili bir mesaj kanalında dahili `operator.admin` kapsamına sahip olması gerekir. Kanal `allowFrom` içindeki joker bir giriş veya boş/çözümlenmemiş bir sahip-aday listesi **yeterli değildir** — yalnızca sahip için olan komutlar bu kanalda kapalı şekilde başarısız olur. Yalnızca sahip için olan komutların sadece `ownerAllowFrom` ve standart komut izin listeleriyle sınırlandırılmasını istiyorsanız bunu kapalı bırakın.
|
||||
- `commands.ownerDisplay`, sistem isteminde sahip kimliklerinin nasıl görüneceğini kontrol eder: `raw` veya `hash`.
|
||||
- `commands.ownerDisplaySecret`, `commands.ownerDisplay="hash"` olduğunda kullanılan HMAC sırrını isteğe bağlı olarak ayarlar.
|
||||
- `commands.allowFrom` (isteğe bağlı), komut yetkilendirmesi için sağlayıcı başına bir izin listesi ayarlar. Yapılandırıldığında, komutlar ve yönergeler için kullanılan tek yetkilendirme kaynağı budur (kanal izin listeleri/eşleştirme ve `commands.useAccessGroups` yok sayılır). Genel varsayılan için `"*"` kullanın; sağlayıcıya özgü anahtarlar bunu geçersiz kılar.
|
||||
- `commands.useAccessGroups` (varsayılan `true`), `commands.allowFrom` ayarlı değilken komutlar için izin listelerini/politikaları uygular.
|
||||
|
||||
## Komut listesi
|
||||
|
||||
Geçerli doğruluk kaynağı:
|
||||
Geçerli source-of-truth:
|
||||
|
||||
- çekirdek yerleşik komutlar `src/auto-reply/commands-registry.shared.ts` dosyasından gelir
|
||||
- oluşturulmuş dock komutları `src/auto-reply/commands-registry.data.ts` dosyasından gelir
|
||||
- plugin komutları plugin `registerCommand()` çağrılarından gelir
|
||||
- Gateway'inizde gerçekten kullanılabilir olmaları yine de yapılandırma bayraklarına, kanal yüzeyine ve kurulu/etkin plugin'lere bağlıdır
|
||||
- üretilmiş dock komutları `src/auto-reply/commands-registry.data.ts` dosyasından gelir
|
||||
- plugin komutları, plugin `registerCommand()` çağrılarından gelir
|
||||
- gateway’inizdeki gerçek kullanılabilirlik yine de yapılandırma bayraklarına, kanal yüzeyine ve kurulu/etkin plugin’lere bağlıdır
|
||||
|
||||
### Çekirdek yerleşik komutlar
|
||||
|
||||
Bugün kullanılabilen yerleşik komutlar:
|
||||
|
||||
- `/new [model]` yeni bir oturum başlatır; `/reset` sıfırlama takma adıdır.
|
||||
- `/reset soft [message]`, geçerli dökümü korur, yeniden kullanılan CLI backend oturum kimliklerini bırakır ve başlangıç/sistem istemi yüklemesini yerinde yeniden çalıştırır.
|
||||
- `/compact [instructions]`, oturum bağlamını sıkıştırır. Bkz. [/concepts/compaction](/tr/concepts/compaction).
|
||||
- `/stop`, geçerli çalıştırmayı iptal eder.
|
||||
- `/session idle <duration|off>` ve `/session max-age <duration|off>`, iş parçacığı bağlama süre sonunu yönetir.
|
||||
- `/think <level>`, düşünme düzeyini ayarlar. Seçenekler etkin modelin sağlayıcı profilinden gelir; yaygın düzeyler `off`, `minimal`, `low`, `medium` ve `high` olup `xhigh`, `adaptive`, `max` veya ikili `on` gibi özel düzeyler yalnızca desteklendiği yerde bulunur. Takma adlar: `/thinking`, `/t`.
|
||||
- `/verbose on|off|full`, ayrıntılı çıktıyı değiştirir. Takma ad: `/v`.
|
||||
- `/trace on|off`, geçerli oturum için plugin iz çıktısını değiştirir.
|
||||
- `/fast [status|on|off]`, hızlı modu gösterir veya ayarlar.
|
||||
- `/reasoning [on|off|stream]`, akıl yürütme görünürlüğünü değiştirir. Takma ad: `/reason`.
|
||||
- `/elevated [on|off|ask|full]`, yükseltilmiş modu değiştirir. Takma ad: `/elev`.
|
||||
- `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>`, exec varsayılanlarını gösterir veya ayarlar.
|
||||
- `/model [name|#|status]`, modeli gösterir veya ayarlar.
|
||||
- `/models [provider] [page] [limit=<n>|size=<n>|all]`, sağlayıcıları veya bir sağlayıcıya ait modelleri listeler.
|
||||
- `/queue <mode>`, kuyruk davranışını yönetir (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) ve `debounce:2s cap:25 drop:summarize` gibi seçenekleri destekler.
|
||||
- `/help`, kısa yardım özetini gösterir.
|
||||
- `/commands`, oluşturulmuş komut kataloğunu gösterir.
|
||||
- `/tools [compact|verbose]`, geçerli aracının şu anda neleri kullanabildiğini gösterir.
|
||||
- `/status`, varsa sağlayıcı kullanımı/kotasını da içeren çalışma zamanı durumunu gösterir.
|
||||
- `/tasks`, geçerli oturum için etkin/son arka plan görevlerini listeler.
|
||||
- `/context [list|detail|json]`, bağlamın nasıl oluşturulduğunu açıklar.
|
||||
- `/export-session [path]`, geçerli oturumu HTML olarak dışa aktarır. Takma ad: `/export`.
|
||||
- `/export-trajectory [path]`, geçerli oturum için JSONL [trajectory bundle](/tr/tools/trajectory) dışa aktarır. Takma ad: `/trajectory`.
|
||||
- `/whoami`, gönderici kimliğinizi gösterir. Takma ad: `/id`.
|
||||
- `/skill <name> [input]`, bir skill'i adına göre çalıştırır.
|
||||
- `/allowlist [list|add|remove] ...`, izin listesi girdilerini yönetir. Yalnızca metin.
|
||||
- `/approve <id> <decision>`, exec onay istemlerini çözümler.
|
||||
- `/btw <question>`, gelecekteki oturum bağlamını değiştirmeden yan bir soru sorar. Bkz. [/tools/btw](/tr/tools/btw).
|
||||
- `/subagents list|kill|log|info|send|steer|spawn`, geçerli oturum için alt aracı çalıştırmalarını yönetir.
|
||||
- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help`, ACP oturumlarını ve çalışma zamanı seçeneklerini yönetir.
|
||||
- `/focus <target>`, geçerli Discord iş parçacığını veya Telegram başlığını/konuşmasını bir oturum hedefine bağlar.
|
||||
- `/unfocus`, geçerli bağlamayı kaldırır.
|
||||
- `/agents`, geçerli oturum için iş parçacığına bağlı aracıları listeler.
|
||||
- `/kill <id|#|all>`, çalışan bir veya tüm alt aracıları iptal eder.
|
||||
- `/steer <id|#> <message>`, çalışan bir alt aracıya yönlendirme gönderir. Takma ad: `/tell`.
|
||||
- `/config show|get|set|unset`, `openclaw.json` dosyasını okur veya yazar. Yalnızca sahip için. `commands.config: true` gerektirir.
|
||||
- `/mcp show|get|set|unset`, `mcp.servers` altındaki OpenClaw tarafından yönetilen MCP sunucu yapılandırmasını okur veya yazar. Yalnızca sahip için. `commands.mcp: true` gerektirir.
|
||||
- `/plugins list|inspect|show|get|install|enable|disable`, plugin durumunu inceler veya değiştirir. `/plugin` bir takma addır. Yazma işlemleri için yalnızca sahip. `commands.plugins: true` gerektirir.
|
||||
- `/debug show|set|unset|reset`, yalnızca çalışma zamanına ait yapılandırma geçersiz kılmalarını yönetir. Yalnızca sahip için. `commands.debug: true` gerektirir.
|
||||
- `/usage off|tokens|full|cost`, yanıt başına kullanım alt bilgisini kontrol eder veya yerel maliyet özeti yazdırır.
|
||||
- `/tts on|off|status|provider|limit|summary|audio|help`, TTS'yi kontrol eder. Bkz. [/tools/tts](/tr/tools/tts).
|
||||
- `/restart`, etkinleştirildiğinde OpenClaw'ı yeniden başlatır. Varsayılan: etkin; devre dışı bırakmak için `commands.restart: false` ayarlayın.
|
||||
- `/activation mention|always`, grup etkinleştirme modunu ayarlar.
|
||||
- `/send on|off|inherit`, gönderim ilkesini ayarlar. Yalnızca sahip için.
|
||||
- `/bash <command>`, ana makine kabuk komutu çalıştırır. Yalnızca metin. Takma ad: `! <command>`. `commands.bash: true` ve `tools.elevated` izin listeleri gerektirir.
|
||||
- `!poll [sessionId]`, arka plan bash işini kontrol eder.
|
||||
- `!stop [sessionId]`, arka plan bash işini durdurur.
|
||||
- `/reset soft [message]` geçerli transkripti korur, yeniden kullanılan CLI backend oturum kimliklerini bırakır ve başlangıç/sistem istemi yüklemesini yerinde yeniden çalıştırır.
|
||||
- `/compact [instructions]` oturum bağlamını sıkıştırır. Bkz. [/concepts/compaction](/tr/concepts/compaction).
|
||||
- `/stop` geçerli çalıştırmayı iptal eder.
|
||||
- `/session idle <duration|off>` ve `/session max-age <duration|off>` iş parçacığı bağlama süresinin dolmasını yönetir.
|
||||
- `/think <level>` düşünme düzeyini ayarlar. Seçenekler etkin modelin sağlayıcı profilinden gelir; yaygın düzeyler `off`, `minimal`, `low`, `medium` ve `high` değerleridir, `xhigh`, `adaptive`, `max` veya ikili `on` gibi özel düzeyler ise yalnızca desteklenen yerlerde vardır. Takma adlar: `/thinking`, `/t`.
|
||||
- `/verbose on|off|full` ayrıntılı çıktıyı açar/kapatır. Takma ad: `/v`.
|
||||
- `/trace on|off` geçerli oturum için plugin izleme çıktısını açar/kapatır.
|
||||
- `/fast [status|on|off]` hızlı modu gösterir veya ayarlar.
|
||||
- `/reasoning [on|off|stream]` muhakeme görünürlüğünü açar/kapatır. Takma ad: `/reason`.
|
||||
- `/elevated [on|off|ask|full]` elevated modunu açar/kapatır. Takma ad: `/elev`.
|
||||
- `/exec host=<auto|sandbox|gateway|node> security=<deny|allowlist|full> ask=<off|on-miss|always> node=<id>` exec varsayılanlarını gösterir veya ayarlar.
|
||||
- `/model [name|#|status]` modeli gösterir veya ayarlar.
|
||||
- `/models [provider] [page] [limit=<n>|size=<n>|all]` bir sağlayıcı için sağlayıcıları veya modelleri listeler.
|
||||
- `/queue <mode>` kuyruk davranışını (`steer`, `interrupt`, `followup`, `collect`, `steer-backlog`) ve `debounce:2s cap:25 drop:summarize` gibi seçenekleri yönetir.
|
||||
- `/help` kısa yardım özetini gösterir.
|
||||
- `/commands` oluşturulmuş komut kataloğunu gösterir.
|
||||
- `/tools [compact|verbose]` geçerli aracının şu anda neleri kullanabildiğini gösterir.
|
||||
- `/status`, mevcut olduğunda `Runtime`/`Runner` etiketleri ve sağlayıcı kullanımı/kotası dahil çalışma zamanı durumunu gösterir.
|
||||
- `/tasks` geçerli oturum için etkin/son arka plan görevlerini listeler.
|
||||
- `/context [list|detail|json]` bağlamın nasıl oluşturulduğunu açıklar.
|
||||
- `/export-session [path]` geçerli oturumu HTML olarak dışa aktarır. Takma ad: `/export`.
|
||||
- `/export-trajectory [path]` geçerli oturum için bir JSONL [trajectory bundle](/tr/tools/trajectory) dışa aktarır. Takma ad: `/trajectory`.
|
||||
- `/whoami` gönderen kimliğinizi gösterir. Takma ad: `/id`.
|
||||
- `/skill <name> [input]` bir Skill’i adına göre çalıştırır.
|
||||
- `/allowlist [list|add|remove] ...` izin listesi girdilerini yönetir. Yalnızca metin.
|
||||
- `/approve <id> <decision>` exec onay istemlerini çözümler.
|
||||
- `/btw <question>` gelecekteki oturum bağlamını değiştirmeden yan bir soru sorar. Bkz. [/tools/btw](/tr/tools/btw).
|
||||
- `/subagents list|kill|log|info|send|steer|spawn` geçerli oturum için alt aracı çalıştırmalarını yönetir.
|
||||
- `/acp spawn|cancel|steer|close|sessions|status|set-mode|set|cwd|permissions|timeout|model|reset-options|doctor|install|help` ACP oturumlarını ve çalışma zamanı seçeneklerini yönetir.
|
||||
- `/focus <target>` geçerli Discord iş parçacığını veya Telegram konu/görüşmesini bir oturum hedefine bağlar.
|
||||
- `/unfocus` geçerli bağlamayı kaldırır.
|
||||
- `/agents` geçerli oturum için iş parçacığına bağlı aracıları listeler.
|
||||
- `/kill <id|#|all>` çalışan bir veya tüm alt aracıları iptal eder.
|
||||
- `/steer <id|#> <message>` çalışan bir alt aracıya yönlendirme gönderir. Takma ad: `/tell`.
|
||||
- `/config show|get|set|unset` `openclaw.json` dosyasını okur veya yazar. Yalnızca sahip. `commands.config: true` gerektirir.
|
||||
- `/mcp show|get|set|unset` OpenClaw tarafından yönetilen `mcp.servers` altındaki MCP sunucusu yapılandırmasını okur veya yazar. Yalnızca sahip. `commands.mcp: true` gerektirir.
|
||||
- `/plugins list|inspect|show|get|install|enable|disable` plugin durumunu inceler veya değiştirir. `/plugin` bir takma addır. Yazma işlemleri yalnızca sahip içindir. `commands.plugins: true` gerektirir.
|
||||
- `/debug show|set|unset|reset` yalnızca çalışma zamanına ait yapılandırma geçersiz kılmalarını yönetir. Yalnızca sahip. `commands.debug: true` gerektirir.
|
||||
- `/usage off|tokens|full|cost` yanıt başına kullanım alt bilgisini kontrol eder veya yerel bir maliyet özeti yazdırır.
|
||||
- `/tts on|off|status|provider|limit|summary|audio|help` TTS’yi kontrol eder. Bkz. [/tools/tts](/tr/tools/tts).
|
||||
- `/restart` etkin olduğunda OpenClaw’ı yeniden başlatır. Varsayılan: etkin; devre dışı bırakmak için `commands.restart: false` ayarlayın.
|
||||
- `/activation mention|always` grup etkinleştirme modunu ayarlar.
|
||||
- `/send on|off|inherit` gönderme politikasını ayarlar. Yalnızca sahip.
|
||||
- `/bash <command>` ana makine kabuk komutu çalıştırır. Yalnızca metin. Takma ad: `! <command>`. `commands.bash: true` ve `tools.elevated` izin listeleri gerektirir.
|
||||
- `!poll [sessionId]` arka plan bash işini kontrol eder.
|
||||
- `!stop [sessionId]` arka plan bash işini durdurur.
|
||||
|
||||
### Oluşturulmuş dock komutları
|
||||
|
||||
Dock komutları, yerel komut desteği olan kanal plugin'lerinden oluşturulur. Geçerli paketlenmiş küme:
|
||||
Dock komutları, yerel komut desteği olan kanal plugin’lerinden üretilir. Geçerli paketli küme:
|
||||
|
||||
- `/dock-discord` (takma ad: `/dock_discord`)
|
||||
- `/dock-mattermost` (takma ad: `/dock_mattermost`)
|
||||
- `/dock-slack` (takma ad: `/dock_slack`)
|
||||
- `/dock-telegram` (takma ad: `/dock_telegram`)
|
||||
|
||||
### Paketlenmiş plugin komutları
|
||||
### Paketli plugin komutları
|
||||
|
||||
Paketlenmiş plugin'ler daha fazla slash komutu ekleyebilir. Bu depodaki geçerli paketlenmiş komutlar:
|
||||
Paketli plugin’ler daha fazla eğik çizgi komutu ekleyebilir. Bu depodaki mevcut paketli komutlar:
|
||||
|
||||
- `/dreaming [on|off|status|help]`, bellek dreaming özelliğini değiştirir. Bkz. [Dreaming](/tr/concepts/dreaming).
|
||||
- `/pair [qr|status|pending|approve|cleanup|notify]`, cihaz eşleştirme/kurulum akışını yönetir. Bkz. [Eşleştirme](/tr/channels/pairing).
|
||||
- `/phone status|arm <camera|screen|writes|all> [duration]|disarm`, yüksek riskli telefon node komutlarını geçici olarak devreye alır.
|
||||
- `/voice status|list [limit]|set <voiceId|name>`, Talk ses yapılandırmasını yönetir. Discord'da yerel komut adı `/talkvoice` olur.
|
||||
- `/card ...`, LINE zengin kart ön ayarları gönderir. Bkz. [LINE](/tr/channels/line).
|
||||
- `/codex status|models|threads|resume|compact|review|account|mcp|skills`, paketlenmiş Codex uygulama sunucusu harness'ini inceler ve denetler. Bkz. [Codex Harness](/tr/plugins/codex-harness).
|
||||
- `/dreaming [on|off|status|help]` bellek Dreaming özelliğini açar/kapatır. Bkz. [Dreaming](/tr/concepts/dreaming).
|
||||
- `/pair [qr|status|pending|approve|cleanup|notify]` cihaz eşleştirme/kurulum akışını yönetir. Bkz. [Eşleştirme](/tr/channels/pairing).
|
||||
- `/phone status|arm <camera|screen|writes|all> [duration]|disarm` yüksek riskli telefon node komutlarını geçici olarak etkinleştirir.
|
||||
- `/voice status|list [limit]|set <voiceId|name>` Talk ses yapılandırmasını yönetir. Discord’da yerel komut adı `/talkvoice` şeklindedir.
|
||||
- `/card ...` LINE zengin kart önayarları gönderir. Bkz. [LINE](/tr/channels/line).
|
||||
- `/codex status|models|threads|resume|compact|review|account|mcp|skills` paketli Codex uygulama sunucusu harness’ını inceler ve kontrol eder. Bkz. [Codex Harness](/tr/plugins/codex-harness).
|
||||
- Yalnızca QQBot komutları:
|
||||
- `/bot-ping`
|
||||
- `/bot-version`
|
||||
@ -171,73 +168,71 @@ Paketlenmiş plugin'ler daha fazla slash komutu ekleyebilir. Bu depodaki geçerl
|
||||
- `/bot-upgrade`
|
||||
- `/bot-logs`
|
||||
|
||||
### Dinamik skill komutları
|
||||
### Dinamik Skill komutları
|
||||
|
||||
Kullanıcının çağırabildiği Skills, slash komutları olarak da sunulur:
|
||||
Kullanıcının çağırabildiği Skills, eğik çizgi komutları olarak da sunulur:
|
||||
|
||||
- `/skill <name> [input]`, genel giriş noktası olarak her zaman çalışır.
|
||||
- skill'ler/plugin'ler bunları kaydederse `/prose` gibi doğrudan komutlar olarak da görünebilir.
|
||||
- yerel skill komutu kaydı `commands.nativeSkills` ve `channels.<provider>.commands.nativeSkills` tarafından kontrol edilir.
|
||||
- `/skill <name> [input]` genel giriş noktası olarak her zaman çalışır.
|
||||
- Skill’ler, Skill/plugin bunları kaydederse `/prose` gibi doğrudan komutlar olarak da görünebilir.
|
||||
- Yerel skill-komutu kaydı `commands.nativeSkills` ve `channels.<provider>.commands.nativeSkills` tarafından kontrol edilir.
|
||||
|
||||
Notlar:
|
||||
|
||||
- Komutlar, komut ile argümanlar arasına isteğe bağlı `:` kabul eder (ör. `/think: high`, `/send: on`, `/help:`).
|
||||
- `/new <model>`, bir model takma adını, `provider/model` biçimini veya bir sağlayıcı adını (bulanık eşleşme) kabul eder; eşleşme yoksa metin mesaj gövdesi olarak değerlendirilir.
|
||||
- Komutlar, komut ile argümanlar arasında isteğe bağlı bir `:` kabul eder (ör. `/think: high`, `/send: on`, `/help:`).
|
||||
- `/new <model>`, bir model takma adını, `provider/model` biçimini veya bir sağlayıcı adını kabul eder (bulanık eşleştirme); eşleşme yoksa metin mesaj gövdesi olarak değerlendirilir.
|
||||
- Tam sağlayıcı kullanım dökümü için `openclaw status --usage` kullanın.
|
||||
- `/allowlist add|remove`, `commands.config=true` gerektirir ve kanal `configWrites` ayarına uyar.
|
||||
- Çok hesaplı kanallarda, yapılandırma hedefli `/allowlist --account <id>` ve `/config set channels.<provider>.accounts.<id>...` komutları da hedef hesabın `configWrites` ayarına uyar.
|
||||
- Çok hesaplı kanallarda, yapılandırma hedefli `/allowlist --account <id>` ve `/config set channels.<provider>.accounts.<id>...` da hedef hesabın `configWrites` ayarına uyar.
|
||||
- `/usage`, yanıt başına kullanım alt bilgisini kontrol eder; `/usage cost`, OpenClaw oturum günlüklerinden yerel bir maliyet özeti yazdırır.
|
||||
- `/restart` varsayılan olarak etkindir; devre dışı bırakmak için `commands.restart: false` ayarlayın.
|
||||
- `/plugins install <spec>`, `openclaw plugins install` ile aynı plugin özelliklerini kabul eder: yerel yol/arşiv, npm paketi veya `clawhub:<pkg>`.
|
||||
- `/plugins install <spec>`, `openclaw plugins install` ile aynı plugin belirtimlerini kabul eder: yerel yol/arşiv, npm paketi veya `clawhub:<pkg>`.
|
||||
- `/plugins enable|disable`, plugin yapılandırmasını günceller ve yeniden başlatma istemi gösterebilir.
|
||||
- Yalnızca Discord'a özgü yerel komut: `/vc join|leave|status`, sesli kanalları kontrol eder (`channels.discord.voice` ve yerel komutlar gerekir; metin olarak kullanılamaz).
|
||||
- Discord iş parçacığı bağlama komutları (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`), etkin iş parçacığı bağlamalarının açık olmasını gerektirir (`session.threadBindings.enabled` ve/veya `channels.discord.threadBindings.enabled`).
|
||||
- Yalnızca Discord’a özgü yerel komut: `/vc join|leave|status` ses kanallarını kontrol eder (`channels.discord.voice` ve yerel komutlar gerektirir; metin olarak kullanılamaz).
|
||||
- Discord iş parçacığı bağlama komutları (`/focus`, `/unfocus`, `/agents`, `/session idle`, `/session max-age`), etkin iş parçacığı bağlamalarının etkin olmasını gerektirir (`session.threadBindings.enabled` ve/veya `channels.discord.threadBindings.enabled`).
|
||||
- ACP komut başvurusu ve çalışma zamanı davranışı: [ACP Agents](/tr/tools/acp-agents).
|
||||
- `/verbose`, hata ayıklama ve ek görünürlük içindir; normal kullanımda **kapalı** tutun.
|
||||
- `/trace`, `/verbose`'dan daha dardır: yalnızca plugin'e ait iz/hata ayıklama satırlarını gösterir ve normal ayrıntılı araç konuşmasını kapalı tutar.
|
||||
- `/fast on|off`, kalıcı bir oturum geçersiz kılması yapar. Bunu temizlemek ve yapılandırma varsayılanlarına dönmek için Sessions UI içindeki `inherit` seçeneğini kullanın.
|
||||
- `/fast`, sağlayıcıya özeldir: OpenAI/OpenAI Codex bunu yerel Responses uç noktalarında `service_tier=priority` ile eşler; doğrudan herkese açık Anthropic istekleri, buna `api.anthropic.com` adresine OAuth ile kimlik doğrulanmış trafik de dahil, bunu `service_tier=auto` veya `standard_only` ile eşler. Bkz. [OpenAI](/tr/providers/openai) ve [Anthropic](/tr/providers/anthropic).
|
||||
- Araç hata özetleri gerektiğinde yine gösterilir, ancak ayrıntılı hata metni yalnızca `/verbose` değeri `on` veya `full` olduğunda dahil edilir.
|
||||
- `/reasoning`, `/verbose` ve `/trace`, grup ayarlarında risklidir: açığa çıkmasını istemediğiniz dahili akıl yürütmeyi, araç çıktısını veya plugin tanılamasını gösterebilirler. Özellikle grup sohbetlerinde kapalı bırakmayı tercih edin.
|
||||
- `/model`, yeni oturum modelini hemen kalıcılaştırır.
|
||||
- Aracı boşta ise bir sonraki çalıştırma bunu hemen kullanır.
|
||||
- Bir çalıştırma zaten etkinse OpenClaw canlı geçişi beklemede olarak işaretler ve yalnızca temiz bir yeniden deneme noktasında yeni modele yeniden başlar.
|
||||
- Araç etkinliği veya yanıt çıktısı zaten başlamışsa bekleyen geçiş daha sonraki bir yeniden deneme fırsatına veya sonraki kullanıcı dönüşüne kadar kuyrukta kalabilir.
|
||||
- **Hızlı yol:** izin verilen göndericilerden gelen yalnızca komut içeren mesajlar hemen işlenir (kuyruğu + modeli atlar).
|
||||
- **Grup bahsetme geçidi:** izin verilen göndericilerden gelen yalnızca komut içeren mesajlar bahsetme gereksinimlerini atlar.
|
||||
- **Satır içi kısayollar (yalnızca izin verilen göndericiler):** bazı komutlar normal mesaj içine gömülü olduklarında da çalışır ve model kalan metni görmeden önce çıkarılır.
|
||||
- Örnek: `hey /status`, bir durum yanıtı tetikler ve kalan metin normal akıştan devam eder.
|
||||
- `/verbose`, hata ayıklama ve ek görünürlük için tasarlanmıştır; normal kullanımda **kapalı** tutun.
|
||||
- `/trace`, `/verbose`’dan daha dardır: yalnızca plugin’e ait izleme/hata ayıklama satırlarını gösterir ve normal ayrıntılı araç konuşmasını kapalı tutar.
|
||||
- `/fast on|off`, oturum geçersiz kılmasını kalıcı hale getirir. Bunu temizlemek ve yapılandırma varsayılanlarına geri dönmek için Sessions UI içindeki `inherit` seçeneğini kullanın.
|
||||
- `/fast`, sağlayıcıya özeldir: OpenAI/OpenAI Codex bunu yerel Responses uç noktalarında `service_tier=priority` olarak eşlerken, `api.anthropic.com` adresine gönderilen OAuth kimlik doğrulamalı trafik dahil doğrudan genel Anthropic istekleri bunu `service_tier=auto` veya `standard_only` olarak eşler. Bkz. [OpenAI](/tr/providers/openai) ve [Anthropic](/tr/providers/anthropic).
|
||||
- Araç hata özetleri ilgili olduğunda yine gösterilir, ancak ayrıntılı hata metni yalnızca `/verbose` `on` veya `full` olduğunda dahil edilir.
|
||||
- `/reasoning`, `/verbose` ve `/trace`, grup ayarlarında risklidir: açığa çıkarmayı düşünmediğiniz iç muhakemeyi, araç çıktısını veya plugin tanılarını gösterebilirler. Özellikle grup sohbetlerinde kapalı bırakmayı tercih edin.
|
||||
- `/model`, yeni oturum modelini hemen kalıcı hale getirir.
|
||||
- Aracı boştaysa, sonraki çalıştırma bunu hemen kullanır.
|
||||
- Zaten etkin bir çalıştırma varsa, OpenClaw canlı geçişi beklemede olarak işaretler ve yalnızca temiz bir yeniden deneme noktasında yeni modele yeniden başlatır.
|
||||
- Araç etkinliği veya yanıt çıktısı zaten başlamışsa, bekleyen geçiş daha sonraki bir yeniden deneme fırsatına veya bir sonraki kullanıcı turuna kadar kuyrukta kalabilir.
|
||||
- **Hızlı yol:** izin listesindeki gönderenlerden gelen yalnızca komut içeren mesajlar hemen işlenir (kuyruk + model atlanır).
|
||||
- **Grup mention kapılaması:** izin listesindeki gönderenlerden gelen yalnızca komut içeren mesajlar mention gereksinimlerini atlar.
|
||||
- **Satır içi kısayollar (yalnızca izin listesindeki gönderenler):** belirli komutlar normal bir mesaja gömülü olduğunda da çalışır ve model kalan metni görmeden önce çıkarılır.
|
||||
- Örnek: `hey /status` bir durum yanıtını tetikler ve kalan metin normal akıştan geçmeye devam eder.
|
||||
- Şu anda: `/help`, `/commands`, `/status`, `/whoami` (`/id`).
|
||||
- Yetkisiz yalnızca komut içeren mesajlar sessizce yok sayılır ve satır içi `/...` token'ları düz metin olarak değerlendirilir.
|
||||
- **Skill komutları:** `user-invocable` skill'ler slash komutları olarak sunulur. Adlar `a-z0-9_` biçimine temizlenir (azami 32 karakter); çakışmalara sayısal sonek eklenir (ör. `_2`).
|
||||
- `/skill <name> [input]`, bir skill'i adına göre çalıştırır (yerel komut sınırları skill başına komutları engellediğinde kullanışlıdır).
|
||||
- Varsayılan olarak skill komutları modele normal istek olarak iletilir.
|
||||
- Skill'ler isteğe bağlı olarak komutu doğrudan bir araca yönlendirmek için `command-dispatch: tool` bildirebilir (deterministik, model yok).
|
||||
- Örnek: `/prose` (OpenProse plugin'i) — bkz. [OpenProse](/tr/prose).
|
||||
- **Yerel komut argümanları:** Discord dinamik seçenekler için otomatik tamamlamayı kullanır (ve gerekli argümanları atladığınızda düğme menülerini gösterir). Telegram ve Slack, bir komut seçenekleri destekliyorsa ve siz argümanı atladıysanız bir düğme menüsü gösterir.
|
||||
- Yetkisiz yalnızca komut içeren mesajlar sessizce yok sayılır ve satır içi `/...` belirteçleri düz metin olarak değerlendirilir.
|
||||
- **Skill komutları:** `user-invocable` Skills, eğik çizgi komutları olarak sunulur. Adlar `a-z0-9_` olarak temizlenir (en fazla 32 karakter); çakışmalara sayısal son ekler eklenir (ör. `_2`).
|
||||
- `/skill <name> [input]`, bir Skill’i adına göre çalıştırır (yerel komut sınırları Skill başına komutları engellediğinde kullanışlıdır).
|
||||
- Varsayılan olarak Skill komutları modele normal bir istek olarak iletilir.
|
||||
- Skills isteğe bağlı olarak komutu doğrudan bir araca yönlendirmek için `command-dispatch: tool` bildirebilir (deterministik, modelsiz).
|
||||
- Örnek: `/prose` (OpenProse plugin’i) — bkz. [OpenProse](/tr/prose).
|
||||
- **Yerel komut argümanları:** Discord dinamik seçenekler için autocomplete kullanır (gerekli argümanları atladığınızda düğme menüleri de kullanılır). Telegram ve Slack, bir komut seçimleri destekliyorsa ve siz argümanı atlarsanız bir düğme menüsü gösterir.
|
||||
|
||||
## `/tools`
|
||||
|
||||
`/tools`, bir yapılandırma sorusunu değil, çalışma zamanı sorusunu yanıtlar: **bu aracının
|
||||
bu konuşmada şu anda neleri kullanabildiğini**.
|
||||
`/tools`, bir yapılandırma sorusuna değil, bir çalışma zamanı sorusuna yanıt verir: **bu aracının şu anda
|
||||
bu konuşmada neleri kullanabildiği**.
|
||||
|
||||
- Varsayılan `/tools` kompakt olup hızlı tarama için optimize edilmiştir.
|
||||
- `/tools verbose`, kısa açıklamalar ekler.
|
||||
- Argümanları destekleyen yerel komut yüzeyleri aynı mod anahtarını `compact|verbose` olarak sunar.
|
||||
- Sonuçlar oturum kapsamlıdır; bu yüzden aracı, kanal, iş parçacığı, gönderici yetkilendirmesi veya model değiştiğinde
|
||||
çıktı da değişebilir.
|
||||
- `/tools`, çekirdek araçlar, bağlı plugin
|
||||
araçları ve kanala ait araçlar dahil, çalışma zamanında gerçekten erişilebilir olan araçları içerir.
|
||||
- Varsayılan `/tools` kompakttır ve hızlı tarama için optimize edilmiştir.
|
||||
- `/tools verbose` kısa açıklamalar ekler.
|
||||
- Argümanları destekleyen yerel komut yüzeyleri aynı kip değiştiriciyi `compact|verbose` olarak sunar.
|
||||
- Sonuçlar oturum kapsamlıdır, bu nedenle aracıyı, kanalı, iş parçacığını, gönderen yetkilendirmesini veya modeli değiştirmek çıktıyı değiştirebilir.
|
||||
- `/tools`, çekirdek araçlar, bağlı plugin araçları ve kanala ait araçlar dahil çalışma zamanında gerçekten erişilebilir olan araçları içerir.
|
||||
|
||||
Profil ve geçersiz kılma düzenlemeleri için `/tools` komutunu statik katalog gibi görmek yerine
|
||||
Control UI Tools panelini veya yapılandırma/katalog yüzeylerini kullanın.
|
||||
Profil ve geçersiz kılma düzenlemeleri için `/tools`’u statik bir katalog gibi ele almak yerine Control UI Tools panelini veya config/catalog yüzeylerini kullanın.
|
||||
|
||||
## Kullanım yüzeyleri (nerede ne gösterilir)
|
||||
|
||||
- **Sağlayıcı kullanımı/kota** (örnek: “Claude %80 kaldı”), kullanım izleme etkinken geçerli model sağlayıcısı için `/status` içinde görünür. OpenClaw sağlayıcı pencerelerini `% kaldı` biçimine normalize eder; MiniMax için yalnızca kalan yüzde alanları gösterilmeden önce ters çevrilir ve `model_remains` yanıtlarında model etiketi taşıyan plan etiketiyle birlikte sohbet modeli girdisi tercih edilir.
|
||||
- `/status` içindeki **token/cache satırları**, canlı oturum anlık görüntüsü seyrek olduğunda en son döküm kullanım girdisine geri dönebilir. Mevcut sıfır olmayan canlı değerler yine kazanır ve döküm yedeği, saklanan toplamlar eksik veya daha küçük olduğunda etkin çalışma zamanı modeli etiketini ve daha büyük, istem odaklı bir toplamı da kurtarabilir.
|
||||
- **Yanıt başına token/maliyet**, `/usage off|tokens|full` ile kontrol edilir (normal yanıtlara eklenir).
|
||||
- `/model status`, kullanım hakkında değil **modeller/auth/uç noktalar** hakkındadır.
|
||||
- **Sağlayıcı kullanımı/kota** (örnek: “Claude %80 kaldı”), kullanım izleme etkin olduğunda geçerli model sağlayıcısı için `/status` içinde gösterilir. OpenClaw sağlayıcı pencerelerini `% kaldı` biçimine normalize eder; MiniMax için yalnızca kalan değeri içeren yüzde alanları görüntülemeden önce tersine çevrilir ve `model_remains` yanıtları sohbet modeli girdisini, ayrıca modele etiketlenmiş plan etiketiyle birlikte tercih eder.
|
||||
- `/status` içindeki **token/önbellek satırları**, canlı oturum anlık görüntüsü seyrek olduğunda en son transkript kullanım girdisine geri dönebilir. Mevcut sıfır olmayan canlı değerler yine önceliklidir ve transkript yedeği, saklanan toplamlar eksik olduğunda veya daha küçük olduğunda etkin çalışma zamanı model etiketini ve daha büyük istem odaklı bir toplamı da geri getirebilir.
|
||||
- **Runtime ve runner:** `/status`, etkin yürütme yolu ve sandbox durumu için `Runtime`, oturumu gerçekte kimin çalıştırdığı için ise `Runner` bildirir: gömülü Pi, CLI destekli bir sağlayıcı veya bir ACP harness/backend’i.
|
||||
- **Yanıt başına token/maliyet**, `/usage off|tokens|full` ile kontrol edilir (normal yanıtların sonuna eklenir).
|
||||
- `/model status`, kullanım hakkında değil, **modeller/kimlik doğrulama/uç noktalar** hakkındadır.
|
||||
|
||||
## Model seçimi (`/model`)
|
||||
|
||||
@ -256,14 +251,14 @@ Control UI Tools panelini veya yapılandırma/katalog yüzeylerini kullanın.
|
||||
|
||||
Notlar:
|
||||
|
||||
- `/model` ve `/model list`, kompakt, numaralı bir seçici gösterir (model ailesi + kullanılabilir sağlayıcılar).
|
||||
- Discord'da `/model` ve `/models`, sağlayıcı ve model açılır menüleri ile bir Gönder adımı içeren etkileşimli bir seçici açar.
|
||||
- `/model` ve `/model list`, kompakt, numaralandırılmış bir seçici gösterir (model ailesi + kullanılabilir sağlayıcılar).
|
||||
- Discord’da `/model` ve `/models`, sağlayıcı ve model açılır menüleri ile bir Gönder adımı içeren etkileşimli bir seçici açar.
|
||||
- `/model <#>`, bu seçiciden seçim yapar (ve mümkün olduğunda geçerli sağlayıcıyı tercih eder).
|
||||
- `/model status`, kullanılabildiğinde yapılandırılmış sağlayıcı uç noktası (`baseUrl`) ve API modu (`api`) dahil ayrıntılı görünümü gösterir.
|
||||
- `/model status`, mevcut olduğunda yapılandırılmış sağlayıcı uç noktasını (`baseUrl`) ve API kipini (`api`) içeren ayrıntılı görünümü gösterir.
|
||||
|
||||
## Hata ayıklama geçersiz kılmaları
|
||||
|
||||
`/debug`, **yalnızca çalışma zamanına ait** yapılandırma geçersiz kılmaları ayarlamanıza izin verir (disk değil, bellek). Yalnızca sahip için. Varsayılan olarak devre dışıdır; `commands.debug: true` ile etkinleştirin.
|
||||
`/debug`, **yalnızca çalışma zamanına ait** yapılandırma geçersiz kılmalarını ayarlamanızı sağlar (disk değil, bellek). Yalnızca sahip. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.debug: true` kullanın.
|
||||
|
||||
Örnekler:
|
||||
|
||||
@ -280,9 +275,9 @@ Notlar:
|
||||
- Geçersiz kılmalar yeni yapılandırma okumalarına hemen uygulanır, ancak `openclaw.json` dosyasına yazılmaz.
|
||||
- Tüm geçersiz kılmaları temizlemek ve disk üzerindeki yapılandırmaya dönmek için `/debug reset` kullanın.
|
||||
|
||||
## Plugin iz çıktısı
|
||||
## Plugin izleme çıktısı
|
||||
|
||||
`/trace`, tam ayrıntılı modu açmadan **oturum kapsamlı plugin iz/hata ayıklama satırlarını** değiştirmenize olanak tanır.
|
||||
`/trace`, tam ayrıntılı modu açmadan **oturum kapsamlı plugin izleme/hata ayıklama satırlarını** açıp kapatmanızı sağlar.
|
||||
|
||||
Örnekler:
|
||||
|
||||
@ -294,16 +289,16 @@ Notlar:
|
||||
|
||||
Notlar:
|
||||
|
||||
- Argümansız `/trace`, geçerli oturumun iz durumunu gösterir.
|
||||
- `/trace on`, geçerli oturum için plugin iz satırlarını etkinleştirir.
|
||||
- `/trace off`, bunları tekrar devre dışı bırakır.
|
||||
- Plugin iz satırları `/status` içinde ve normal asistan yanıtından sonra takip tanılama mesajı olarak görünebilir.
|
||||
- `/trace`, `/debug` yerine geçmez; `/debug` hâlâ yalnızca çalışma zamanına ait yapılandırma geçersiz kılmalarını yönetir.
|
||||
- `/trace`, `/verbose` yerine geçmez; normal ayrıntılı araç/durum çıktısı yine `/verbose` kapsamındadır.
|
||||
- Argümansız `/trace`, geçerli oturum izleme durumunu gösterir.
|
||||
- `/trace on`, geçerli oturum için plugin izleme satırlarını etkinleştirir.
|
||||
- `/trace off`, bunları yeniden devre dışı bırakır.
|
||||
- Plugin izleme satırları `/status` içinde ve normal yardımcı yanıtından sonra gelen bir takip tanılama mesajı olarak görünebilir.
|
||||
- `/trace`, `/debug` yerine geçmez; `/debug` çalışma zamanına özel yapılandırma geçersiz kılmalarını yönetmeye devam eder.
|
||||
- `/trace`, `/verbose` yerine geçmez; normal ayrıntılı araç/durum çıktısı hâlâ `/verbose` kapsamındadır.
|
||||
|
||||
## Yapılandırma güncellemeleri
|
||||
|
||||
`/config`, disk üzerindeki yapılandırmanıza (`openclaw.json`) yazar. Yalnızca sahip için. Varsayılan olarak devre dışıdır; `commands.config: true` ile etkinleştirin.
|
||||
`/config`, disk üzerindeki yapılandırmanıza (`openclaw.json`) yazar. Yalnızca sahip. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.config: true` kullanın.
|
||||
|
||||
Örnekler:
|
||||
|
||||
@ -317,12 +312,12 @@ Notlar:
|
||||
|
||||
Notlar:
|
||||
|
||||
- Yazmadan önce yapılandırma doğrulanır; geçersiz değişiklikler reddedilir.
|
||||
- Yapılandırma yazmadan önce doğrulanır; geçersiz değişiklikler reddedilir.
|
||||
- `/config` güncellemeleri yeniden başlatmalar arasında kalıcıdır.
|
||||
|
||||
## MCP güncellemeleri
|
||||
|
||||
`/mcp`, OpenClaw tarafından yönetilen MCP sunucu tanımlarını `mcp.servers` altında yazar. Yalnızca sahip için. Varsayılan olarak devre dışıdır; `commands.mcp: true` ile etkinleştirin.
|
||||
`/mcp`, OpenClaw tarafından yönetilen MCP sunucusu tanımlarını `mcp.servers` altına yazar. Yalnızca sahip. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.mcp: true` kullanın.
|
||||
|
||||
Örnekler:
|
||||
|
||||
@ -335,12 +330,12 @@ Notlar:
|
||||
|
||||
Notlar:
|
||||
|
||||
- `/mcp`, yapılandırmayı Pi'ye ait proje ayarlarında değil, OpenClaw yapılandırmasında saklar.
|
||||
- Hangi taşıma katmanlarının gerçekten yürütülebilir olduğuna çalışma zamanı bağdaştırıcıları karar verir.
|
||||
- `/mcp`, yapılandırmayı Pi’ye ait proje ayarlarında değil, OpenClaw yapılandırmasında saklar.
|
||||
- Hangi taşıma türlerinin gerçekten yürütülebilir olduğuna çalışma zamanı bağdaştırıcıları karar verir.
|
||||
|
||||
## Plugin güncellemeleri
|
||||
|
||||
`/plugins`, operatörlerin keşfedilen plugin'leri incelemesine ve yapılandırmada etkinlik durumunu değiştirmesine olanak tanır. Salt okunur akışlar takma ad olarak `/plugin` kullanabilir. Varsayılan olarak devre dışıdır; `commands.plugins: true` ile etkinleştirin.
|
||||
`/plugins`, operatörlerin keşfedilen plugin’leri incelemesine ve yapılandırmada etkinleştirmeyi açıp kapatmasına olanak tanır. Salt okunur akışlarda takma ad olarak `/plugin` kullanılabilir. Varsayılan olarak devre dışıdır; etkinleştirmek için `commands.plugins: true` kullanın.
|
||||
|
||||
Örnekler:
|
||||
|
||||
@ -354,35 +349,34 @@ Notlar:
|
||||
|
||||
Notlar:
|
||||
|
||||
- `/plugins list` ve `/plugins show`, geçerli çalışma alanı ve disk üzerindeki yapılandırmaya karşı gerçek plugin keşfi kullanır.
|
||||
- `/plugins enable|disable`, yalnızca plugin yapılandırmasını günceller; plugin'leri kurmaz veya kaldırmaz.
|
||||
- Etkinleştirme/devre dışı bırakma değişikliklerinden sonra uygulamak için Gateway'i yeniden başlatın.
|
||||
- `/plugins list` ve `/plugins show`, geçerli çalışma alanı ve disk üzerindeki yapılandırmaya karşı gerçek plugin keşfini kullanır.
|
||||
- `/plugins enable|disable`, yalnızca plugin yapılandırmasını günceller; plugin’leri kurmaz veya kaldırmaz.
|
||||
- Etkinleştirme/devre dışı bırakma değişikliklerinden sonra bunları uygulamak için gateway’i yeniden başlatın.
|
||||
|
||||
## Yüzey notları
|
||||
|
||||
- **Metin komutları**, normal sohbet oturumunda çalışır (DM'ler `main` oturumunu paylaşır, grupların kendi oturumu vardır).
|
||||
- **Yerel komutlar**, yalıtılmış oturumlar kullanır:
|
||||
- **Metin komutları** normal sohbet oturumunda çalışır (DM’ler `main` oturumunu paylaşır, grupların kendi oturumu vardır).
|
||||
- **Yerel komutlar** yalıtılmış oturumlar kullanır:
|
||||
- Discord: `agent:<agentId>:discord:slash:<userId>`
|
||||
- Slack: `agent:<agentId>:slack:slash:<userId>` (önek `channels.slack.slashCommand.sessionPrefix` ile yapılandırılabilir)
|
||||
- Telegram: `telegram:slash:<userId>` (sohbet oturumunu `CommandTargetSessionKey` üzerinden hedefler)
|
||||
- **`/stop`**, geçerli çalıştırmayı iptal edebilmek için etkin sohbet oturumunu hedefler.
|
||||
- **Slack:** `channels.slack.slashCommand`, tek bir `/openclaw` tarzı komut için hâlâ desteklenir. `commands.native` etkinleştirirseniz yerleşik her komut için bir Slack slash komutu oluşturmanız gerekir (`/help` ile aynı adlar). Slack için komut argümanı menüleri geçici Block Kit düğmeleri olarak teslim edilir.
|
||||
- Slack yerel istisnası: Slack `/status` komutunu ayırdığı için `/status` değil `/agentstatus` kaydedin. Metin `/status`, Slack mesajlarında yine çalışır.
|
||||
- **`/stop`**, geçerli çalıştırmayı iptal edebilmesi için etkin sohbet oturumunu hedefler.
|
||||
- **Slack:** `channels.slack.slashCommand`, tek bir `/openclaw` tarzı komut için hâlâ desteklenir. `commands.native` etkinleştirilirse, her yerleşik komut için ayrı bir Slack eğik çizgi komutu oluşturmanız gerekir (`/help` ile aynı adlar). Slack için komut argümanı menüleri ephemeral Block Kit düğmeleri olarak iletilir.
|
||||
- Slack yerel istisnası: Slack `/status` komutunu ayırdığı için `/status` yerine `/agentstatus` kaydedin. Metin `/status`, Slack mesajlarında yine çalışır.
|
||||
|
||||
## BTW yan sorular
|
||||
## BTW yan soruları
|
||||
|
||||
`/btw`, geçerli oturum hakkında hızlı bir **yan soru**dur.
|
||||
`/btw`, geçerli oturum hakkında hızlı bir **yan soru** sormayı sağlar.
|
||||
|
||||
Normal sohbetten farklı olarak:
|
||||
|
||||
- geçerli oturumu arka plan bağlamı olarak kullanır,
|
||||
- ayrı, **araçsız** tek seferlik bir çağrı olarak çalışır,
|
||||
- ayrı bir **araçsız** tek seferlik çağrı olarak çalışır,
|
||||
- gelecekteki oturum bağlamını değiştirmez,
|
||||
- döküm geçmişine yazılmaz,
|
||||
- normal asistan mesajı yerine canlı yan sonuç olarak teslim edilir.
|
||||
- transkript geçmişine yazılmaz,
|
||||
- normal bir yardımcı mesajı yerine canlı bir yan sonuç olarak teslim edilir.
|
||||
|
||||
Bu, ana görev
|
||||
devam ederken geçici bir açıklama istediğinizde `/btw` komutunu kullanışlı yapar.
|
||||
Bu da `/btw` komutunu, ana görev sürerken geçici bir açıklama istediğinizde kullanışlı hale getirir.
|
||||
|
||||
Örnek:
|
||||
|
||||
@ -390,5 +384,4 @@ devam ederken geçici bir açıklama istediğinizde `/btw` komutunu kullanışl
|
||||
/btw şu anda ne yapıyoruz?
|
||||
```
|
||||
|
||||
Tam davranış ve istemci UX
|
||||
ayrıntıları için [BTW Yan Sorular](/tr/tools/btw) bölümüne bakın.
|
||||
Tam davranış ve istemci UX ayrıntıları için [BTW Side Questions](/tr/tools/btw) bölümüne bakın.
|
||||
|
||||
@ -1,132 +1,132 @@
|
||||
---
|
||||
read_when:
|
||||
- Thinking, fast-mode veya verbose yönerge ayrıştırmasını ya da varsayılanlarını ayarlama
|
||||
summary: '`/think`, `/fast`, `/verbose`, `/trace` ve akıl yürütme görünürlüğü için yönerge söz dizimi'
|
||||
title: Thinking Düzeyleri
|
||||
- Düşünme, hızlı mod veya ayrıntılı yönerge ayrıştırmasını ya da varsayılanlarını ayarlama
|
||||
summary: '`/think`, `/fast`, `/verbose`, `/trace` için yönerge sözdizimi ve akıl yürütme görünürlüğü'
|
||||
title: Düşünme Düzeyleri
|
||||
x-i18n:
|
||||
generated_at: "2026-04-23T09:12:07Z"
|
||||
generated_at: "2026-04-23T13:58:44Z"
|
||||
model: gpt-5.4
|
||||
provider: openai
|
||||
source_hash: 66033bb9272c9b9ea8fc85dc91e33e95ce4c469c56a8cd10c19632a5aa8a2338
|
||||
source_hash: 4efe899f7b47244745a105583b3239effa7975fadd06bd7bcad6327afcc91207
|
||||
source_path: tools/thinking.md
|
||||
workflow: 15
|
||||
---
|
||||
|
||||
# Thinking Düzeyleri (/think yönergeleri)
|
||||
# Düşünme Düzeyleri (`/think` yönergeleri)
|
||||
|
||||
## Ne yapar
|
||||
|
||||
- Herhangi bir gelen gövdede satır içi yönerge: `/t <level>`, `/think:<level>` veya `/thinking <level>`.
|
||||
- Düzeyler (takma adlar): `off | minimal | low | medium | high | xhigh | adaptive | max`
|
||||
- minimal → “think”
|
||||
- low → “think hard”
|
||||
- medium → “think harder”
|
||||
- high → “ultrathink” (azami bütçe)
|
||||
- xhigh → “ultrathink+” (GPT-5.2 + Codex modelleri ve Anthropic Claude Opus 4.7 effort)
|
||||
- adaptive → sağlayıcı tarafından yönetilen uyarlanabilir thinking (Anthropic/Bedrock üzerindeki Claude 4.6 ve Anthropic Claude Opus 4.7 için desteklenir)
|
||||
- max → sağlayıcı azami akıl yürütme (şu anda Anthropic Claude Opus 4.7)
|
||||
- `x-high`, `x_high`, `extra-high`, `extra high` ve `extra_high`, `xhigh` değerine eşlenir.
|
||||
- `highest`, `high` değerine eşlenir.
|
||||
- low → “çok düşün”
|
||||
- medium → “daha çok düşün”
|
||||
- high → “ultrathink” (maksimum bütçe)
|
||||
- xhigh → “ultrathink+” (GPT-5.2 + Codex modelleri ve Anthropic Claude Opus 4.7 çabası)
|
||||
- adaptive → sağlayıcı tarafından yönetilen uyarlanabilir düşünme (Anthropic/Bedrock üzerindeki Claude 4.6 ve Anthropic Claude Opus 4.7 için desteklenir)
|
||||
- max → sağlayıcının maksimum akıl yürütmesi (şu anda Anthropic Claude Opus 4.7)
|
||||
- `x-high`, `x_high`, `extra-high`, `extra high` ve `extra_high`, `xhigh` ile eşlenir.
|
||||
- `highest`, `high` ile eşlenir.
|
||||
- Sağlayıcı notları:
|
||||
- Thinking menüleri ve seçicileri sağlayıcı profiline göre belirlenir. Sağlayıcı Plugin'leri seçilen model için tam düzey kümesini, `on` gibi ikili etiketler dahil, bildirir.
|
||||
- `adaptive`, `xhigh` ve `max` yalnızca bunları destekleyen sağlayıcı/model profilleri için duyurulur. Desteklenmeyen düzeyler için yazılmış yönergeler, o modelin geçerli seçenekleriyle reddedilir.
|
||||
- Saklanmış mevcut desteklenmeyen düzeyler sağlayıcı profil sırasına göre yeniden eşlenir. `adaptive`, uyarlanabilir olmayan modellerde `medium` değerine geri düşer; `xhigh` ve `max` ise seçilen model için desteklenen en büyük off-olmayan düzeye geri düşer.
|
||||
- Anthropic Claude 4.6 modelleri, açık bir thinking düzeyi ayarlı değilse varsayılan olarak `adaptive` kullanır.
|
||||
- Anthropic Claude Opus 4.7 varsayılan olarak adaptive thinking kullanmaz. API effort varsayılanı, siz açıkça bir thinking düzeyi ayarlamadıkça sağlayıcıya ait kalır.
|
||||
- Anthropic Claude Opus 4.7, `/think xhigh` komutunu adaptive thinking artı `output_config.effort: "xhigh"` olarak eşler; çünkü `/think` bir thinking yönergesidir ve `xhigh` Opus 4.7 effort ayarıdır.
|
||||
- Anthropic Claude Opus 4.7 ayrıca `/think max` değerini de açığa çıkarır; bu aynı sağlayıcıya ait azami effort yoluna eşlenir.
|
||||
- OpenAI GPT modelleri, `/think` komutunu modele özgü Responses API effort desteği üzerinden eşler. `/think off`, yalnızca hedef model bunu desteklediğinde `reasoning.effort: "none"` gönderir; aksi halde OpenClaw desteklenmeyen bir değer göndermek yerine devre dışı reasoning yükünü atlar.
|
||||
- Anthropic uyumlu akış yolundaki MiniMax (`minimax/*`), model params veya istek params içinde açıkça thinking ayarlamadığınız sürece varsayılan olarak `thinking: { type: "disabled" }` kullanır. Bu, MiniMax'ın yerel olmayan Anthropic akış biçiminden `reasoning_content` delta'larının sızmasını önler.
|
||||
- Z.AI (`zai/*`) yalnızca ikili thinking destekler (`on`/`off`). `off` olmayan her düzey `on` olarak değerlendirilir (`low` değerine eşlenir).
|
||||
- Moonshot (`moonshot/*`), `/think off` değerini `thinking: { type: "disabled" }`, `off` olmayan her düzeyi ise `thinking: { type: "enabled" }` olarak eşler. Thinking etkin olduğunda Moonshot yalnızca `tool_choice` olarak `auto|none` kabul eder; OpenClaw uyumsuz değerleri `auto` olarak normalleştirir.
|
||||
- Düşünme menüleri ve seçicileri, sağlayıcı profiline göre belirlenir. Sağlayıcı Plugin'leri, `on` gibi ikili etiketler dahil seçili model için tam düzey kümesini bildirir.
|
||||
- `adaptive`, `xhigh` ve `max` yalnızca bunları destekleyen sağlayıcı/model profilleri için gösterilir. Desteklenmeyen düzeyler için yazılmış yönergeler, o modelin geçerli seçenekleriyle birlikte reddedilir.
|
||||
- Daha önce kaydedilmiş ama desteklenmeyen düzeyler, sağlayıcı profili sıralamasına göre yeniden eşlenir. `adaptive`, uyarlanabilir olmayan modellerde `medium` düzeyine geri düşer; `xhigh` ve `max` ise seçili model için desteklenen en büyük `off` dışı düzeye geri düşer.
|
||||
- Anthropic Claude 4.6 modelleri, açık bir düşünme düzeyi ayarlanmamışsa varsayılan olarak `adaptive` kullanır.
|
||||
- Anthropic Claude Opus 4.7 varsayılan olarak uyarlanabilir düşünme kullanmaz. Açıkça bir düşünme düzeyi ayarlamadığınız sürece API çaba varsayılanı sağlayıcıya aittir.
|
||||
- Anthropic Claude Opus 4.7, `/think xhigh` ifadesini uyarlanabilir düşünme artı `output_config.effort: "xhigh"` olarak eşler; çünkü `/think` bir düşünme yönergesidir ve `xhigh`, Opus 4.7 çaba ayarıdır.
|
||||
- Anthropic Claude Opus 4.7 ayrıca `/think max` sunar; bu da sağlayıcıya ait aynı maksimum çaba yoluna eşlenir.
|
||||
- OpenAI GPT modelleri, `/think` ifadesini modele özel Responses API çaba desteği üzerinden eşler. `/think off`, yalnızca hedef model bunu destekliyorsa `reasoning.effort: "none"` gönderir; aksi durumda OpenClaw desteklenmeyen bir değer göndermek yerine devre dışı bırakılmış akıl yürütme yükünü atlar.
|
||||
- Anthropic uyumlu akış yolundaki MiniMax (`minimax/*`), düşünmeyi model parametrelerinde veya istek parametrelerinde açıkça ayarlamadığınız sürece varsayılan olarak `thinking: { type: "disabled" }` kullanır. Bu, MiniMax’ın yerel olmayan Anthropic akış biçiminden sızan `reasoning_content` deltalarını önler.
|
||||
- Z.AI (`zai/*`) yalnızca ikili düşünmeyi (`on`/`off`) destekler. `off` dışındaki her düzey `on` olarak ele alınır (`low` ile eşlenir).
|
||||
- Moonshot (`moonshot/*`), `/think off` ifadesini `thinking: { type: "disabled" }`, `off` dışındaki her düzeyi ise `thinking: { type: "enabled" }` olarak eşler. Düşünme etkinken Moonshot yalnızca `tool_choice` için `auto|none` kabul eder; OpenClaw uyumsuz değerleri `auto` olarak normalleştirir.
|
||||
|
||||
## Çözümleme sırası
|
||||
|
||||
1. Mesaj üzerindeki satır içi yönerge (yalnızca o mesaja uygulanır).
|
||||
2. Oturum geçersiz kılması (yalnızca yönergeden oluşan bir mesaj gönderilerek ayarlanır).
|
||||
3. Ajan başına varsayılan (`config` içinde `agents.list[].thinkingDefault`).
|
||||
4. Genel varsayılan (`config` içinde `agents.defaults.thinkingDefault`).
|
||||
5. Geri dönüş: mevcut olduğunda sağlayıcının bildirdiği varsayılan, reasoning yetenekli olarak işaretlenmiş diğer katalog modelleri için `low`, aksi halde `off`.
|
||||
1. Mesajdaki satır içi yönerge (yalnızca o mesaja uygulanır).
|
||||
2. Oturum geçersiz kılması (yalnızca yönerge içeren bir mesaj gönderilerek ayarlanır).
|
||||
3. Aracı başına varsayılan (`agents.list[].thinkingDefault` config içinde).
|
||||
4. Genel varsayılan (`agents.defaults.thinkingDefault` config içinde).
|
||||
5. Geri dönüş: varsa sağlayıcının bildirdiği varsayılan; aksi halde akıl yürütebilen modeller `medium` ya da o model için desteklenen en yakın `off` dışı düzeye çözülür ve akıl yürütmeyen modeller `off` olarak kalır.
|
||||
|
||||
## Bir oturum varsayılanı ayarlama
|
||||
## Oturum varsayılanı ayarlama
|
||||
|
||||
- **Yalnızca** yönergeden oluşan bir mesaj gönderin (boşluk kabul edilir), örneğin `/think:medium` veya `/t high`.
|
||||
- Bu, geçerli oturum için kalıcı olur (varsayılan olarak gönderici başına); `/think:off` veya oturum boşta sıfırlaması ile temizlenir.
|
||||
- Onay yanıtı gönderilir (`Thinking level set to high.` / `Thinking disabled.`). Düzey geçersizse (ör. `/thinking big`) komut bir ipucuyla reddedilir ve oturum durumu değiştirilmeden kalır.
|
||||
- Geçerli thinking düzeyini görmek için argümansız `/think` (veya `/think:`) gönderin.
|
||||
- **Yalnızca** yönergeden oluşan bir mesaj gönderin (boşluk olabilir), örneğin `/think:medium` veya `/t high`.
|
||||
- Bu, geçerli oturum için kalıcı olur (varsayılan olarak gönderici başına); `/think:off` veya oturum boşta kalma sıfırlamasıyla temizlenir.
|
||||
- Onay yanıtı gönderilir (`Thinking level set to high.` / `Thinking disabled.`). Düzey geçersizse (ör. `/thinking big`), komut bir ipucuyla reddedilir ve oturum durumu değiştirilmez.
|
||||
- Geçerli düşünme düzeyini görmek için bağımsız olarak `/think` (veya `/think:`) gönderin.
|
||||
|
||||
## Ajan tarafından uygulama
|
||||
## Aracıya göre uygulama
|
||||
|
||||
- **Embedded Pi**: çözümlenen düzey, süreç içi Pi ajan çalışma zamanına geçirilir.
|
||||
- **Gömülü Pi**: çözümlenen düzey, süreç içi Pi aracı çalışma zamanına iletilir.
|
||||
|
||||
## Fast mode (/fast)
|
||||
## Hızlı mod (`/fast`)
|
||||
|
||||
- Düzeyler: `on|off`.
|
||||
- Yalnızca yönergeden oluşan mesaj, oturum fast-mode geçersiz kılmasını değiştirir ve `Fast mode enabled.` / `Fast mode disabled.` yanıtını verir.
|
||||
- Geçerli etkin fast-mode durumunu görmek için kip vermeden `/fast` (veya `/fast status`) gönderin.
|
||||
- OpenClaw fast mode'u şu sırayla çözümler:
|
||||
1. Satır içi/yalnızca yönerge `/fast on|off`
|
||||
- Yalnızca yönergeden oluşan mesaj, bir oturum hızlı mod geçersiz kılmasını değiştirir ve `Fast mode enabled.` / `Fast mode disabled.` yanıtını verir.
|
||||
- Geçerli etkili hızlı mod durumunu görmek için kip belirtmeden `/fast` (veya `/fast status`) gönderin.
|
||||
- OpenClaw hızlı modu şu sırayla çözümler:
|
||||
1. Satır içi/yalnızca yönerge içeren `/fast on|off`
|
||||
2. Oturum geçersiz kılması
|
||||
3. Ajan başına varsayılan (`agents.list[].fastModeDefault`)
|
||||
4. Model başına yapılandırma: `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
3. Aracı başına varsayılan (`agents.list[].fastModeDefault`)
|
||||
4. Model başına config: `agents.defaults.models["<provider>/<model>"].params.fastMode`
|
||||
5. Geri dönüş: `off`
|
||||
- `openai/*` için fast mode, desteklenen Responses isteklerinde `service_tier=priority` göndererek OpenAI öncelikli işlemeye eşlenir.
|
||||
- `openai-codex/*` için fast mode, Codex Responses üzerinde aynı `service_tier=priority` bayrağını gönderir. OpenClaw her iki auth yolu için de tek bir paylaşılan `/fast` geçişi tutar.
|
||||
- `api.anthropic.com` adresine gönderilen OAuth ile kimliği doğrulanmış trafik dahil doğrudan herkese açık `anthropic/*` istekleri için fast mode, Anthropic hizmet katmanlarına eşlenir: `/fast on`, `service_tier=auto`; `/fast off`, `service_tier=standard_only` ayarlar.
|
||||
- Anthropic uyumlu yoldaki `minimax/*` için `/fast on` (veya `params.fastMode: true`) `MiniMax-M2.7` değerini `MiniMax-M2.7-highspeed` olarak yeniden yazar.
|
||||
- Açık Anthropic `serviceTier` / `service_tier` model params, ikisi birden ayarlandığında fast-mode varsayılanını geçersiz kılar. OpenClaw, Anthropic hizmet katmanı enjeksiyonunu Anthropic olmayan proxy temel URL'leri için yine de atlar.
|
||||
- `/status`, yalnızca fast mode etkin olduğunda `Fast` gösterir.
|
||||
- `openai/*` için hızlı mod, desteklenen Responses isteklerinde `service_tier=priority` göndererek OpenAI öncelikli işlemeye eşlenir.
|
||||
- `openai-codex/*` için hızlı mod, Codex Responses üzerinde aynı `service_tier=priority` işaretini gönderir. OpenClaw her iki kimlik doğrulama yolu için tek bir paylaşılan `/fast` anahtarı kullanır.
|
||||
- `api.anthropic.com` adresine gönderilen OAuth ile kimliği doğrulanmış trafik dahil, doğrudan genel `anthropic/*` istekleri için hızlı mod Anthropic hizmet katmanlarına eşlenir: `/fast on`, `service_tier=auto` ayarlar; `/fast off`, `service_tier=standard_only` ayarlar.
|
||||
- Anthropic uyumlu yoldaki `minimax/*` için `/fast on` (veya `params.fastMode: true`), `MiniMax-M2.7` değerini `MiniMax-M2.7-highspeed` olarak yeniden yazar.
|
||||
- Açık Anthropic `serviceTier` / `service_tier` model parametreleri, her ikisi de ayarlandığında hızlı mod varsayılanını geçersiz kılar. OpenClaw yine de Anthropic olmayan proxy temel URL’leri için Anthropic hizmet katmanı eklemeyi atlar.
|
||||
- `/status`, hızlı mod yalnızca etkin olduğunda `Fast` gösterir.
|
||||
|
||||
## Verbose yönergeleri (/verbose veya /v)
|
||||
## Ayrıntılı yönergeler (`/verbose` veya `/v`)
|
||||
|
||||
- Düzeyler: `on` (minimal) | `full` | `off` (varsayılan).
|
||||
- Yalnızca yönergeden oluşan mesaj, oturum verbose durumunu değiştirir ve `Verbose logging enabled.` / `Verbose logging disabled.` yanıtını verir; geçersiz düzeyler durumu değiştirmeden ipucu döndürür.
|
||||
- `/verbose off`, açık bir oturum geçersiz kılması depolar; bunu Sessions UI üzerinden `inherit` seçerek temizleyin.
|
||||
- Satır içi yönerge yalnızca o mesaja uygulanır; aksi durumda oturum/genel varsayılanlar geçerlidir.
|
||||
- Geçerli verbose düzeyini görmek için argümansız `/verbose` (veya `/verbose:`) gönderin.
|
||||
- Verbose açık olduğunda, yapılandırılmış tool result'lar yayan ajanlar (Pi, diğer JSON ajanları) her tool call'ı, mevcut olduğunda `<emoji> <tool-name>: <arg>` önekiyle (yol/komut) kendi yalnızca üst veri mesajı olarak geri gönderir. Bu tool özetleri, her araç başlar başlamaz (ayrı baloncuklar halinde) gönderilir; akış delta'ları olarak değil.
|
||||
- Tool failure özetleri normal kipte görünür kalır, ancak ham hata ayrıntısı sonekleri verbose `on` veya `full` olmadıkça gizlenir.
|
||||
- Verbose `full` olduğunda, tool çıktıları tamamlandıktan sonra da iletilir (ayrı baloncuk, güvenli bir uzunluğa kısaltılmış). Bir çalıştırma sürerken `/verbose on|full|off` değiştirirseniz, sonraki tool baloncukları yeni ayara uyar.
|
||||
- Yalnızca yönergeden oluşan mesaj oturum ayrıntı düzeyini değiştirir ve `Verbose logging enabled.` / `Verbose logging disabled.` yanıtını verir; geçersiz düzeyler durumu değiştirmeden bir ipucu döndürür.
|
||||
- `/verbose off`, açık bir oturum geçersiz kılması saklar; bunu Sessions UI içinden `inherit` seçerek temizleyin.
|
||||
- Satır içi yönerge yalnızca o mesaja uygulanır; aksi halde oturum/genel varsayılanlar geçerlidir.
|
||||
- Geçerli ayrıntı düzeyini görmek için bağımsız olarak `/verbose` (veya `/verbose:`) gönderin.
|
||||
- Ayrıntılı mod açıkken, yapılandırılmış araç sonuçları üreten aracılar (Pi, diğer JSON aracılar) her araç çağrısını kendi meta veri mesajı olarak geri gönderir; mümkünse başına `<emoji> <tool-name>: <arg>` eklenir (yol/komut). Bu araç özetleri, her araç başlar başlamaz gönderilir (ayrı baloncuklar hâlinde), akış deltaları olarak değil.
|
||||
- Araç hata özetleri normal modda görünür kalır, ancak ham hata ayrıntısı sonekleri yalnızca `verbose` değeri `on` veya `full` olduğunda gösterilir.
|
||||
- `verbose` değeri `full` olduğunda, araç çıktıları tamamlandıktan sonra da iletilir (ayrı baloncuk, güvenli uzunluğa kısaltılmış biçimde). Bir çalışma devam ederken `/verbose on|full|off` değiştirirseniz, sonraki araç baloncukları yeni ayara uyar.
|
||||
|
||||
## Plugin izleme yönergeleri (/trace)
|
||||
## Plugin izleme yönergeleri (`/trace`)
|
||||
|
||||
- Düzeyler: `on` | `off` (varsayılan).
|
||||
- Yalnızca yönergeden oluşan mesaj, oturum Plugin izleme çıktısını değiştirir ve `Plugin trace enabled.` / `Plugin trace disabled.` yanıtını verir.
|
||||
- Satır içi yönerge yalnızca o mesaja uygulanır; aksi durumda oturum/genel varsayılanlar geçerlidir.
|
||||
- Geçerli trace düzeyini görmek için argümansız `/trace` (veya `/trace:`) gönderin.
|
||||
- `/trace`, `/verbose` komutundan daha dardır: yalnızca Active Memory hata ayıklama özetleri gibi Plugin'e ait trace/debug satırlarını açığa çıkarır.
|
||||
- Trace satırları `/status` içinde ve normal assistant yanıtından sonra takip tanılama mesajı olarak görünebilir.
|
||||
- Satır içi yönerge yalnızca o mesaja uygulanır; aksi halde oturum/genel varsayılanlar geçerlidir.
|
||||
- Geçerli izleme düzeyini görmek için bağımsız olarak `/trace` (veya `/trace:`) gönderin.
|
||||
- `/trace`, `/verbose` değerinden daha dardır: yalnızca Active Memory hata ayıklama özetleri gibi Plugin sahipliğindeki izleme/hata ayıklama satırlarını gösterir.
|
||||
- İzleme satırları `/status` içinde ve normal asistan yanıtından sonra takip eden bir tanılama mesajı olarak görünebilir.
|
||||
|
||||
## Akıl yürütme görünürlüğü (/reasoning)
|
||||
## Akıl yürütme görünürlüğü (`/reasoning`)
|
||||
|
||||
- Düzeyler: `on|off|stream`.
|
||||
- Yalnızca yönergeden oluşan mesaj, yanıtlar içinde thinking bloklarının gösterilip gösterilmeyeceğini değiştirir.
|
||||
- Etkin olduğunda akıl yürütme, `Reasoning:` önekiyle **ayrı bir mesaj** olarak gönderilir.
|
||||
- `stream` (yalnızca Telegram): akıl yürütmeyi yanıt üretilirken Telegram taslak baloncuğuna akıtır, ardından nihai yanıtı akıl yürütme olmadan gönderir.
|
||||
- Yalnızca yönergeden oluşan mesaj, düşünme bloklarının yanıtlarda gösterilip gösterilmeyeceğini değiştirir.
|
||||
- Etkin olduğunda akıl yürütme, başında `Reasoning:` bulunan **ayrı bir mesaj** olarak gönderilir.
|
||||
- `stream` (yalnızca Telegram): yanıt oluşturulurken akıl yürütmeyi Telegram taslak baloncuğuna akıtır, ardından son yanıtı akıl yürütme olmadan gönderir.
|
||||
- Takma ad: `/reason`.
|
||||
- Geçerli akıl yürütme düzeyini görmek için argümansız `/reasoning` (veya `/reasoning:`) gönderin.
|
||||
- Çözümleme sırası: satır içi yönerge, sonra oturum geçersiz kılması, sonra ajan başına varsayılan (`agents.list[].reasoningDefault`), sonra geri dönüş (`off`).
|
||||
- Geçerli akıl yürütme düzeyini görmek için bağımsız olarak `/reasoning` (veya `/reasoning:`) gönderin.
|
||||
- Çözümleme sırası: satır içi yönerge, ardından oturum geçersiz kılması, ardından aracı başına varsayılan (`agents.list[].reasoningDefault`), ardından geri dönüş (`off`).
|
||||
|
||||
## İlgili
|
||||
|
||||
- Elevated mode belgeleri [Elevated mode](/tr/tools/elevated) sayfasında bulunur.
|
||||
- Yükseltilmiş mod belgeleri [Elevated mode](/tr/tools/elevated) altında yer alır.
|
||||
|
||||
## Heartbeat'ler
|
||||
|
||||
- Heartbeat yoklama gövdesi, yapılandırılmış Heartbeat istemidir (varsayılan: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Heartbeat mesajındaki satır içi yönergeler her zamanki gibi uygulanır (ancak Heartbeat'lerden oturum varsayılanlarını değiştirmekten kaçının).
|
||||
- Heartbeat teslimi varsayılan olarak yalnızca nihai yükü gönderir. Ayrı `Reasoning:` mesajını da göndermek için (mevcutsa), `agents.defaults.heartbeat.includeReasoning: true` veya ajan başına `agents.list[].heartbeat.includeReasoning: true` ayarlayın.
|
||||
- Heartbeat yoklama gövdesi, yapılandırılmış heartbeat istemidir (varsayılan: `Read HEARTBEAT.md if it exists (workspace context). Follow it strictly. Do not infer or repeat old tasks from prior chats. If nothing needs attention, reply HEARTBEAT_OK.`). Bir heartbeat mesajındaki satır içi yönergeler normal şekilde uygulanır (ancak heartbeat'lerden oturum varsayılanlarını değiştirmekten kaçının).
|
||||
- Heartbeat teslimi varsayılan olarak yalnızca son yükü gönderir. Ayrı `Reasoning:` mesajını da göndermek için (varsa), `agents.defaults.heartbeat.includeReasoning: true` veya aracı başına `agents.list[].heartbeat.includeReasoning: true` ayarlayın.
|
||||
|
||||
## Web sohbet UI
|
||||
|
||||
- Web sohbeti thinking seçicisi, sayfa yüklenirken gelen oturum deposundan/yapılandırmadan oturumun saklanan düzeyini yansıtır.
|
||||
- Başka bir düzey seçmek, oturum geçersiz kılmasını hemen `sessions.patch` üzerinden yazar; sonraki gönderimi beklemez ve tek seferlik bir `thinkingOnce` geçersiz kılması değildir.
|
||||
- İlk seçenek her zaman `Default (<resolved level>)` olur; burada çözümlenen varsayılan, etkin oturum modelinin sağlayıcı thinking profilinden gelir.
|
||||
- Seçici, Gateway oturum satırı tarafından döndürülen `thinkingOptions` değerini kullanır. Tarayıcı UI kendi sağlayıcı regex listesini tutmaz; modele özgü düzey kümelerinin sahibi Plugin'lerdir.
|
||||
- `/think:<level>` yine çalışır ve aynı saklanan oturum düzeyini günceller; böylece sohbet yönergeleri ve seçici eşzamanlı kalır.
|
||||
- Sayfa yüklendiğinde web sohbet düşünme seçicisi, gelen oturum deposu/config içindeki oturumda saklanan düzeyi yansıtır.
|
||||
- Başka bir düzey seçmek, `sessions.patch` aracılığıyla oturum geçersiz kılmasını hemen yazar; bir sonraki gönderimi beklemez ve tek seferlik bir `thinkingOnce` geçersiz kılması değildir.
|
||||
- İlk seçenek her zaman `Default (<resolved level>)` olur; burada çözümlenen varsayılan, etkin oturum modelinin sağlayıcı düşünme profilinden ve `/status` ile `session_status` tarafından kullanılan aynı geri dönüş mantığından gelir.
|
||||
- Seçici, Gateway oturum satırı tarafından döndürülen `thinkingOptions` değerlerini kullanır. Tarayıcı UI kendi sağlayıcı regex listesini tutmaz; modele özgü düzey kümelerinin sahibi Plugin'lerdir.
|
||||
- `/think:<level>` hâlâ çalışır ve oturumda saklanan aynı düzeyi günceller; böylece sohbet yönergeleri ve seçici senkronize kalır.
|
||||
|
||||
## Sağlayıcı profilleri
|
||||
|
||||
- Sağlayıcı Plugin'leri, modelin desteklenen düzeylerini ve varsayılanını tanımlamak için `resolveThinkingProfile(ctx)` açığa çıkarabilir.
|
||||
- Her profil düzeyinin saklanan kanonik bir `id` değeri vardır (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` veya `max`) ve bir görüntüleme `label` değeri içerebilir. İkili sağlayıcılar `{ id: "low", label: "on" }` kullanır.
|
||||
- Yayınlanmış eski Hook'lar (`supportsXHighThinking`, `isBinaryThinking` ve `resolveDefaultThinkingLevel`) uyumluluk bağdaştırıcıları olarak kalır, ancak yeni özel düzey kümeleri `resolveThinkingProfile` kullanmalıdır.
|
||||
- Gateway satırları `thinkingOptions` ve `thinkingDefault` açığa çıkarır; böylece ACP/sohbet istemcileri çalışma zamanı doğrulamasının kullandığı aynı profili işler.
|
||||
- Sağlayıcı Plugin'leri, modelin desteklenen düzeylerini ve varsayılanını tanımlamak için `resolveThinkingProfile(ctx)` sunabilir.
|
||||
- Her profil düzeyinin saklanan kurallı bir `id` değeri vardır (`off`, `minimal`, `low`, `medium`, `high`, `xhigh`, `adaptive` veya `max`) ve bir görüntüleme `label` değeri içerebilir. İkili sağlayıcılar `{ id: "low", label: "on" }` kullanır.
|
||||
- Yayınlanmış eski kancalar (`supportsXHighThinking`, `isBinaryThinking` ve `resolveDefaultThinkingLevel`) uyumluluk bağdaştırıcıları olarak kalır, ancak yeni özel düzey kümeleri `resolveThinkingProfile` kullanmalıdır.
|
||||
- Gateway satırları `thinkingOptions` ve `thinkingDefault` değerlerini açığa çıkarır; böylece ACP/sohbet istemcileri, çalışma zamanı doğrulamasının kullandığı aynı profili işler.
|
||||
|
||||
Loading…
Reference in New Issue
Block a user