OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

CLI commands

Node들

openclaw nodes

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

관련 문서: Node 개요 - 활성 컴퓨터 상태 - 카메라 Node - 이미지 Node

모든 하위 명령의 공통 옵션: --url <url>, --token <token>, --timeout <ms>(기본값 10000), --json.

상태

bash
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와 페어링된 Node를 별도의 표로 표시하며, 페어링된 행에는 가장 최근 연결 후 경과 시간(Last Connect)이 포함됩니다. status는 Node별 기능, 버전, 마지막 입력 세부 정보가 포함된 하나의 통합 표를 표시합니다. 연결된 macOS Node는 손쉬운 사용 권한이 허용된 동안에만 마지막 입력을 보고하며, 가장 최신인 행은 active로 표시됩니다. 활성 컴퓨터 상태를 참조하십시오. describe는 한 Node의 기능, 권한, 활동 및 유효하거나 대기 중인 호출 명령을 출력합니다.

페어링

bash
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>

이 명령들은 Gateway가 소유하는 node.pair.* 저장소를 제어합니다. 이 저장소는 Node의 WS connect 핸드셰이크를 통제하는 기기 페어링(openclaw devices approve)과 별개입니다. 두 페어링의 관계는 Node를 참조하십시오.

  • remove는 Node의 페어링된 역할 항목을 취소합니다. 기기 기반 Node의 경우 기기 페어링 저장소에서 node 역할을 취소하고 Node 역할 세션의 연결을 끊습니다. 복합 역할 기기는 행을 유지하고 node 역할만 잃으며, Node 전용 기기 행은 삭제됩니다. 또한 일치하는 기존 Gateway 소유 Node 페어링 레코드도 모두 삭제합니다.
  • pending에는 operator.pairing 범위만 필요합니다.
  • gateway.nodes.pairing.autoApproveCidrs를 사용하면 명시적으로 신뢰하는 최초의 role: node 기기 페어링에 대해 대기 단계를 건너뛸 수 있습니다. 기본적으로 꺼져 있으며 역할 승격은 승인하지 않습니다.
  • gateway.nodes.pairing.sshVerify(기본적으로 켜짐)는 Gateway가 SSH를 통해 Node 호스트에서 기기 키를 검증할 수 있는 경우 최초의 role: node 기기 페어링을 자동으로 승인합니다. 첫 번째 기능 표면도 같은 단계에서 승인됩니다. Node 페어링을 참조하십시오.
  • approve 범위 요구 사항은 대기 중인 요청에서 선언한 명령을 따릅니다.
    • 명령이 없는 요청: operator.pairing
    • 실행 외 Node 명령: operator.pairing + operator.write
    • system.run / system.run.prepare / system.which: operator.pairing + operator.admin
  • remove 범위: operator.pairing으로 운영자가 아닌 Node 행을 제거할 수 있습니다. 기기 토큰 호출자가 복합 역할 기기에서 자신의 Node 역할을 취소하려면 추가로 operator.admin이 필요합니다.

호출

bash
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가 차단됩니다. 셸 실행에는 대신 host=node로 exec 도구를 사용하십시오. system.which는 invoke를 통해 사용할 수 있습니다.

알림, 푸시, 위치, 화면

bash
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는 system.notify를 선언한 Node에서 로컬 알림을 보냅니다. macOS, iOS, Android 및 직접 연결된 watchOS Node가 포함됩니다. watchOS로 직접 전달하려면 OpenClaw가 활성 상태여야 합니다. --title 또는 --body가 필요합니다. 옵션: --sound <name>, --priority <passive|active|timeSensitive>, --delivery <system|overlay|auto>(기본값 system), --invoke-timeout <ms>(기본값 15000).
  • push는 iOS Node에 APNs 테스트 푸시를 보냅니다. 옵션: --title <text>(기본값 OpenClaw), --body <text>, 감지된 APNs 환경을 재정의하는 --environment <sandbox|production>.
  • 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를 유지합니다.

관련 문서

Was this useful?
On this page

On this page