​

nodes/troubleshooting.md

​

Komut merdiveni

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe

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

• Düğüm bağlıdır ve node rolü için eşleştirilmiştir.
• nodes describe, çağırdığınız yeteneği içerir.
• Exec onayları beklenen mod/izin listesiyle görünür.

​

Ön planda olma gereksinimleri

openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow

​

İzinler matrisi

​

Pairing versus approvals

1. Cihaz eşleştirme: Bu düğüm gateway’e bağlanabilir mi?
2. Exec onayları: Bu düğüm belirli bir kabuk komutunu çalıştırabilir mi?

openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"

​

Yaygın düğüm hata kodları

• NODE_BACKGROUND_UNAVAILABLE → uygulama arka planda; ön plana getirin.
• CAMERA_DISABLED → düğüm ayarlarında kamera anahtarı devre dışı.
• *_PERMISSION_REQUIRED → OS 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ım Sırasında izni mevcut.
• SYSTEM_RUN_DENIED: approval required → exec isteği açık onay gerektiriyor.
• SYSTEM_RUN_DENIED: allowlist miss → komut izin listesi modu tarafından engellendi.

​

Hızlı toparlanma döngüsü

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

• Cihaz eşleştirmeyi yeniden onaylayın.
• Düğüm uygulamasını yeniden açın (ön plan).
• OS izinlerini yeniden verin.
• Exec onay politikasını yeniden oluşturun/ayarlayın.

• /nodes/index
• /nodes/camera
• /nodes/location-command
• /tools/exec-approvals
• /gateway/pairing