Pemecahan masalah Node

Gunakan halaman ini saat sebuah Node terlihat di status tetapi alat Node gagal.

Urutan perintah

openclaw statusopenclaw gateway statusopenclaw logs --followopenclaw doctoropenclaw channels status --probe

Lalu jalankan pemeriksaan khusus Node:

openclaw nodes statusopenclaw 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

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 listopenclaw nodes statusopenclaw 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 statusopenclaw 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

• Ringkasan Node
• Node kamera
• Perintah lokasi
• Persetujuan exec
• Pemasangan Gateway
• Pemecahan masalah Gateway
• Pemecahan masalah channel