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 status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

Ardından Node’a özgü kontrolleri çalıştırın:

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>

Sağlıklı çalışma belirtileri:

Node bağlıdır ve node rolü 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 --follow

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 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.deny ve 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 list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

Eşleştirme eksik: Önce Node cihazını onaylayın.
nodes describe iç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.run baş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 status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow

Sorun 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.

Gateway

Remote access

Security

Nodes and media

Web interfaces

Node sorun giderme

Komut sıralaması

Ön planda çalışma gereksinimleri

İzinler matrisi

Eşleştirme ve onaylar

Yaygın Node hata kodları

Hızlı kurtarma döngüsü

İlgili konular

​Komut sıralaması

​Ön planda çalışma gereksinimleri

​İzinler matrisi

​Eşleştirme ve onaylar

​Yaygın Node hata kodları

​Hızlı kurtarma döngüsü

​İlgili konular

Komut sıralaması

Ön planda çalışma gereksinimleri

İzinler matrisi

Eşleştirme ve onaylar

Yaygın Node hata kodları

Hızlı kurtarma döngüsü

İlgili konular