Durumda bir Node görünürken Node araçları başarısız olduğunda bu sayfayı kullanın.Documentation Index
Fetch the complete documentation index at: https://docs.openclaw.ai/llms.txt
Use this file to discover all available pages before exploring further.
Komut basamağı
- Node bağlıdır ve
noderolü için eşleştirilmiştir. nodes describe, çağırdığınız yeteneği içerir.- Exec onayları beklenen modu/izin listesini gösterir.
Ön plan gereksinimleri
canvas.*, camera.* ve screen.*, iOS/Android Node’larında yalnızca ön planda kullanılabilir.
Hızlı kontrol ve düzeltme:
NODE_BACKGROUND_UNAVAILABLE görürseniz Node uygulamasını ön plana getirin ve yeniden deneyin.
İzinler matrisi
| Yetenek | iOS | Android | macOS Node uygulaması | Tipik hata kodu |
|---|---|---|---|---|
camera.snap, camera.clip | Kamera (klip sesi için mikrofonla) | Kamera (klip sesi için mikrofonla) | Kamera (klip sesi için mikrofonla) | *_PERMISSION_REQUIRED |
screen.record | Ekran Kaydı (mikrofon isteğe bağlı) | Ekran yakalama istemi (mikrofon isteğe bağlı) | Ekran Kaydı | *_PERMISSION_REQUIRED |
location.get | Kullanırken veya Her Zaman (moda bağlı) | Moda göre ön plan/arka plan konumu | Konum izni | LOCATION_PERMISSION_REQUIRED |
system.run | yok (Node host yolu) | yok (Node host yolu) | Exec onayları gerekir | SYSTEM_RUN_DENIED |
Eşleştirme ve onaylar
Bunlar farklı kapılardır:- Cihaz eşleştirme: Bu Node Gateway’e bağlanabilir mi?
- Gateway Node komut ilkesi: RPC komut kimliğine
gateway.nodes.allowCommands/denyCommandsve platform varsayılanları tarafından izin veriliyor mu? - Exec onayları: Bu Node belirli bir kabuk komutunu yerel olarak çalıştırabilir mi?
nodes describe bir komutu göstermiyorsa Gateway Node komut ilkesini ve Node’un bağlanırken gerçekten o komutu bildirip bildirmediğini kontrol edin.
Eşleştirme düzgünse ancak system.run başarısız oluyorsa o Node’daki exec onaylarını/izin listesini düzeltin.
Node eşleştirme bir kimlik/güven kapısıdır, komut başına onay yüzeyi değildir. system.run için Node başına ilke, Gateway eşleştirme kaydında değil, o Node’un exec onayları dosyasında (openclaw approvals get --node ...) bulunur.
Onay destekli host=node çalıştırmaları için Gateway ayrıca yürütmeyi
hazırlanmış kanonik systemRunPlan değerine bağlar. Daha sonraki bir çağıran,
onaylanan çalıştırma iletilmeden önce komut/cwd veya oturum meta verilerini değiştirirse
Gateway, düzenlenen yükü güvenmek yerine çalıştırmayı onay uyumsuzluğu olarak reddeder.
Yaygın Node hata kodları
NODE_BACKGROUND_UNAVAILABLE→ uygulama arka planda; ön plana getirin.CAMERA_DISABLED→ Node ayarlarında kamera anahtarı devre dışı.*_PERMISSION_REQUIRED→ işletim sistemi izni eksik/reddedilmiş.LOCATION_DISABLED→ konum modu kapalı.LOCATION_PERMISSION_REQUIRED→ istenen konum modu verilmemiş.LOCATION_BACKGROUND_UNAVAILABLE→ uygulama arka planda, ancak yalnızca Kullanırken izni var.SYSTEM_RUN_DENIED: approval required→ exec isteği açık onay gerektiriyor.SYSTEM_RUN_DENIED: allowlist miss→ komut izin listesi modu tarafından engellendi. Windows Node host’larında,cmd.exe /c ...gibi kabuk sarmalayıcı biçimleri, soru akışı üzerinden onaylanmadıkça izin listesi modunda izin listesi kaçırmaları olarak ele alınır.
Hızlı kurtarma döngüsü
- Cihaz eşleştirmesini yeniden onaylayın.
- Node uygulamasını yeniden açın (ön plan).
- İşletim sistemi izinlerini yeniden verin.
- Exec onay ilkesini yeniden oluşturun/ayarlayın.