Langsung ke konten utama

​
Pemecahan masalah node

Gunakan halaman ini saat node terlihat di status tetapi tool node gagal.

​
Urutan perintah

openclaw status
openclaw gateway status
openclaw logs --follow
openclaw doctor
openclaw channels status --probe
Lalu jalankan pemeriksaan khusus node: 
openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
Sinyal sehat:
  • Node terhubung dan sudah dipasangkan untuk peran node.
  • nodes describe mencakup kapabilitas yang Anda panggil.
  • Exec approvals menunjukkan mode/allowlist yang diharapkan.

​
Persyaratan foreground

canvas.*, camera.*, dan screen.* hanya dapat digunakan di foreground pada node iOS/Android. Pemeriksaan dan perbaikan cepat: 
openclaw nodes describe --node <idOrNameOrIp>
openclaw nodes canvas snapshot --node <idOrNameOrIp>
openclaw logs --follow
Jika Anda melihat NODE_BACKGROUND_UNAVAILABLE, bawa app node ke foreground lalu coba lagi.

​
Matriks izin

KapabilitasiOSAndroidapp node macOSKode kegagalan yang umum
camera.snap, camera.clipCamera (+ mic untuk audio clip)Camera (+ mic untuk audio clip)Camera (+ mic untuk audio clip)*_PERMISSION_REQUIRED
screen.recordScreen Recording (+ mic opsional)Prompt screen capture (+ mic opsional)Screen Recording*_PERMISSION_REQUIRED
location.getWhile Using atau Always (tergantung mode)Lokasi Foreground/Background berdasarkan modeIzin LocationLOCATION_PERMISSION_REQUIRED
system.runn/a (jalur host node)n/a (jalur host node)Exec approvals diperlukanSYSTEM_RUN_DENIED

​
Pairing versus approvals

Ini adalah gerbang yang berbeda:
  1. Device pairing: apakah node ini dapat terhubung ke gateway?
  2. Kebijakan perintah node Gateway: apakah ID perintah RPC diizinkan oleh gateway.nodes.allowCommands / denyCommands dan default platform?
  3. Exec approvals: apakah node ini dapat menjalankan perintah shell tertentu secara lokal?
Pemeriksaan cepat: 
openclaw devices list
openclaw nodes status
openclaw approvals get --node <idOrNameOrIp>
openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
Jika pairing belum ada, setujui device node terlebih dahulu. Jika nodes describe tidak memiliki suatu perintah, periksa kebijakan perintah node gateway dan apakah node benar-benar mendeklarasikan perintah tersebut saat terhubung. Jika pairing baik-baik saja tetapi system.run gagal, perbaiki exec approvals/allowlist pada node tersebut. Pairing node adalah gerbang identitas/kepercayaan, bukan permukaan persetujuan per perintah. Untuk system.run, kebijakan per node berada di file exec approvals milik node tersebut (openclaw approvals get --node ...), bukan di catatan pairing gateway. Untuk eksekusi host=node yang didukung persetujuan, gateway juga mengikat eksekusi ke systemRunPlan kanonis yang telah disiapkan. Jika pemanggil berikutnya mengubah perintah/cwd atau metadata sesi sebelum eksekusi yang telah disetujui diteruskan, gateway menolak eksekusi tersebut sebagai ketidakcocokan persetujuan alih-alih mempercayai payload yang telah diedit.

​
Kode error node yang umum

  • NODE_BACKGROUND_UNAVAILABLE → app berada di background; bawa ke foreground.
  • CAMERA_DISABLED → toggle kamera dinonaktifkan di pengaturan node.
  • *_PERMISSION_REQUIRED → izin OS hilang/ditolak.
  • LOCATION_DISABLED → mode lokasi mati.
  • LOCATION_PERMISSION_REQUIRED → mode lokasi yang diminta belum diberikan.
  • LOCATION_BACKGROUND_UNAVAILABLE → app berada di background tetapi hanya memiliki izin While Using.
  • SYSTEM_RUN_DENIED: approval required → permintaan exec memerlukan persetujuan eksplisit.
  • SYSTEM_RUN_DENIED: allowlist miss → perintah diblokir oleh mode allowlist. Pada host node Windows, bentuk shell-wrapper seperti cmd.exe /c ... diperlakukan sebagai kegagalan allowlist dalam mode allowlist kecuali disetujui melalui alur ask.

​
Siklus pemulihan cepat

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
Jika masih buntu:
  • Setujui ulang device pairing.
  • Buka kembali app node (foreground).
  • Berikan ulang izin OS.
  • Buat ulang/sesuaikan kebijakan exec approval.
Terkait: