Nodes and media
Node sorun giderme
Durumda bir Node görünürken Node araçları başarısız oluyorsa bu sayfayı kullanın.
Komut sıralaması
openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probeArdından Node'a özgü kontrolleri çalıştırın:
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>Sağlıklı çalışma belirtileri:
- Node bağlıdır ve
noderolü için eşleştirilmiştir. nodes describe, çağırdığınız yeteneği içerir.- Çalıştırma onayları, beklenen modu/izin verilenler listesini gösterir.
Ön planda çalışma gereksinimleri
canvas.*, camera.* ve screen.*, iOS/Android Node'larında yalnızca ön planda çalışır.
Hızlı kontrol ve düzeltme:
openclaw nodes describe --node <idOrNameOrIp>openclaw nodes canvas snapshot --node <idOrNameOrIp>openclaw logs --followNODE_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 mikrofon) | Kamera (+ klip sesi için mikrofon) | Kamera (+ klip sesi için mikrofon) | *_PERMISSION_REQUIRED |
screen.record |
Ekran Kaydı (+ isteğe bağlı mikrofon) | Ekran yakalama istemi (+ isteğe bağlı mikrofon) | Ekran Kaydı | *_PERMISSION_REQUIRED |
computer.act |
geçerli değil | geçerli değil | Erişilebilirlik + Ekran Kaydı | COMPUTER_DISABLED, ACCESSIBILITY_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 |
geçerli değil (Node ana makine yolu) | geçerli değil (Node ana makine yolu) | Çalıştırma onayları gerekli | SYSTEM_RUN_DENIED |
Eşleştirme ve onaylar
Bir Node komutunun başarılı olup olmayacağını üç ayrı geçit denetler:
- Cihaz eşleştirmesi: Bu Node, Gateway'e bağlanabilir mi?
- Gateway Node komutu politikası: RPC komut kimliğine
gateway.nodes.commands.allow/gateway.nodes.commands.denyve platform varsayılanları tarafından izin veriliyor mu? - Çalıştırma onayları: Bu Node, belirli bir kabuk komutunu yerel olarak çalıştırabilir mi?
Node eşleştirmesi, komut başına bir onay yüzeyi değil, bir kimlik/güven geçididir. system.run için Node başına politika, Gateway eşleştirme kaydında değil, ilgili Node'un çalıştırma onayları dosyasında (openclaw approvals get --node ...) bulunur.
Hızlı kontroller:
openclaw devices listopenclaw nodes statusopenclaw approvals get --node <idOrNameOrIp>openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"- Eşleştirme eksik: Önce Node cihazını onaylayın.
nodes describeiçinde bir komut eksik: Gateway Node komutu politikasını ve Node'un bağlanırken bu komutu gerçekten bildirmiş olup olmadığını kontrol edin.- Eşleştirme sorunsuz ancak
system.runbaşarısız oluyor: İlgili Node'daki çalıştırma onaylarını/izin verilenler listesini düzeltin.
Onay destekli host=node çalıştırmalarında Gateway, yürütmeyi hazırlanmış standart systemRunPlan öğesine de bağlar. Daha sonraki bir çağıran, onaylanan çalıştırma iletilmeden önce komutu, cwd'yi veya oturum meta verilerini değiştirirse Gateway, düzenlenmiş yüke güvenmek yerine çalıştırmayı onay uyuşmazlığı nedeniyle reddeder.
Yaygın Node hata kodları
| Kod | Anlamı |
|---|---|
NODE_BACKGROUND_UNAVAILABLE |
Uygulama arka plandadır; ön plana getirin. |
CAMERA_DISABLED |
Node ayarlarında kamera anahtarı devre dışıdır. |
*_PERMISSION_REQUIRED |
İşletim sistemi izni eksik veya reddedilmiştir. |
LOCATION_DISABLED |
Konum modu kapalıdır. |
LOCATION_PERMISSION_REQUIRED |
İstenen konum modu için izin verilmemiştir. |
LOCATION_BACKGROUND_UNAVAILABLE |
Uygulama arka plandadır ancak yalnızca Kullanırken izni vardır. |
COMPUTER_DISABLED |
macOS uygulamasında Allow Computer Control seçeneğini etkinleştirin, ardından eşleştirme güncellemesini onaylayın. |
ACCESSIBILITY_REQUIRED |
macOS Sistem Ayarları'nda geçerli OpenClaw uygulama paketine Erişilebilirlik izni verin. |
SYSTEM_RUN_DENIED: approval required |
Çalıştırma isteği açık onay gerektirir. |
SYSTEM_RUN_DENIED: allowlist miss |
Komut, izin verilenler listesi modu tarafından engellendi. Windows Node ana makinelerinde cmd.exe /c ... gibi kabuk sarmalayıcı biçimleri, soru akışı üzerinden onaylanmadıkları sürece izin verilenler listesi modunda liste dışı kabul edilir. |
Hızlı kurtarma döngüsü
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>openclaw logs --followSorun hâlâ sürüyorsa:
- Cihaz eşleştirmesini yeniden onaylayın.
- Node uygulamasını yeniden açın (ön planda).
- İşletim sistemi izinlerini yeniden verin.
- Çalıştırma onayı politikasını yeniden oluşturun/ayarlayın.
Bilgisayar denetimi için ayrıca görsel yetenekli bir aracının computer aracını sunduğunu, screen.snapshot işleminin Ekran Kaydı izniyle başarılı olduğunu ve /phone status öğesinin amaçladığınız geçici veya kalıcı Gateway yetkilendirmesini gösterdiğini doğrulayın. Bir gateway.nodes.commands.deny girdisi her zaman gateway.nodes.commands.allow ayarını geçersiz kılar.
