openclaw nodes

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

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

• ภาพรวมโหนด: โหนด
• กล้อง: โหนดกล้อง
• รูปภาพ: โหนดรูปภาพ

ตัวเลือกทั่วไป:

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

คำสั่งทั่วไป

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 พิมพ์ตารางที่รอดำเนินการ/จับคู่แล้ว แถวที่จับคู่แล้วจะรวมอายุการเชื่อมต่อล่าสุด (เชื่อมต่อล่าสุด) ใช้ --connected เพื่อแสดงเฉพาะโหนดที่เชื่อมต่ออยู่ในปัจจุบัน ใช้ --last-connected <duration> เพื่อ กรองเฉพาะโหนดที่เชื่อมต่อภายในช่วงเวลาหนึ่ง (เช่น 24h, 7d) ใช้ nodes remove --node <id|name|ip> เพื่อลบการจับคู่โหนด สำหรับโหนดที่มี อุปกรณ์รองรับอยู่ การดำเนินการนี้จะเพิกถอนบทบาท node ของอุปกรณ์ใน devices/paired.json และตัดการเชื่อมต่อเซสชันบทบาทโหนดของอุปกรณ์นั้น (อุปกรณ์ที่มีหลายบทบาทจะยังคงแถวของตัวเองและ เสียเฉพาะบทบาท node; อุปกรณ์ที่เป็นโหนดเท่านั้นจะถูกลบ); และยังล้าง ระเบียนการจับคู่โหนดแบบเดิมที่ Gateway เป็นเจ้าของซึ่งตรงกันด้วย operator.pairing สามารถลบ แถวโหนดที่ไม่ใช่โอเปอเรเตอร์ได้; ผู้เรียกที่ใช้โทเคนอุปกรณ์ซึ่งเพิกถอนบทบาทโหนดของตนเองบน อุปกรณ์ที่มีหลายบทบาทจะต้องมี operator.admin เพิ่มเติม

หมายเหตุการอนุมัติ:

• openclaw nodes pending ต้องการเฉพาะขอบเขตการจับคู่
• gateway.nodes.pairing.autoApproveCidrs สามารถข้ามขั้นตอนรอดำเนินการได้เฉพาะสำหรับ การจับคู่อุปกรณ์ role: node ครั้งแรกที่เชื่อถืออย่างชัดเจนเท่านั้น ค่านี้ปิดไว้เป็น ค่าเริ่มต้นและไม่อนุมัติการอัปเกรด
• openclaw nodes approve <requestId> รับข้อกำหนดขอบเขตเพิ่มเติมจาก คำขอที่รอดำเนินการ:
  • คำขอที่ไม่มีคำสั่ง: การจับคู่เท่านั้น
  • คำสั่งโหนดที่ไม่ใช่ exec: การจับคู่ + เขียน
  • system.run / system.run.prepare / system.which: การจับคู่ + ผู้ดูแลระบบ

เรียกใช้

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

แฟล็กการเรียกใช้:

• --params <json>: สตริงอ็อบเจกต์ JSON (ค่าเริ่มต้น {})
• --invoke-timeout <ms>: ระยะหมดเวลาการเรียกใช้โหนด (ค่าเริ่มต้น 15000)
• --idempotency-key <key>: คีย์ idempotency ที่ไม่บังคับ
• system.run และ system.run.prepare ถูกบล็อกที่นี่; ใช้เครื่องมือ exec พร้อม host=node สำหรับการประมวลผลเชลล์

สำหรับการประมวลผลเชลล์บนโหนด ให้ใช้เครื่องมือ exec พร้อม host=node แทน openclaw nodes run ตอนนี้ CLI nodes มุ่งเน้นความสามารถ: RPC โดยตรงผ่าน nodes invoke รวมถึงการจับคู่ กล้อง หน้าจอ ตำแหน่งที่ตั้ง Canvas และการแจ้งเตือน คำสั่ง Canvas ถูกใช้งานโดย Plugin Canvas รุ่นทดลองที่รวมมาในชุด; core คงฮุกความเข้ากันได้ไว้เพื่อให้คำสั่งเหล่านี้ยังอยู่ภายใต้ openclaw nodes canvas

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

• เอกสารอ้างอิง CLI
• โหนด