Langsung ke konten utama
Gunakan halaman ini saat sebuah Node terlihat di status tetapi alat 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 dipasangkan untuk peran node.
  • nodes describe mencakup kapabilitas yang Anda panggil.
  • Persetujuan exec menampilkan mode/daftar izin yang diharapkan.

​
Persyaratan latar depan

canvas.*, camera.*, dan screen.* hanya dapat berjalan di latar depan 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 aplikasi Node ke latar depan dan coba lagi.

​
Matriks izin

KapabilitasiOSAndroidaplikasi Node macOSKode kegagalan umum
camera.snap, camera.clipKamera (+ mikrofon untuk audio klip)Kamera (+ mikrofon untuk audio klip)Kamera (+ mikrofon untuk audio klip)*_PERMISSION_REQUIRED
screen.recordPerekaman Layar (+ mikrofon opsional)Prompt tangkapan layar (+ mikrofon opsional)Perekaman Layar*_PERMISSION_REQUIRED
location.getSaat Menggunakan atau Selalu (bergantung mode)Lokasi latar depan/latar belakang berdasarkan modeIzin lokasiLOCATION_PERMISSION_REQUIRED
system.runn/a (jalur host Node)n/a (jalur host Node)Persetujuan exec diperlukanSYSTEM_RUN_DENIED

​
Pemasangan versus persetujuan

Ini adalah gerbang yang berbeda:
  1. Pemasangan perangkat: bisakah Node ini terhubung ke Gateway?
  2. Kebijakan perintah Node Gateway: apakah ID perintah RPC diizinkan oleh gateway.nodes.allowCommands / denyCommands dan default platform?
  3. Persetujuan exec: bisakah Node ini 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 pemasangan belum ada, setujui perangkat Node terlebih dahulu. Jika nodes describe tidak memuat sebuah perintah, periksa kebijakan perintah Node Gateway dan apakah Node benar-benar mendeklarasikan perintah itu saat terhubung. Jika pemasangan baik-baik saja tetapi system.run gagal, perbaiki persetujuan exec/daftar izin pada Node tersebut. Pemasangan Node adalah gerbang identitas/kepercayaan, bukan permukaan persetujuan per perintah. Untuk system.run, kebijakan per-Node berada di file persetujuan exec Node tersebut (openclaw approvals get --node ...), bukan di catatan pemasangan Gateway. Untuk eksekusi host=node yang didukung persetujuan, Gateway juga mengikat eksekusi ke systemRunPlan kanonis yang telah disiapkan. Jika pemanggil berikutnya mengubah command/cwd atau metadata sesi sebelum eksekusi yang disetujui diteruskan, Gateway menolak eksekusi sebagai ketidakcocokan persetujuan alih-alih memercayai payload yang diedit.

​
Kode kesalahan Node umum

  • NODE_BACKGROUND_UNAVAILABLE → aplikasi berada di latar belakang; bawa ke latar depan.
  • 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 → aplikasi berada di latar belakang tetapi hanya izin Saat Menggunakan yang tersedia.
  • SYSTEM_RUN_DENIED: approval required → permintaan exec membutuhkan persetujuan eksplisit.
  • SYSTEM_RUN_DENIED: allowlist miss → perintah diblokir oleh mode daftar izin. Pada host Node Windows, bentuk pembungkus shell seperti cmd.exe /c ... diperlakukan sebagai ketidakcocokan daftar izin dalam mode daftar izin kecuali disetujui melalui alur tanya.

​
Loop pemulihan cepat

openclaw nodes status
openclaw nodes describe --node <idOrNameOrIp>
openclaw approvals get --node <idOrNameOrIp>
openclaw logs --follow
Jika masih macet:
  • Setujui ulang pemasangan perangkat.
  • Buka ulang aplikasi Node (latar depan).
  • Berikan ulang izin OS.
  • Buat ulang/sesuaikan kebijakan persetujuan exec.

​
Terkait