OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Nodes and media

Pemecahan masalah Node

Gunakan halaman ini ketika sebuah Node terlihat dalam status, tetapi alat Node gagal.

Urutan perintah

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

Kemudian jalankan pemeriksaan khusus Node:

bash
openclaw nodes statusopenclaw nodes describe --node <idOrNameOrIp>openclaw approvals get --node <idOrNameOrIp>

Indikator kondisi sehat:

  • Node terhubung dan dipasangkan untuk peran node.
  • nodes describe mencantumkan kapabilitas yang Anda panggil.
  • Persetujuan eksekusi menampilkan mode/daftar izin yang diharapkan.

Persyaratan latar depan

canvas.*, camera.*, dan screen.* hanya dapat digunakan di latar depan pada Node iOS/Android.

Pemeriksaan dan perbaikan cepat:

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

Jika Anda melihat NODE_BACKGROUND_UNAVAILABLE, tampilkan aplikasi Node di latar depan dan coba lagi.

Matriks izin

Kapabilitas iOS Android Aplikasi Node macOS Kode kegagalan umum
camera.snap, camera.clip Kamera (+ mikrofon untuk audio klip) Kamera (+ mikrofon untuk audio klip) Kamera (+ mikrofon untuk audio klip) *_PERMISSION_REQUIRED
screen.record Perekaman Layar (+ mikrofon opsional) Permintaan perekaman layar (+ mikrofon opsional) Perekaman Layar *_PERMISSION_REQUIRED
computer.act tidak tersedia tidak tersedia Aksesibilitas + Perekaman Layar COMPUTER_DISABLED, ACCESSIBILITY_REQUIRED
location.get Saat Digunakan atau Selalu (bergantung mode) Lokasi latar depan/latar belakang berdasarkan mode Izin lokasi LOCATION_PERMISSION_REQUIRED
system.run tidak tersedia (jalur host Node) tidak tersedia (jalur host Node) Persetujuan eksekusi diperlukan SYSTEM_RUN_DENIED

Pemasangan versus persetujuan

Tiga gerbang terpisah menentukan keberhasilan perintah Node:

  1. Pemasangan perangkat: dapatkah Node ini terhubung ke Gateway?
  2. Kebijakan perintah Node Gateway: apakah ID perintah RPC diizinkan oleh gateway.nodes.allowCommands / denyCommands dan pengaturan bawaan platform?
  3. Persetujuan eksekusi: dapatkah Node ini menjalankan perintah shell tertentu secara lokal?

Pemasangan Node adalah gerbang identitas/kepercayaan, bukan sarana persetujuan per perintah. Untuk system.run, kebijakan per Node berada dalam berkas persetujuan eksekusi Node tersebut (openclaw approvals get --node ...), bukan dalam catatan pemasangan Gateway.

Pemeriksaan cepat:

bash
openclaw devices listopenclaw nodes statusopenclaw approvals get --node <idOrNameOrIp>openclaw approvals allowlist add --node <idOrNameOrIp> "/usr/bin/uname"
  • Pemasangan tidak ada: setujui perangkat Node terlebih dahulu.
  • nodes describe tidak mencantumkan perintah: periksa kebijakan perintah Node Gateway dan apakah Node benar-benar mendeklarasikan perintah tersebut saat terhubung.
  • Pemasangan tidak bermasalah, tetapi system.run gagal: perbaiki persetujuan eksekusi/daftar izin pada Node tersebut.

Untuk eksekusi host=node yang memerlukan persetujuan, Gateway juga mengikat eksekusi ke systemRunPlan kanonis yang telah disiapkan. Jika pemanggil berikutnya mengubah perintah, direktori kerja, atau metadata sesi sebelum eksekusi yang disetujui diteruskan, Gateway akan menolak eksekusi karena ketidakcocokan persetujuan, alih-alih memercayai muatan yang telah diedit.

Kode kesalahan Node yang umum

Kode Arti
NODE_BACKGROUND_UNAVAILABLE Aplikasi berada di latar belakang; tampilkan di latar depan.
CAMERA_DISABLED Tombol kamera dinonaktifkan dalam pengaturan Node.
*_PERMISSION_REQUIRED Izin sistem operasi tidak ada/ditolak.
LOCATION_DISABLED Mode lokasi dinonaktifkan.
LOCATION_PERMISSION_REQUIRED Mode lokasi yang diminta belum diberikan.
LOCATION_BACKGROUND_UNAVAILABLE Aplikasi berada di latar belakang, tetapi hanya memiliki izin Saat Digunakan.
COMPUTER_DISABLED Aktifkan Allow Computer Control di aplikasi macOS, lalu setujui pembaruan pemasangan.
ACCESSIBILITY_REQUIRED Berikan izin Accessibility kepada bundel aplikasi OpenClaw saat ini di macOS System Settings.
SYSTEM_RUN_DENIED: approval required Permintaan eksekusi memerlukan persetujuan eksplisit.
SYSTEM_RUN_DENIED: allowlist miss Perintah diblokir oleh mode daftar izin. Pada host Node Windows, bentuk pembungkus shell seperti cmd.exe /c ... dianggap tidak cocok dengan daftar izin dalam mode daftar izin, kecuali disetujui melalui alur permintaan.

Siklus pemulihan cepat

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

Jika masih mengalami kendala:

  • Setujui ulang pemasangan perangkat.
  • Buka kembali aplikasi Node (di latar depan).
  • Berikan ulang izin sistem operasi.
  • Buat ulang/sesuaikan kebijakan persetujuan eksekusi.

Untuk kontrol komputer, pastikan juga bahwa agen berkemampuan visi menyediakan alat computer, screen.snapshot berhasil dengan izin Perekaman Layar, dan /phone status menampilkan otorisasi Gateway sementara atau permanen yang Anda inginkan. Entri gateway.nodes.denyCommands selalu mengesampingkan allowCommands.

Terkait

Was this useful?
On this page

On this page