openclaw nodes

จัดการ Node ที่จับคู่แล้ว (อุปกรณ์) และเรียกใช้ความสามารถของ Node

ที่เกี่ยวข้อง: ภาพรวม Node - การตรวจพบคอมพิวเตอร์ที่กำลังใช้งาน - Node กล้อง - Node รูปภาพ

ตัวเลือกทั่วไปสำหรับทุกคำสั่งย่อย: --url <url>, --token <token>, --timeout <ms> (ค่าเริ่มต้น 10000), --json

สถานะ

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

ทั้ง status และ list รองรับ --connected (เฉพาะ Node ที่เชื่อมต่ออยู่) และ --last-connected <duration> (เช่น 24h, 7d; เฉพาะ Node ที่เชื่อมต่อภายในระยะเวลาที่กำหนด) list แสดง Node ที่รออนุมัติและจับคู่แล้วในตารางแยกกัน โดยแถวที่จับคู่แล้วจะแสดงระยะเวลานับจากการเชื่อมต่อล่าสุด (Last Connect) ส่วน status แสดงตารางรวมหนึ่งตารางที่มีรายละเอียดความสามารถ เวอร์ชัน และอินพุตล่าสุดของแต่ละ Node Node macOS ที่เชื่อมต่อแล้วจะรายงานอินพุตล่าสุดก็ต่อเมื่อผู้ใช้เปิดใช้ การตรวจจับคอมพิวเตอร์ที่กำลังใช้งาน และให้สิทธิ์ Accessibility โดยแถวที่ใหม่ที่สุดจะทำเครื่องหมายด้วย active ดูการตรวจพบคอมพิวเตอร์ที่กำลังใช้งาน describe แสดงความสามารถ สิทธิ์ กิจกรรม และคำสั่งเรียกใช้ที่มีผล/รอดำเนินการของ Node หนึ่งรายการ

การจับคู่

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>

คำสั่งเหล่านี้ควบคุมที่จัดเก็บ node.pair.* ซึ่ง Gateway เป็นเจ้าของ โดยแยกจากการจับคู่อุปกรณ์ (openclaw devices approve) ที่ควบคุมแฮนด์เชค WS connect ของ Node ดูความสัมพันธ์ระหว่างทั้งสองได้ที่ Node

• remove เพิกถอนรายการบทบาทที่จับคู่ของ Node สำหรับ Node ที่มีอุปกรณ์รองรับ การดำเนินการนี้จะเพิกถอนบทบาท node ในที่จัดเก็บการจับคู่อุปกรณ์และตัดการเชื่อมต่อเซสชันบทบาท Node ของอุปกรณ์ โดยอุปกรณ์ที่มีหลายบทบาทจะยังคงแถวไว้และสูญเสียเฉพาะบทบาท node ส่วนแถวของอุปกรณ์ที่มีเฉพาะ Node จะถูกลบ นอกจากนี้ยังล้างระเบียนการจับคู่ Node แบบเดิมที่ Gateway เป็นเจ้าของซึ่งตรงกันด้วย
• pending ต้องการเพียงขอบเขต operator.pairing
• gateway.nodes.pairing.autoApproveCidrs สามารถข้ามขั้นตอนรอดำเนินการสำหรับการจับคู่อุปกรณ์ role: node ครั้งแรกที่ระบุอย่างชัดเจนว่าเชื่อถือได้ ปิดไว้โดยค่าเริ่มต้น และไม่อนุมัติการยกระดับบทบาท
• gateway.nodes.pairing.sshVerify (เปิดไว้โดยค่าเริ่มต้น) อนุมัติการจับคู่อุปกรณ์ role: node ครั้งแรกโดยอัตโนมัติ เมื่อ Gateway สามารถตรวจสอบคีย์อุปกรณ์ผ่าน SSH ไปยังโฮสต์ของ Node ได้ โดยพื้นผิวความสามารถแรกจะได้รับอนุมัติในขั้นตอนเดียวกัน ดูการจับคู่ Node
• ข้อกำหนดขอบเขตของ approve เป็นไปตามคำสั่งที่ประกาศไว้ในคำขอที่รอดำเนินการ:
  • คำขอที่ไม่มีคำสั่ง: operator.pairing
  • คำสั่ง Node ทั่วไป: operator.pairing + operator.write
  • คำสั่งที่เกี่ยวข้องกับผู้ดูแลระบบ (system.run, system.run.prepare, system.which, browser.proxy, fs.listDir และ system.execApprovals.get/set): operator.pairing + operator.admin
• ขอบเขตของ remove: operator.pairing สามารถลบแถว Node ที่ไม่ใช่ตัวดำเนินการได้ ผู้เรียกที่ใช้โทเค็นอุปกรณ์ซึ่งเพิกถอนบทบาท Node ของตนเองบนอุปกรณ์ที่มีหลายบทบาทต้องมี operator.admin เพิ่มเติม

การเรียกใช้

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

แฟล็ก:

• --command <command> (จำเป็น): เช่น canvas.eval
• --params <json>: สตริงออบเจ็กต์ JSON (ค่าเริ่มต้น {})
• --invoke-timeout <ms>: ระยะหมดเวลาการเรียกใช้ Node (ค่าเริ่มต้น 15000)
• --idempotency-key <key>: คีย์การทำงานซ้ำได้อย่างปลอดภัยซึ่งระบุหรือไม่ก็ได้

system.run และ system.run.prepare ถูกบล็อกที่นี่ ให้ใช้เครื่องมือ exec ร่วมกับ host=node สำหรับการเรียกใช้เชลล์แทน ส่วน system.which อนุญาตผ่าน invoke

การแจ้งเตือน พุช ตำแหน่ง และหน้าจอ

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 ส่งการแจ้งเตือนภายในเครื่องบน Node ที่ประกาศ system.notify ซึ่งรวมถึง Node macOS, iOS, Android และ watchOS โดยตรง การส่งไปยัง watchOS โดยตรงกำหนดให้ OpenClaw ต้องทำงานอยู่ ต้องมี --title หรือ --body ตัวเลือก: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto> (ค่าเริ่มต้น system), --invoke-timeout <ms> (ค่าเริ่มต้น 15000)
• push ส่งพุชทดสอบ APNs ไปยัง Node iOS ตัวเลือก: --title <text> (ค่าเริ่มต้น OpenClaw), --body <text>, --environment <sandbox|production> เพื่อแทนที่สภาพแวดล้อม APNs ที่ตรวจพบ
• location get ดึงตำแหน่งปัจจุบันของ Node ตัวเลือก: --max-age <ms> (ใช้ค่าตำแหน่งที่แคชไว้ซ้ำ), --accuracy <coarse|balanced|precise>, --location-timeout <ms> (ค่าเริ่มต้น 10000), --invoke-timeout <ms> (ค่าเริ่มต้น 20000)
• screen record บันทึกคลิปสั้นและแสดงพาธที่บันทึกไว้ (หรือเขียน JSON ด้วย --json) ตัวเลือก: --screen <index> (ค่าเริ่มต้น 0), --duration <ms|10s> (ค่าเริ่มต้น 10000), --fps <fps> (ค่าเริ่มต้น 10), --no-audio, --out <path>, --invoke-timeout <ms> (ค่าเริ่มต้น 120000)

คำสั่งกล้องและ Canvas มีเอกสารแยกต่างหาก: Node กล้อง, Canvas Canvas ทำงานผ่าน Canvas Plugin รุ่นทดลองที่รวมมาให้ ส่วนแกนหลักยังคง openclaw nodes canvas ไว้เป็นจุดเมานต์เพื่อความเข้ากันได้

ที่เกี่ยวข้อง

• ข้อมูลอ้างอิง CLI
• Node