openclaw nodes

Kelola node (perangkat) yang dipasangkan dan panggil kapabilitas node.

Terkait:

• Ikhtisar node: Node
• Kamera: Node kamera
• Gambar: Node gambar

Opsi umum:

• --url, --token, --timeout, --json

Perintah umum

openclaw nodes listopenclaw nodes list --connectedopenclaw nodes list --last-connected 24hopenclaw nodes pendingopenclaw nodes approve <requestId>openclaw nodes reject <requestId>openclaw nodes remove --node <id|name|ip>openclaw nodes rename --node <id|name|ip> --name <displayName>openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24h

nodes list mencetak tabel tertunda/dipasangkan. Baris yang dipasangkan menyertakan usia koneksi terbaru (Koneksi Terakhir). Gunakan --connected untuk hanya menampilkan node yang saat ini terhubung. Gunakan --last-connected <duration> untuk memfilter ke node yang terhubung dalam suatu durasi (mis. 24h, 7d). Gunakan nodes remove --node <id|name|ip> untuk menghapus pemasangan node. Untuk node yang didukung perangkat, ini mencabut peran node milik perangkat di devices/paired.json dan memutus sesi peran-node miliknya (perangkat dengan peran campuran mempertahankan barisnya dan hanya kehilangan peran node; perangkat khusus node dihapus); ini juga membersihkan setiap catatan pemasangan node lama milik Gateway yang cocok. operator.pairing dapat menghapus baris node non-operator; pemanggil token-perangkat yang mencabut peran node miliknya sendiri pada perangkat dengan peran campuran juga memerlukan operator.admin.

Catatan persetujuan:

• openclaw nodes pending hanya memerlukan cakupan pemasangan.
• gateway.nodes.pairing.autoApproveCidrs dapat melewati langkah tertunda hanya untuk pemasangan perangkat role: node pertama kali yang dipercaya secara eksplisit. Ini nonaktif secara default dan tidak menyetujui peningkatan.
• openclaw nodes approve <requestId> mewarisi persyaratan cakupan tambahan dari permintaan tertunda:
  • permintaan tanpa perintah: hanya pemasangan
  • perintah node non-eksekusi: pemasangan + tulis
  • system.run / system.run.prepare / system.which: pemasangan + admin

Panggil

openclaw nodes invoke --node <id|name|ip> --command <command> --params <json>

Flag pemanggilan:

• --params <json>: string objek JSON (default {}).
• --invoke-timeout <ms>: timeout pemanggilan node (default 15000).
• --idempotency-key <key>: kunci idempotensi opsional.
• system.run dan system.run.prepare diblokir di sini; gunakan alat exec dengan host=node untuk eksekusi shell.

Untuk eksekusi shell pada node, gunakan alat exec dengan host=node, bukan openclaw nodes run. CLI nodes kini berfokus pada kapabilitas: RPC langsung melalui nodes invoke, plus pemasangan, kamera, layar, lokasi, Canvas, dan notifikasi. Perintah Canvas diimplementasikan oleh Plugin Canvas eksperimental bawaan; core mempertahankan hook kompatibilitas agar perintah tersebut tetap berada di bawah openclaw nodes canvas.

Terkait

• Referensi CLI
• Node