CLI commands
Node
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 24hnodes list는 대기 중/페어링된 항목의 표를 출력합니다. 페어링된 행에는 가장 최근 연결 경과 시간(Last Connect)이 포함됩니다.
현재 연결된 노드만 표시하려면 --connected를 사용하세요. 특정 기간 내에
연결된 노드로 필터링하려면 --last-connected <duration>을 사용하세요(예: 24h, 7d).
노드 페어링을 제거하려면 nodes remove --node <id|name|ip>를 사용하세요. 기기 기반 노드의 경우
이 명령은 devices/paired.json에서 해당 기기의 node 역할을 취소하고
노드 역할 세션의 연결을 끊습니다(혼합 역할 기기는 행을 유지하고
node 역할만 잃으며, 노드 전용 기기는 삭제됩니다). 또한 일치하는
레거시 Gateway 소유 노드 페어링 레코드도 지웁니다. operator.pairing은
비운영자 노드 행을 제거할 수 있습니다. 혼합 역할 기기에서 자신의 노드 역할을 취소하는
기기 토큰 호출자는 추가로 operator.admin이 필요합니다.
승인 참고:
openclaw nodes pending에는 페어링 범위만 필요합니다.gateway.nodes.pairing.autoApproveCidrs는 명시적으로 신뢰된 최초role: node기기 페어링에만 대기 단계를 건너뛸 수 있습니다. 기본적으로 꺼져 있으며 업그레이드는 승인하지 않습니다.openclaw nodes approve <requestId>는 대기 중인 요청에서 추가 범위 요구사항을 상속합니다.- 명령 없는 요청: 페어링만
- 비실행 노드 명령: 페어링 + 쓰기
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>: 선택적 멱등성 키.system.run및system.run.prepare는 여기에서 차단됩니다. 셸 실행에는host=node와 함께exec도구를 사용하세요.
노드에서 셸을 실행하려면 openclaw nodes run 대신 host=node와 함께 exec 도구를 사용하세요.
이제 nodes CLI는 기능 중심입니다. nodes invoke를 통한 직접 RPC와 페어링, 카메라,
화면, 위치, Canvas, 알림을 제공합니다. Canvas 명령은 번들로 제공되는 실험적 Canvas Plugin에서 구현됩니다. core는 호환성 훅을 유지하여 해당 명령이 계속 openclaw nodes canvas 아래에 남도록 합니다.
