# openclaw nodes

페어링된 Node(디바이스)를 관리하고 Node 기능을 호출합니다.

관련 항목:

• Node 개요: Node
• 카메라: 카메라 Node
• 이미지: 이미지 Node

공통 옵션:

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

# 공통 명령

openclaw nodes list
openclaw nodes list --connected
openclaw nodes list --last-connected 24h
openclaw nodes pending
openclaw 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 status
openclaw nodes status --connected
openclaw nodes status --last-connected 24h

nodes list는 보류 중/페어링된 항목 테이블을 출력합니다. 페어링된 행에는 가장 최근 연결 경과 시간(Last Connect)이 포함됩니다. 현재 연결된 Node만 표시하려면 --connected를 사용하세요. 특정 기간(예: 24h, 7d) 내에 연결된 Node로 필터링하려면 --last-connected <duration>를 사용하세요. 오래된 Gateway 소유 Node 페어링 레코드를 삭제하려면 nodes remove --node <id|name|ip>를 사용하세요.

승인 참고 사항:

• openclaw nodes pending에는 페어링 범위만 필요합니다.
• gateway.nodes.pairing.autoApproveCidrs는 명시적으로 신뢰된 최초 role: node 디바이스 페어링에 대해서만 보류 단계를 건너뛸 수 있습니다. 기본적으로 꺼져 있으며 업그레이드는 승인하지 않습니다.
• openclaw nodes approve <requestId>는 보류 중인 요청에서 추가 범위 요구 사항을 상속합니다:
  • 명령 없는 요청: 페어링만
  • exec가 아닌 Node 명령: 페어링 + 쓰기
  • system.run / system.run.prepare / system.which: 페어링 + 관리자

# 호출

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

호출 플래그:

• --params <json>: JSON 객체 문자열(기본값 {}).
• --invoke-timeout <ms>: Node 호출 제한 시간(기본값 15000).
• --idempotency-key <key>: 선택적 멱등성 키.
• system.run 및 system.run.prepare는 여기에서 차단됩니다. 셸 실행에는 host=node와 함께 exec 도구를 사용하세요.

Node에서 셸을 실행하려면 openclaw nodes run 대신 host=node와 함께 exec 도구를 사용하세요. 이제 nodes CLI는 기능 중심입니다: nodes invoke를 통한 직접 RPC와 페어링, 카메라, 화면, 위치, 캔버스, 알림을 제공합니다.

# 관련 항목

• CLI 참조
• Node