Yürütme onayları

Exec onayları, korumalı alandaki bir aracının gerçek bir ana makinede (gateway veya node) komut çalıştırmasına izin vermek için kullanılan yardımcı uygulama / Node ana makinesi güvenlik rayıdır. Bir güvenlik kilidi: komutlara yalnızca politika + izin listesi + (isteğe bağlı) kullanıcı onayı birlikte kabul ettiğinde izin verilir. Exec onayları, araç politikasının ve yükseltilmiş geçit denetiminin üzerine eklenir (full olarak ayarlanmış yükseltilmiş mod hariç; bu durumda onaylar atlanır).

deny, allowlist, ask, auto, full, Codex Guardian eşlemesi ve ACPX harness izinlerine mod öncelikli bir genel bakış için bkz. İzin modları.

Etkili politikayı inceleme

Yerel bir kapsam host=node istediğinde, exec-policy show bu kapsamı yerel onay dosyasını doğruluk kaynağı gibi göstermek yerine çalışma zamanında Node tarafından yönetiliyor olarak bildirir.

Yardımcı uygulama kullanıcı arayüzü kullanılamıyorsa, normalde istem gösterecek her istek ask fallback ile çözümlenir (varsayılan: deny).

Nerede uygulanır

Exec onayları yürütme ana makinesinde yerel olarak zorunlu kılınır:

• Gateway ana makinesi → Gateway makinesindeki openclaw süreci.
• Node ana makinesi → Node çalıştırıcısı (macOS yardımcı uygulaması veya başsız Node ana makinesi).

Güven modeli

• Gateway ile kimlik doğrulaması yapılmış çağıranlar, o Gateway için güvenilir operatörlerdir.
• Eşlenmiş Node'lar bu güvenilir operatör yeteneğini Node ana makinesine taşır.
• Exec onayları yanlışlıkla yürütme riskini azaltır, ancak kullanıcı başına bir kimlik doğrulama sınırı veya dosya sistemi salt okunur politikası değildir.
• Onaylandıktan sonra, bir komut seçilen ana makine veya korumalı alan dosya sistemi izinlerine göre dosyaları değiştirebilir.
• Onaylı Node ana makinesi çalıştırmaları kanonik yürütme bağlamını bağlar: kanonik cwd, kesin argv, varsa env bağlaması ve uygulanabiliyorsa sabitlenmiş yürütülebilir dosya yolu.
• Kabuk betikleri ve doğrudan yorumlayıcı/çalışma zamanı dosya çağrıları için OpenClaw ayrıca tek bir somut yerel dosya işlenenini bağlamaya çalışır. Bu bağlı dosya onaydan sonra ancak yürütmeden önce değişirse, kaymış içerik yürütülmek yerine çalışma reddedilir.
• Dosya bağlama kasıtlı olarak en iyi çaba düzeyindedir; her yorumlayıcı/çalışma zamanı yükleyici yolunun eksiksiz bir semantik modeli değildir. Onay modu bağlanacak tam olarak tek bir somut yerel dosyayı tanımlayamazsa, tam kapsama varmış gibi davranmak yerine onay destekli bir çalıştırma üretmeyi reddeder.

macOS ayrımı

• Node ana makine hizmeti, system.run çağrısını yerel IPC üzerinden macOS uygulamasına iletir.
• macOS uygulaması onayları zorunlu kılar ve komutu kullanıcı arayüzü bağlamında yürütür.

Ayarlar ve depolama

Onaylar yürütme ana makinesindeki yerel bir JSON dosyasında bulunur. OPENCLAW_STATE_DIR ayarlandığında dosya bu durum dizinini izler; aksi halde varsayılan OpenClaw durum dizinini kullanır:

$OPENCLAW_STATE_DIR/exec-approvals.json# otherwise~/.openclaw/exec-approvals.json

Varsayılan onay soketi aynı kökü izler: $OPENCLAW_STATE_DIR/exec-approvals.sock veya değişken ayarlı olmadığında ~/.openclaw/exec-approvals.sock.

Örnek şema:

{  "version": 1,  "socket": {    "path": "~/.openclaw/exec-approvals.sock",    "token": "base64url-token"  },  "defaults": {    "security": "deny",    "ask": "on-miss",    "askFallback": "deny",    "autoAllowSkills": false  },  "agents": {    "main": {      "security": "allowlist",      "ask": "on-miss",      "askFallback": "deny",      "autoAllowSkills": true,      "allowlist": [        {          "id": "B0C8C0B3-2C2D-4F8A-9A3C-5A4B3C2D1E0F",          "pattern": "~/Projects/**/bin/rg",          "source": "allow-always",          "commandText": "rg -n TODO",          "lastUsedAt": 1737150000000,          "lastUsedCommand": "rg -n TODO",          "lastResolvedPath": "/Users/user/Projects/.../bin/rg"        }      ]    }  }}

Politika düğmeleri

tools.exec.mode

tools.exec.mode, ana makine exec için tercih edilen normalleştirilmiş politika yüzeyidir. Değerler şunlardır:

• deny - ana makine exec'i engelle.
• allowlist - yalnızca izin listesine alınmış komutları sormadan çalıştır.
• ask - izin listesi politikasını kullan ve eşleşmeyenlerde sor.
• auto - izin listesi politikasını kullan, belirleyici eşleşmeleri doğrudan çalıştır ve onay eşleşmeyenlerini insan onayı rotasına geri dönmeden önce OpenClaw'ın yerel otomatik inceleyicisine gönder.
• full - ana makine exec'i onay istemleri olmadan çalıştır.

Eski tools.exec.security / tools.exec.ask desteklenmeye devam eder ve daha dar oturum veya aracı kapsamında ayarlandığında hâlâ önceliklidir.

exec.security

exec.ask

askFallback

tools.exec.strictInlineEval

Katı modun yakaladığı örnekler:

• python -c
• node -e, node --eval, node -p
• ruby -e
• perl -e, perl -E
• php -r
• lua -e
• osascript -e

Katı modda bu komutlar yine açık onay gerektirir ve allow-always bunlar için yeni izin listesi girdilerini otomatik olarak kalıcılaştırmaz.

tools.exec.commandHighlighting

Bu ayar security, ask, izin listesi eşleşmesi, katı satır içi değerlendirme davranışı, onay iletimi veya komut yürütmeyi değiştirmez. Genel olarak tools.exec.commandHighlighting altında veya aracı başına agents.list[].tools.exec.commandHighlighting altında ayarlanabilir.

YOLO modu (onaysız)

Ana makine exec'in onay istemleri olmadan çalışmasını istiyorsanız, her iki politika katmanını da açmanız gerekir: OpenClaw yapılandırmasındaki istenen exec politikası (tools.exec.*) ve yürütme ana makinesi onay dosyasındaki ana makineye yerel onay politikası.

OpenClaw, atlanmış askFallback değerini varsayılan olarak deny yapar. Kullanıcı arayüzü olmayan bir onay isteminin izin vermeye geri dönmesi gerekiyorsa ana makine askFallback değerini açıkça full olarak ayarlayın.

Kendi etkileşimsiz izin modlarını sunan CLI destekli sağlayıcılar bu politikayı izleyebilir. Claude CLI, OpenClaw'ın etkili exec politikası YOLO olduğunda --permission-mode bypassPermissions ekler. OpenClaw tarafından yönetilen Claude canlı oturumlarında, OpenClaw'ın etkili exec politikası Claude'un yerel izin modu üzerinde yetkilidir: ham Claude arka uç argümanları başka bir mod belirtse bile YOLO canlı başlatmaları --permission-mode bypassPermissions olarak, kısıtlayıcı etkili exec politikası ise canlı başlatmaları --permission-mode default olarak normalleştirir.

Daha muhafazakâr bir kurulum istiyorsanız OpenClaw exec politikasını yeniden allowlist / on-miss veya deny değerlerine sıkılaştırın.

Kalıcı Gateway ana makinesi "asla sorma" kurulumu

openclaw config set tools.exec.host gatewayopenclaw config set tools.exec.security fullopenclaw config set tools.exec.ask offopenclaw gateway restart

openclaw approvals set --stdin <<'EOF'{  version: 1,  defaults: {    security: "full",    ask: "off",    askFallback: "full"  }}EOF

Yerel kısayol

openclaw exec-policy preset yolo

Bu yerel kısayol ikisini de günceller:

• Yerel tools.exec.host/security/ask.
• askFallback: "full" dahil yerel onay dosyası varsayılanları.

Kasıtlı olarak yalnızca yereldir. Gateway ana makinesi veya Node ana makinesi onaylarını uzaktan değiştirmek için openclaw approvals set --gateway veya openclaw approvals set --node <id|name|ip> kullanın.

Node ana makinesi

Bir Node ana makinesi için bunun yerine aynı onay dosyasını o Node üzerinde uygulayın:

openclaw approvals set --node <id|name|ip> --stdin <<'EOF'{  version: 1,  defaults: {    security: "full",    ask: "off",    askFallback: "full"  }}EOF

Yalnızca oturum kısayolu

• /exec security=full ask=off yalnızca geçerli oturumu değiştirir.
• /elevated full, yalnızca istenen policy ve host onayları dosyası security: "full" ve ask: "off" olarak çözümlendiğinde exec onaylarını atlayan bir acil durum kısayoludur. ask: "always" gibi daha sıkı bir host dosyası yine de istem gösterir.

Host onayları dosyası yapılandırmadan daha sıkı kalırsa, daha sıkı host policy yine kazanır.

İzin listesi (aracı başına)

İzin listeleri aracı başınadır. Birden çok aracı varsa, macOS uygulamasında hangi aracıyı düzenlediğinizi değiştirin. Desenler glob eşleşmeleridir.

Desenler çözümlenmiş ikili yol glob’ları veya yalın komut adı glob’ları olabilir. Yalın adlar yalnızca PATH üzerinden çağrılan komutlarla eşleşir; bu nedenle komut rg olduğunda rg, /opt/homebrew/bin/rg ile eşleşebilir, ancak ./rg veya /tmp/rg ile eşleşmez. Belirli bir ikili konumuna güvenmek istediğinizde yol glob’u kullanın.

Eski agents.default girdileri yükleme sırasında agents.main içine taşınır. echo ok && pwd gibi shell zincirlerinde de her üst düzey segmentin izin listesi kurallarını karşılaması gerekir.

Örnekler:

• rg
• ~/Projects/**/bin/peekaboo
• ~/.local/bin/*
• /opt/homebrew/bin/rg

argPattern ile argümanları kısıtlama

Bir izin listesi girdisinin bir ikiliyle ve belirli bir argüman şekliyle eşleşmesi gerekiyorsa argPattern ekleyin. OpenClaw, düzenli ifadeyi yürütülebilir token (argv[0]) hariç ayrıştırılmış komut argümanlarına göre değerlendirir. Elle yazılan girdilerde argümanlar tek bir boşlukla birleştirilir; bu nedenle tam eşleşmeye ihtiyacınız olduğunda deseni sabitleyin.

{  "version": 1,  "agents": {    "main": {      "allowlist": [        {          "pattern": "python3",          "argPattern": "^safe\\.py$"        }      ]    }  }}

Bu girdi python3 safe.py komutuna izin verir; python3 other.py izin listesi kaçırmasıdır. Aynı ikili için yalnızca yol içeren bir girdi de varsa, eşleşmeyen argümanlar yine bu yalnızca yol girdisine geri düşebilir. Amaç ikiliyi bildirilen argümanlarla kısıtlamaksa yalnızca yol girdisini atlayın.

Onay akışları tarafından kaydedilen girdiler, tam argv eşleştirmesi için dahili bir ayırıcı biçimi kullanabilir. Kodlanmış değeri elle düzenlemek yerine bu girdileri yeniden oluşturmak için UI veya onay akışını tercih edin. OpenClaw bir komut segmenti için argv ayrıştıramazsa, argPattern içeren girdiler eşleşmez.

Her izin listesi girdisi şunları destekler:

Skills CLI’larını otomatik izinli sayma

Skills CLI’larını otomatik izinli say etkinleştirildiğinde, bilinen Skills tarafından başvurulan yürütülebilirler Node’larda (macOS Node veya headless Node host) izin listesinde kabul edilir. Bu, Skill ikili listesini getirmek için Gateway RPC üzerinden skills.bins kullanır. Katı manuel izin listeleri istiyorsanız bunu devre dışı bırakın.

Güvenli ikililer ve onay iletme

Güvenli ikililer (yalnızca stdin hızlı yolu), yorumlayıcı bağlama ayrıntıları ve onay istemlerini Slack/Discord/Telegram’a iletme (veya bunları yerel onay istemcileri olarak çalıştırma) için Exec onayları - ileri düzey sayfasına bakın.

Control UI düzenleme

Varsayılanları, aracı başına geçersiz kılmaları ve izin listelerini düzenlemek için Control UI → Nodes → Exec approvals kartını kullanın. Bir kapsam seçin (Varsayılanlar veya bir aracı), policy’yi ayarlayın, izin listesi desenleri ekleyin/kaldırın, ardından Save seçin. UI, listeyi düzenli tutabilmeniz için her desenin son kullanım meta verilerini gösterir.

Hedef seçici Gateway (yerel onaylar) veya bir Node seçer. Node’lar system.execApprovals.get/set duyurmalıdır (macOS uygulaması veya headless Node host). Bir Node henüz exec onaylarını duyurmuyorsa, yerel onay dosyasını doğrudan düzenleyin.

CLI: openclaw approvals, Gateway veya Node düzenlemeyi destekler; bkz. Onaylar CLI.

Onay akışı

Bir istem gerektiğinde Gateway, operatör istemcilerine exec.approval.requested yayınlar. Control UI ve macOS uygulaması bunu exec.approval.resolve ile çözer, ardından Gateway onaylanan isteği Node host’a iletir.

host=node için onay istekleri kanonik bir systemRunPlan payload’u içerir. Gateway, onaylanmış system.run isteklerini iletirken bu planı yetkili command/cwd/session bağlamı olarak kullanır.

Bu, async onay gecikmesi için önemlidir:

• Node exec yolu baştan tek bir kanonik plan hazırlar.
• Onay kaydı bu planı ve bağlama meta verilerini saklar.
• Onaylandıktan sonra son iletilen system.run çağrısı, sonraki çağıran düzenlemelerine güvenmek yerine saklanan planı yeniden kullanır.
• Çağıran, onay isteği oluşturulduktan sonra command, rawCommand, cwd, agentId veya sessionKey değiştirirse Gateway iletilen çalıştırmayı onay uyumsuzluğu olarak reddeder.

Sistem olayları

Exec yaşam döngüsü sistem mesajları olarak gösterilir:

• Exec running (yalnızca komut çalışma bildirimi eşiğini aşarsa).
• Exec finished.

Bunlar, Node olayı raporladıktan sonra aracının oturumuna gönderilir. Reddedilen exec onayları host komutunun kendisi için terminaldir: komut çalışmaz. Kaynak oturumu olan ana aracı async onaylarında OpenClaw, reddi o oturuma dahili bir takip olarak geri gönderir; böylece aracı async komutu beklemeyi bırakabilir ve eksik sonuç onarımından kaçınabilir. Oturum yoksa veya oturum sürdürülemiyorsa OpenClaw yine de operatöre veya doğrudan sohbet rotasına kısa bir red bildirebilir. Alt aracı oturumları için redler alt aracıya geri gönderilmez. Gateway-host exec onayları, komut tamamlandığında (ve isteğe bağlı olarak eşikten daha uzun çalıştığında) aynı yaşam döngüsü olaylarını yayar. Onay kapılı exec’ler, kolay korelasyon için bu mesajlarda onay kimliğini runId olarak yeniden kullanır.

Reddedilen onay davranışı

Bir async exec onayı reddedildiğinde OpenClaw, host komutunu terminal kabul eder ve güvenli biçimde kapalı kalır. Ana aracı oturumlarında red, aracıya async komutun çalışmadığını söyleyen dahili bir oturum takibi olarak iletilir. Bu, eski komut çıktısını açığa çıkarmadan transcript sürekliliğini korur. Oturum teslimi kullanılamıyorsa OpenClaw, güvenli bir rota varsa kısa bir operatör veya doğrudan sohbet reddine geri düşer.

Sonuçlar

• full güçlüdür; mümkün olduğunda izin listelerini tercih edin.
• ask, hızlı onaylara izin verirken sizi döngünün içinde tutar.
• Aracı başına izin listeleri, bir aracının onaylarının diğerlerine sızmasını önler.
• Onaylar yalnızca yetkili göndericilerden gelen host exec isteklerine uygulanır. Yetkisiz göndericiler /exec çalıştıramaz.
• /exec security=full, yetkili operatörler için oturum düzeyinde bir kolaylıktır ve tasarımı gereği onayları atlar. Host exec’i sert biçimde engellemek için onay güvenliğini deny olarak ayarlayın veya tool policy üzerinden exec aracını reddedin.

İlgili