openclaw nodes

Kelola node (perangkat) yang dipasangkan dan jalankan kemampuan node.

Terkait: Ikhtisar node - Kehadiran komputer aktif - Node kamera - Node gambar

Opsi umum pada setiap subperintah: --url <url>, --token <token>, --timeout <ms> (default 10000), --json.

Status

openclaw nodes statusopenclaw nodes status --connectedopenclaw nodes status --last-connected 24hopenclaw nodes listopenclaw nodes describe --node <idOrNameOrIp>

status dan list menerima --connected (hanya node yang terhubung) dan --last-connected <duration> (misalnya 24h, 7d; hanya node yang terhubung dalam durasi tersebut). list menampilkan node yang menunggu dan yang telah dipasangkan dalam tabel terpisah, dengan baris yang dipasangkan menyertakan usia koneksi terbaru (Last Connect); status menampilkan satu tabel gabungan dengan detail kemampuan, versi, dan input terakhir per node. Node macOS yang terhubung hanya melaporkan input terakhir setelah pengguna mengaktifkan Deteksi komputer aktif dan memberikan izin Aksesibilitas; baris terbaru ditandai active. Lihat Kehadiran komputer aktif. describe mencetak kemampuan, izin, aktivitas, serta perintah pemanggilan efektif/tertunda dari satu node.

Pemasangan

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

Perintah ini mengendalikan penyimpanan node.pair.* milik Gateway, yang terpisah dari pemasangan perangkat (openclaw devices approve) yang membatasi handshake connect WS milik node. Lihat Node untuk mengetahui hubungan keduanya.

• remove mencabut entri peran terpasang milik node. Untuk node berbasis perangkat, tindakan ini mencabut peran node dalam penyimpanan pemasangan perangkat dan memutus sesi peran node-nya: perangkat dengan peran campuran mempertahankan barisnya dan hanya kehilangan peran node, sedangkan baris perangkat khusus node dihapus. Tindakan ini juga menghapus setiap catatan pemasangan node lama milik Gateway yang cocok.
• pending hanya memerlukan cakupan operator.pairing.
• gateway.nodes.pairing.autoApproveCidrs dapat melewati langkah tertunda untuk pemasangan perangkat role: node pertama kali yang secara eksplisit dipercaya. Nonaktif secara default; tidak menyetujui peningkatan peran.
• gateway.nodes.pairing.sshVerify (aktif secara default) secara otomatis menyetujui pemasangan perangkat role: node pertama kali ketika Gateway dapat memverifikasi kunci perangkat melalui SSH ke host node; permukaan kemampuan pertama disetujui dalam langkah yang sama. Lihat Pemasangan node.
• Persyaratan cakupan approve mengikuti perintah yang dideklarasikan oleh permintaan tertunda:
  • permintaan tanpa perintah: operator.pairing
  • perintah node biasa: operator.pairing + operator.write
  • perintah sensitif bagi admin (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir, dan system.execApprovals.get/set): operator.pairing + operator.admin
• Cakupan remove: operator.pairing dapat menghapus baris node nonoperator; pemanggil dengan token perangkat yang mencabut peran node-nya sendiri pada perangkat berperan campuran juga memerlukan operator.admin.

Pemanggilan

openclaw nodes invoke --node <id> --command system.which --params '{"bins":["uname"]}'

Flag:

• --command <command> (wajib): misalnya canvas.eval.
• --params <json>: string objek JSON (default {}).
• --invoke-timeout <ms>: batas waktu pemanggilan node (default 15000).
• --idempotency-key <key>: kunci idempotensi opsional.

system.run dan system.run.prepare diblokir di sini; sebagai gantinya, gunakan alat exec dengan host=node untuk menjalankan shell. system.which diizinkan melalui invoke.

Notifikasi, push, lokasi, layar

openclaw nodes notify --node <id> --title "Build" --body "Done" --priority timeSensitiveopenclaw nodes push --node <id> --title "OpenClaw" --environment sandboxopenclaw nodes location get --node <id> --accuracy preciseopenclaw nodes screen record --node <id> --duration 10s --fps 10 --out ./clip.mp4

• notify mengirim notifikasi lokal pada node yang mendeklarasikan system.notify, termasuk node macOS, iOS, Android, dan watchOS langsung. Pengiriman langsung ke watchOS mengharuskan OpenClaw aktif. Memerlukan --title atau --body. Opsi: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (default system), --invoke-timeout <ms> (default 15000).
• push mengirim push pengujian APNs ke node iOS. Opsi: --title <text> (default OpenClaw), --body <text>, --environment <sandbox|production> untuk mengganti lingkungan APNs yang terdeteksi.
• location get mengambil lokasi node saat ini. Opsi: --max-age <ms> (gunakan kembali penetapan lokasi yang disimpan dalam cache), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (default 10000), --invoke-timeout <ms> (default 20000).
• screen record merekam klip singkat dan mencetak jalur penyimpanannya (atau menulis JSON dengan --json). Opsi: --screen <index> (default 0), --duration <ms|10s> (default 10000), --fps <fps> (default 10), --no-audio, --out <path>, --invoke-timeout <ms> (default 120000).

Perintah Kamera dan Canvas memiliki dokumentasinya sendiri: Node kamera, Canvas. Canvas diimplementasikan oleh plugin Canvas eksperimental yang dibundel; inti mempertahankan openclaw nodes canvas sebagai titik pemasangan kompatibilitas.

Terkait

• Referensi CLI
• Node