Skip to main content

CLI 참조

이 페이지는 현재 CLI 동작을 설명합니다. 명령어가 변경되면 이 문서를 업데이트하십시오.

명령어 페이지

글로벌 플래그

  • --dev: ~/.openclaw-dev 아래 상태를 격리하고 기본 포트를 변경합니다.
  • --profile <name>: ~/.openclaw-<name> 아래 상태를 격리합니다.
  • --no-color: ANSI 색상을 비활성화합니다.
  • --update: openclaw update의 축약형 (소스 설치 전용).
  • -V, --version, -v: 버전을 출력하고 종료합니다.

출력 스타일링

  • ANSI 색상과 진행률 표시기는 TTY 세션에서만 렌더링됩니다.
  • OSC-8 하이퍼링크는 지원되는 터미널에서 클릭 가능한 링크로 렌더링됩니다. 그렇지 않으면 일반 URL로 대체됩니다.
  • --json (및 지원되는 경우 --plain)은 깨끗한 출력을 위해 스타일링을 비활성화합니다.
  • --no-color는 ANSI 스타일링을 비활성화합니다. NO_COLOR=1도 존중됩니다.
  • 장기 실행 명령어는 진행률 표시기를 표시합니다 (지원되는 경우 OSC 9;4).

색상 팔레트

OpenClaw는 CLI 출력에 로브스터 팔레트를 사용합니다.
  • accent (#FF5A2D): 헤딩, 레이블, 주요 하이라이트.
  • accentBright (#FF7A3D): 명령어 이름, 강조.
  • accentDim (#D14A22): 보조 하이라이트 텍스트.
  • info (#FF8A5B): 정보값.
  • success (#2FBF71): 성공 상태.
  • warn (#FFB020): 경고, 대체, 주의.
  • error (#E23D2D): 오류, 실패.
  • muted (#8B7F77): 비강조, 메타데이터.
팔레트 진리의 출처: src/terminal/palette.ts (일명 “lobster seam”).

명령어 트리

참고: 플러그인은 최상위 수준의 명령어를 추가할 수 있습니다 (예: openclaw voicecall).

보안

  • openclaw security audit — 일반 보안 허점을 위한 구성 + 로컬 상태 감사.
  • openclaw security audit --deep — 최선의 노력으로 라이브 게이트웨이 탐색.
  • openclaw security audit --fix — 안전한 기본값을 강화하고 상태/구성의 권한을 수정합니다.

플러그인

확장과 설정 관리:
  • openclaw plugins list — 플러그인 검색 (--json을 사용하여 기계 출력).
  • openclaw plugins info <id> — 플러그인 세부정보 보기.
  • openclaw plugins install <path|.tgz|npm-spec> — 플러그인 설치 (또는 플러그인 경로를 plugins.load.paths에 추가).
  • openclaw plugins enable <id> / disable <id>plugins.entries.<id>.enabled 토글.
  • openclaw plugins doctor — 플러그인 로드 오류 보고.
대부분의 플러그인 변경사항은 게이트웨이 재시작이 필요합니다. /plugin을 참조하세요.

메모리

MEMORY.md + memory/*.md에 대한 벡터 검색:
  • openclaw memory status — 인덱스 통계 표시.
  • openclaw memory index — 메모리 파일 재인덱스.
  • openclaw memory search "<query>" (또는 --query "<query>") — 메모리에 대한 의미 검색.

채팅 슬래시 명령어

채팅 메시지는 /... 명령어 (텍스트 및 네이티브)를 지원합니다. /tools/slash-commands를 참조하세요. 하이라이트:
  • /status — 빠른 진단.
  • /config — 지속적 설정 변경.
  • /debug — 런타임 전용 설정 재정의 (메모리, 디스크 아님; commands.debug: true 필요).

설정 + 온보딩

setup

설정 + 작업 공간 초기화. 옵션:
  • --workspace <dir>: 에이전트 작업 공간 경로 (기본값 ~/.openclaw/workspace).
  • --wizard: 온보딩 마법사 실행.
  • --non-interactive: 프롬프트 없이 마법사 실행.
  • --mode <local|remote>: 마법사 모드.
  • --remote-url <url>: 원격 게이트웨이 URL.
  • --remote-token <token>: 원격 게이트웨이 토큰.
마법사 플래그가 존재하면 마법사가 자동으로 실행됩니다 (--non-interactive, --mode, --remote-url, --remote-token).

onboard

게이트웨이, 작업 공간, 스킬을 설정하는 대화형 마법사. 옵션:
  • --workspace <dir>
  • --reset (마법사 시작 전에 설정 + 자격 증명 + 세션 + 작업 공간 초기화)
  • --non-interactive
  • --mode <local|remote>
  • --flow <quickstart|advanced|manual> (manual은 advanced의 별칭)
  • --auth-choice <setup-token|token|chutes|openai-codex|openai-api-key|openrouter-api-key|ollama|ai-gateway-api-key|moonshot-api-key|moonshot-api-key-cn|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|mistral-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|opencode-go|custom-api-key|skip>
  • --token-provider <id> (비대화형; --auth-choice token 사용 시)
  • --token <token> (비대화형; --auth-choice token 사용 시)
  • --token-profile-id <id> (비대화형; 기본값: <provider>:manual)
  • --token-expires-in <duration> (비대화형; 예: 365d, 12h)
  • --anthropic-api-key <key>
  • --openai-api-key <key>
  • --openrouter-api-key <key>
  • --ai-gateway-api-key <key>
  • --moonshot-api-key <key>
  • --kimi-code-api-key <key>
  • --gemini-api-key <key>
  • --zai-api-key <key>
  • --minimax-api-key <key>
  • --opencode-zen-api-key <key>
  • --opencode-go-api-key <key>
  • --custom-base-url <url> (비대화형; --auth-choice custom-api-key 또는 --auth-choice ollama 사용 시)
  • --custom-model-id <id> (비대화형; --auth-choice custom-api-key 또는 --auth-choice ollama 사용 시)
  • --custom-api-key <key> (비대화형; 선택사항; --auth-choice custom-api-key 사용 시; 누락 시 CUSTOM_API_KEY로 대체됨)
  • --custom-provider-id <id> (비대화형; 선택사항, 사용자 정의 프로바이더 ID)
  • --custom-compatibility <openai|anthropic> (비대화형; 선택사항; 기본값 openai)
  • --gateway-port <port>
  • --gateway-bind <loopback|lan|tailnet|auto|custom>
  • --gateway-auth <token|password>
  • --gateway-token <token>
  • --gateway-token-ref-env <name> (비대화형; gateway.auth.token을 env SecretRef로 저장하며 해당 환경 변수가 설정돼 있어야 함; --gateway-token과 함께 사용할 수 없음)
  • --gateway-password <password>
  • --remote-url <url>
  • --remote-token <token>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --install-daemon
  • --no-install-daemon (별칭: --skip-daemon)
  • --daemon-runtime <node|bun>
  • --skip-channels
  • --skip-skills
  • --skip-health
  • --skip-ui
  • --node-manager <npm|pnpm|bun> (pnpm 추천; Gateway 런타임에 bun 비추천)
  • --json

configure

대화형 구성 마법사 (모델, 채널, 스킬, 게이트웨이).

config

비대화형 구성 도우미 (get/set/unset). openclaw config를 하위 명령어 없이 실행하면 마법사가 시작됩니다. 하위 명령어:
  • config get <path>: 구성값 출력 (점/대괄호 경로).
  • config set <path> <value>: 값 설정 (JSON5 또는 일반 문자열).
  • config unset <path>: 값 제거.

doctor

건강 진단 + 빠른 수정 (구성 + 게이트웨이 + 레거시 서비스). 옵션:
  • --no-workspace-suggestions: 작업 공간 메모리 힌트 비활성화.
  • --yes: 프롬프트 없이 기본값 적용 (무인 상태).
  • --non-interactive: 프롬프트 건너뜀; 안전한 마이그레이션만 적용.
  • --deep: 추가 게이트웨이 설치를 위한 시스템 서비스 스캔.

채널 도우미

channels

채팅 채널 계정 관리 (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (플러그인)/Signal/iMessage/MS Teams). 하위 명령어:
  • channels list: 구성된 채널 및 인증 프로필 표시.
  • channels status: 게이트웨이 도달 가능성과 채널 건강 확인 (--probe 추가 확인 실행; 게이트웨이 건강 검색에는 openclaw health 또는 openclaw status --deep 사용).
  • 팁: channels status는 일반적인 잘못된 구성을 감지할 수 있을 때 제안된 수정을 포함한 경고 메시지를 출력하며, 이는 openclaw doctor로 안내됩니다.
  • channels logs: 게이트웨이 로그 파일에서 최근 채널 로그 표시.
  • channels add: 플래그가 없는 경우 마법사 스타일로 설정; 플래그가 있는 경우 비대화형 모드로 전환.
  • channels remove: 기본적으로 비활성화; 플래그 --delete를 전달하여 프롬프트 없이 구성 항목 제거.
  • channels login: 대화형 채널 로그인 (WhatsApp Web 전용).
  • channels logout: 채널 세션에서 로그아웃 (지원되는 경우).
일반 옵션:
  • --channel <name>: whatsapp|telegram|discord|googlechat|slack|mattermost|signal|imessage|msteams
  • --account <id>: 채널 계정 ID (기본값 default)
  • --name <label>: 계정의 표시 이름
channels login 옵션:
  • --channel <channel> (기본값 whatsapp; whatsapp/web 지원)
  • --account <id>
  • --verbose
channels logout 옵션:
  • --channel <channel> (기본값 whatsapp)
  • --account <id>
channels list 옵션:
  • --no-usage: 모델 프로바이더 사용량/할당량 스냅샷 건너뛰기 (OAuth/API 지원 전용).
  • --json: JSON 출력 (사용량을 포함하여, --no-usage 설정 시 제외).
channels logs 옵션:
  • --channel <name|all> (기본값 all)
  • --lines <n> (기본값 200)
  • --json
자세한 내용: /concepts/oauth 예제:

skills

사용 가능한 스킬 나열 및 검토, 준비 정보 포함. 하위 명령어:
  • skills list: 스킬 목록 (하위 명령어 없을 때 기본).
  • skills info <name>: 하나의 스킬에 대한 세부정보 표시.
  • skills check: 준비된 요구사항과 없는 요구사항 요약.
옵션:
  • --eligible: 준비된 스킬만 보여주기.
  • --json: JSON 출력 (스타일 없음).
  • -v, --verbose: 부족한 요구사항 세부정보 포함.
팁: npx clawhub를 사용하여 스킬을 검색, 설치, 동기화하세요.

pairing

채널 간 DM 페어링 요청 승인. 하위 명령어:
  • pairing list [channel] [--channel <channel>] [--account <id>] [--json]
  • pairing approve <channel> <code> [--account <id>] [--notify]
  • pairing approve --channel <channel> [--account <id>] <code> [--notify]

devices

게이트웨이 디바이스 페어링 항목 및 역할별 디바이스 토큰 관리. 하위 명령어:
  • devices list [--json]
  • devices approve [requestId] [--latest]
  • devices reject <requestId>
  • devices remove <deviceId>
  • devices clear --yes [--pending]
  • devices rotate --device <id> --role <role> [--scope <scope...>]
  • devices revoke --device <id> --role <role>

webhooks gmail

Gmail Pub/Sub 훅 설정 + 실행기. /automation/gmail-pubsub를 참조하세요. 하위 명령어:
  • webhooks gmail setup (필수: --account <email>; --project, --topic, --subscription, --label, --hook-url, --hook-token, --push-token, --bind, --port, --path, --include-body, --max-bytes, --renew-minutes, --tailscale, --tailscale-path, --tailscale-target, --push-endpoint, --json 지원)
  • webhooks gmail run (동일한 플래그에 대한 런타임 재정의)

dns setup

광역 검색 DNS 도우미 (CoreDNS + Tailscale). /gateway/discovery를 참조하세요. 옵션:
  • --apply: CoreDNS 구성 설치/업데이트 (sudo 필요; macOS 전용).

메시징 + 에이전트

message

통합 아웃바운드 메시징 + 채널 작업. 참조: /cli/message 하위 명령어:
  • message send|poll|react|reactions|read|edit|delete|pin|unpin|pins|permissions|search|timeout|kick|ban
  • message thread <create|list|reply>
  • message emoji <list|upload>
  • message sticker <send|upload>
  • message role <info|add|remove>
  • message channel <info|list>
  • message member info
  • message voice status
  • message event <list|create>
예제:
  • openclaw message send --target +15555550123 --message "Hi"
  • openclaw message poll --channel discord --target channel:123 --poll-question "Snack?" --poll-option Pizza --poll-option Sushi

agent

게이트웨이를 통해 하나의 에이전트 턴 실행 (또는 --local 임베디드). 필수:
  • --message <text>
옵션:
  • --to <dest> (세션 키 및 선택적 배달을 위한)
  • --session-id <id>
  • --thinking <off|minimal|low|medium|high|xhigh> (GPT-5.2 + Codex 모델 전용)
  • --verbose <on|full|off>
  • --channel <whatsapp|telegram|discord|slack|mattermost|signal|imessage|msteams>
  • --local
  • --deliver
  • --json
  • --timeout <seconds>

agents

격리된 에이전트 관리 (작업 공간 + 인증 + 라우팅).

agents list

구성된 에이전트 목록. 옵션:
  • --json
  • --bindings

agents add [name]

새 격리 에이전트 추가. 플래그 (또는 --non-interactive)가 제공되지 않을 경우 안내 마법사 실행; 비대화형 모드에서는 --workspace 필수. 옵션:
  • --workspace <dir>
  • --model <id>
  • --agent-dir <dir>
  • --bind <channel[:accountId]> (반복 가능)
  • --non-interactive
  • --json
바인딩 명세는 channel[:accountId]를 사용합니다. WhatsApp의 경우 accountId가 생략되면 기본 계정 ID가 사용됩니다.

agents delete <id>

에이전트 삭제 및 해당 작업 공간 + 상태 정리. 옵션:
  • --force
  • --json

acp

IDE를 게이트웨이에 연결하는 ACP 브리지 실행. 전체 옵션과 예제는 acp를 참조하세요.

status

연결된 세션 건강 및 최근 수신자 표시. 옵션:
  • --json
  • --all (전체 진단; 읽기 전용, 붙여넣기 가능)
  • --deep (채널 탐색)
  • --usage (모델 프로바이더 사용량/할당량 표시)
  • --timeout <ms>
  • --verbose
  • --debug (별칭: --verbose)
노트:
  • 개요에는 사용 가능한 경우 게이트웨이 + 노드 호스트 서비스 상태가 포함됩니다.

사용량 추적

OpenClaw는 OAuth/API 자격 증명이 있을 때 프로바이더 사용량/할당량을 표시할 수 있습니다. 표면:
  • /status (가능할 경우 짧은 프로바이더 사용 라인 추가)
  • openclaw status --usage (전체 프로바이더 세부정보 출력)
  • macOS 메뉴 바 (문맥에서 사용량 섹션 아래)
노트:
  • 데이터는 직접적으로 프로바이더 사용량 엔드포인트에서 가져옵니다 (추정값 없음).
  • 프로바이더: Anthropic, GitHub Copilot, OpenAI Codex OAuth, Gemini CLI/Antigravity (이러한 프로바이더 플러그인이 활성화된 경우).
  • 일치하는 자격 증명이 없으면 사용량은 숨겨집니다.
  • 세부사항: 사용량 추적을 참조하세요.

health

실행 중인 게이트웨이로부터 건강 수신. 옵션:
  • --json
  • --timeout <ms>
  • --verbose

sessions

저장된 대화 세션 나열. 옵션:
  • --json
  • --verbose
  • --store <path>
  • --active <minutes>

초기화 / 제거

reset

로컬 구성/상태 초기화 (CLI는 남겨둠). 옵션:
  • --scope <config|config+creds+sessions|full>
  • --yes
  • --non-interactive
  • --dry-run
노트:
  • --non-interactive--scope--yes를 필요로 합니다.

uninstall

게이트웨이 서비스 + 로컬 데이터 제거 (CLI는 남겨둠). 옵션:
  • --service
  • --state
  • --workspace
  • --app
  • --all
  • --yes
  • --non-interactive
  • --dry-run
노트:
  • --non-interactive--yes와 명시적 범위 (또는 --all)를 필요로 합니다.

게이트웨이

gateway

WebSocket 게이트웨이 실행. 옵션:
  • --port <port>
  • --bind <loopback|tailnet|lan|auto|custom>
  • --token <token>
  • --auth <token|password>
  • --password <password>
  • --tailscale <off|serve|funnel>
  • --tailscale-reset-on-exit
  • --allow-unconfigured
  • --dev
  • --reset (dev 구성 + 자격 증명 + 세션 + 작업 공간 초기화)
  • --force (포트의 기존 리스너 종료)
  • --verbose
  • --claude-cli-logs
  • --ws-log <auto|full|compact>
  • --compact (별칭: --ws-log compact)
  • --raw-stream
  • --raw-stream-path <path>

gateway service

게이트웨이 서비스 관리 (launchd/systemd/schtasks). 하위 명령어:
  • gateway status (기본적으로 게이트웨이 RPC 탐색)
  • gateway install (서비스 설치)
  • gateway uninstall
  • gateway start
  • gateway stop
  • gateway restart
노트:
  • gateway status는 기본적으로 서비스의 해석된 포트/구성을 사용하여 게이트웨이 RPC를 탐색합니다 (--url/--token/--password로 오버라이드 가능).
  • gateway status는 스크립팅을 위한 --no-probe, --deep, --json을 지원합니다.
  • gateway status는 또한 감지할 수 있는 경우 레거시 또는 추가 게이트웨이 서비스를 표시합니다 (--deep는 시스템 수준 스캔 추가). 프로파일 이름의 OpenClaw 서비스는 일급으로 처리되며 “추가”로 표시되지 않습니다.
  • gateway status는 CLI가 사용하는 구성 경로와 서비스가 사용하는 경로 (서비스 환경), 및 해석된 탐색 대상 URL을 출력합니다.
  • gateway install|uninstall|start|stop|restart는 스크립팅을 위한 --json을 지원합니다 (기본 출력은 인간 친화적).
  • gateway install은 기본적으로 Node 런타임을 사용합니다; bun은 권장되지 않음 (WhatsApp/Telegram 버그).
  • gateway install 옵션: --port, --runtime, --token, --force, --json.

logs

게이트웨이 파일 로그를 RPC로 따릅니다. 노트:
  • TTY 세션은 컬러 구조 뷰를 렌더링합니다; 비-TTY는 일반 텍스트로 대체됩니다.
  • --json은 줄 단위 JSON을 출력합니다 (한 로그 이벤트당 한 줄).
예제:

gateway <subcommand>

게이트웨이 CLI 도우미 (--url, --token, --password, --timeout, --expect-final RPC 하위 명령어 사용). --url을 전달할 때, CLI는 자동으로 구성이나 환경 자격 증명을 적용하지 않습니다. --token 또는 --password를 명시적으로 포함하세요. 명시적 자격 증명이 없는 경우 오류입니다. 하위 명령어:
  • gateway call <method> [--params <json>]
  • gateway health
  • gateway status
  • gateway probe
  • gateway discover
  • gateway install|uninstall|start|stop|restart
  • gateway run
일반 RPCs:
  • config.apply (구성 유효성 검사 + 기록 + 재시작 + 웨이크)
  • config.patch (부분 업데이트 병합 + 재시작 + 웨이크)
  • update.run (업데이트 실행 + 재시작 + 웨이크)
팁: config.set/config.apply/config.patch를 직접 호출할 때, 기존 구성이 있는 경우 config.get에서 baseHash를 전달하세요.

모델

대체 동작 및 스캔 전략은 /concepts/models에서 확인하세요. 선호되는 Anthropic 인증 (설정 토큰):

models (루트)

openclaw modelsmodels status의 별칭입니다. 루트 옵션:
  • --status-json (별칭: models status --json)
  • --status-plain (별칭: models status --plain)

models list

옵션:
  • --all
  • --local
  • --provider <name>
  • --json
  • --plain

models status

옵션:
  • --json
  • --plain
  • --check (1 = 만료/없음, 2 = 만료 예정 시 종료)
  • --probe (구성된 인증 프로필의 라이브 프로브)
  • --probe-provider <name>
  • --probe-profile <id> (반복 또는 쉼표로 구분)
  • --probe-timeout <ms>
  • --probe-concurrency <n>
  • --probe-max-tokens <n>
항상 인증 개요와 인증 저장소의 프로필에 대한 OAuth 만료 상태를 포함합니다. --probe는 라이브 요청을 실행합니다 (토큰을 소모하고 속도 제한을 발생시킬 수 있습니다).

models set <model>

agents.defaults.model.primary를 설정합니다.

models set-image <model>

agents.defaults.imageModel.primary를 설정합니다.

models aliases list|add|remove

옵션:
  • list: --json, --plain
  • add <alias> <model>
  • remove <alias>

models fallbacks list|add|remove|clear

옵션:
  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models image-fallbacks list|add|remove|clear

옵션:
  • list: --json, --plain
  • add <model>
  • remove <model>
  • clear

models scan

옵션:
  • --min-params <b>
  • --max-age-days <days>
  • --provider <name>
  • --max-candidates <n>
  • --timeout <ms>
  • --concurrency <n>
  • --no-probe
  • --yes
  • --no-input
  • --set-default
  • --set-image
  • --json

models auth add|setup-token|paste-token

옵션:
  • add: 대화형 인증 도우미
  • setup-token: --provider <name> (기본값 anthropic), --yes
  • paste-token: --provider <name>, --profile-id <id>, --expires-in <duration>

models auth order get|set|clear

옵션:
  • get: --provider <name>, --agent <id>, --json
  • set: --provider <name>, --agent <id>, <profileIds...>
  • clear: --provider <name>, --agent <id>

시스템

system event

시스템 이벤트를 큐에 추가하고 옵션으로 하트비트를 트리거 (Gateway RPC). 필수:
  • --text <text>
옵션:
  • --mode <now|next-heartbeat>
  • --json
  • --url, --token, --timeout, --expect-final

system heartbeat last|enable|disable

하트비트 제어 (Gateway RPC). 옵션:
  • --json
  • --url, --token, --timeout, --expect-final

system presence

시스템 존재 항목 나열 (Gateway RPC). 옵션:
  • --json
  • --url, --token, --timeout, --expect-final

크론

예약된 작업 관리 (Gateway RPC). /automation/cron-jobs를 참조하세요. 하위 명령어:
  • cron status [--json]
  • cron list [--all] [--json] (기본적으로 테이블 출력; 원시 출력을 위한 --json 사용)
  • cron add (별칭: create; --name 및 정확히 하나씩의 --at | --every | --cron 필요, --system-event | --message 중 하나의 페이로드 필요)
  • cron edit <id> (필드 패치)
  • cron rm <id> (별칭: remove, delete)
  • cron enable <id>
  • cron disable <id>
  • cron runs --id <id> [--limit <n>]
  • cron run <id> [--force]
모든 cron 명령어는 --url, --token, --timeout, --expect-final을 허용합니다.

노드 호스트

node헤드리스 노드 호스트를 실행하거나 백그라운드 서비스로 관리합니다. openclaw node를 참조하세요. 하위 명령어:
  • node run --host <gateway-host> --port 18789
  • node status
  • node install [--host <gateway-host>] [--port <port>] [--tls] [--tls-fingerprint <sha256>] [--node-id <id>] [--display-name <name>] [--runtime <node|bun>] [--force]
  • node uninstall
  • node stop
  • node restart
인증 참고:
  • node--token/--password 플래그 없이 env/config에서 게이트웨이 인증을 해석합니다: OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, 그다음 gateway.auth.*, 필요 시 gateway.remote.*도 지원합니다.
  • 레거시 CLAWDBOT_GATEWAY_* 환경 변수는 node-host 인증 해석에서 의도적으로 무시됩니다.

노드

nodes는 게이트웨이와 대화하고 연결된 노드를 대상에 합니다. /nodes를 참조하세요. 일반 옵션:
  • --url, --token, --timeout, --json
하위 명령어:
  • nodes status [--connected] [--last-connected <duration>]
  • nodes describe --node <id|name|ip>
  • nodes list [--connected] [--last-connected <duration>]
  • nodes pending
  • nodes approve <requestId>
  • nodes reject <requestId>
  • nodes rename --node <id|name|ip> --name <displayName>
  • nodes invoke --node <id|name|ip> --command <command> [--params <json>] [--invoke-timeout <ms>] [--idempotency-key <key>]
  • nodes run --node <id|name|ip> [--cwd <path>] [--env KEY=VAL] [--command-timeout <ms>] [--needs-screen-recording] [--invoke-timeout <ms>] <command...> (맥 노드 또는 헤드리스 노드 호스트)
  • nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (맥 전용)
카메라:
  • nodes camera list --node <id|name|ip>
  • nodes camera snap --node <id|name|ip> [--facing front|back|both] [--device-id <id>] [--max-width <px>] [--quality <0-1>] [--delay-ms <ms>] [--invoke-timeout <ms>]
  • nodes camera clip --node <id|name|ip> [--facing front|back] [--device-id <id>] [--duration <ms|10s|1m>] [--no-audio] [--invoke-timeout <ms>]
캔버스 + 화면:
  • nodes canvas snapshot --node <id|name|ip> [--format png|jpg|jpeg] [--max-width <px>] [--quality <0-1>] [--invoke-timeout <ms>]
  • nodes canvas present --node <id|name|ip> [--target <urlOrPath>] [--x <px>] [--y <px>] [--width <px>] [--height <px>] [--invoke-timeout <ms>]
  • nodes canvas hide --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes canvas navigate <url> --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes canvas eval [<js>] --node <id|name|ip> [--js <code>] [--invoke-timeout <ms>]
  • nodes canvas a2ui push --node <id|name|ip> (--jsonl <path> | --text <text>) [--invoke-timeout <ms>]
  • nodes canvas a2ui reset --node <id|name|ip> [--invoke-timeout <ms>]
  • nodes screen record --node <id|name|ip> [--screen <index>] [--duration <ms|10s>] [--fps <n>] [--no-audio] [--out <path>] [--invoke-timeout <ms>]
위치:
  • nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]

브라우저

브라우저 제어 CLI (전용 Chrome/Brave/Edge/Chromium). openclaw browser브라우저 도구를 참조하세요. 일반 옵션:
  • --url, --token, --timeout, --json
  • --browser-profile <name>
관리:
  • browser status
  • browser start
  • browser stop
  • browser reset-profile
  • browser tabs
  • browser open <url>
  • browser focus <targetId>
  • browser close [targetId]
  • browser profiles
  • browser create-profile --name <name> [--color <hex>] [--cdp-url <url>]
  • browser delete-profile --name <name>
검사:
  • browser screenshot [targetId] [--full-page] [--ref <ref>] [--element <selector>] [--type png|jpeg]
  • browser snapshot [--format aria|ai] [--target-id <id>] [--limit <n>] [--interactive] [--compact] [--depth <n>] [--selector <sel>] [--out <path>]
동작:
  • browser navigate <url> [--target-id <id>]
  • browser resize <width> <height> [--target-id <id>]
  • browser click <ref> [--double] [--button <left|right|middle>] [--modifiers <csv>] [--target-id <id>]
  • browser type <ref> <text> [--submit] [--slowly] [--target-id <id>]
  • browser press <key> [--target-id <id>]
  • browser hover <ref> [--target-id <id>]
  • browser drag <startRef> <endRef> [--target-id <id>]
  • browser select <ref> <values...> [--target-id <id>]
  • browser upload <paths...> [--ref <ref>] [--input-ref <ref>] [--element <selector>] [--target-id <id>] [--timeout-ms <ms>]
  • browser fill [--fields <json>] [--fields-file <path>] [--target-id <id>]
  • browser dialog --accept|--dismiss [--prompt <text>] [--target-id <id>] [--timeout-ms <ms>]
  • browser wait [--time <ms>] [--text <value>] [--text-gone <value>] [--target-id <id>]
  • browser evaluate --fn <code> [--ref <ref>] [--target-id <id>]
  • browser console [--level <error|warn|info>] [--target-id <id>]
  • browser pdf [--target-id <id>]

문서 검색

docs [query...]

라이브 문서 색인을 검색합니다.

TUI

tui

게이트웨이에 연결된 터미널 UI를 엽니다. 옵션:
  • --url <url>
  • --token <token>
  • --password <password>
  • --session <key>
  • --deliver
  • --thinking <level>
  • --message <text>
  • --timeout-ms <ms> (기본값은 agents.defaults.timeoutSeconds)
  • --history-limit <n>