OpenClaw 노드 관리 가이드: 연결 상태 확인 및 명령어 실행

openclaw nodes

여러 대의 디바이스나 원격 노드를 관리하다 보면 어떤 노드가 연결되어 있는지, 상태는 어떤지 파악하기가 정말 번거로울 때가 많죠. 일일이 상태를 확인하고 승인하는 과정에서 작업 흐름이 끊기기도 하고요. openclaw nodes를 사용하면 이런 페어링된 노드 관리와 기능 호출을 훨씬 깔끔하게 처리할 수 있습니다.

관련 문서:

• 노드 개요: Nodes
• 카메라: Camera nodes
• 이미지: Image nodes

공통 옵션:

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

nodes list를 실행하면 대기 중(pending)이거나 페어링된 노드 목록을 테이블 형태로 보여줍니다. 페어링된 항목에는 가장 최근에 연결된 시간(Last Connect)도 함께 표시돼요.

현재 연결된 노드만 보고 싶다면 --connected 옵션을 사용하세요. 특정 기간(예: 24h, 7d) 내에 연결된 노드만 필터링하려면 --last-connected <duration> 옵션을 활용하면 됩니다.

명령어 실행하기 (Invoke)

openclaw nodes invoke --node &lt;id|name|ip&gt; --command <command> --params <json>

invoke에서 사용하는 주요 플래그는 다음과 같습니다.

• --params <json>: JSON 객체 문자열을 전달합니다 (기본값 {}).
• --invoke-timeout <ms>: 노드 호출 타임아웃을 설정합니다 (기본값 15000).
• --idempotency-key <key>: 선택 사항으로 멱등성 키를 지정할 수 있습니다.
• system.run과 system.run.prepare는 여기서 차단되니 주의하세요. 셸 실행이 필요하다면 host=node 설정과 함께 exec 도구를 사용하는 것이 좋습니다.

이제 nodes CLI는 기능 중심(capability-focused)으로 동작합니다. nodes invoke를 통한 직접적인 RPC 호출은 물론, 페어링, Camera, Screen, Location, Canvas, Notification 기능을 바로 제어할 수 있어요.

다음 단계

• 노드 개요
• 카메라 노드
• 이미지 노드

AI Setup Assistant