CLI 참조
이 페이지는 현재 CLI 동작을 설명합니다. 명령이 변경되면 이 문서를 업데이트하세요.
명령 페이지
- setup
- onboard
- configure
- config
- doctor
- dashboard
- reset
- uninstall
- update
- message
- agent
- agents
- acp
- status
- health
- sessions
- gateway
- logs
- system
- models
- memory
- nodes
- devices
- node
- approvals
- sandbox
- tui
- browser
- cron
- dns
- docs
- hooks
- webhooks
- pairing
- plugins (플러그인 명령)
- channels
- security
- skills
- voicecall (플러그인; 설치된 경우)
전역 플래그
- --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 출력에 lobster 팔레트를 사용합니다.
- accent (#FF5A2D): 제목, 레이블, 주요 하이라이트.
- accentBright (#FF7A3D): 명령 이름, 강조.
- accentDim (#D14A22): 보조 하이라이트 텍스트.
- info (#FF8A5B): 정보 값.
- success (#2FBF71): 성공 상태.
- warn (#FFB020): 경고, 폴백, 주의.
- error (#E23D2D): 오류, 실패.
- muted (#8B7F77): 덜 강조, 메타데이터.
팔레트 진실의 출처: src/terminal/palette.ts (일명 "lobster seam").
명령 트리
openclaw [--dev] [--profile <name>] <command>
setup
onboard
configure
config
get
set
unset
doctor
security
audit
reset
uninstall
update
channels
list
status
logs
add
remove
login
logout
skills
list
info
check
plugins
list
info
install
enable
disable
doctor
memory
status
index
search
message
agent
agents
list
add
delete
acp
status
health
sessions
gateway
call
health
status
probe
discover
install
uninstall
start
stop
restart
run
logs
system
event
heartbeat last|enable|disable
presence
models
list
status
set
set-image
aliases list|add|remove
fallbacks list|add|remove|clear
image-fallbacks list|add|remove|clear
scan
auth add|setup-token|paste-token
auth order get|set|clear
sandbox
list
recreate
explain
cron
status
list
add
edit
rm
enable
disable
runs
run
nodes
devices
node
run
status
install
uninstall
start
stop
restart
approvals
get
set
allowlist add|remove
browser
status
start
stop
reset-profile
tabs
open
focus
close
profiles
create-profile
delete-profile
screenshot
snapshot
navigate
resize
click
type
press
hover
drag
select
upload
fill
dialog
wait
evaluate
console
pdf
hooks
list
info
check
enable
disable
install
update
webhooks
gmail setup|run
pairing
list
approve
docs
dns
setup
tui
참고: 플러그인은 추가 최상위 명령을 추가할 수 있습니다 (예: openclaw voicecall).
Security
- openclaw security audit — 일반적인 보안 실수에 대한 config + 로컬 상태 감사.
- openclaw security audit --deep — 최선의 노력으로 실시간 Gateway 조사.
- openclaw security audit --fix — 안전한 기본값을 강화하고 상태/config chmod.
Plugins
확장과 config를 관리합니다:
- 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 — 플러그인 로드 오류 보고.
대부분의 플러그인 변경은 gateway 재시작이 필요합니다. /plugin 참조.
Memory
MEMORY.md + memory/*.md에 대한 벡터 검색:
- openclaw memory status — 인덱스 통계 표시.
- openclaw memory index — 메모리 파일 재인덱싱.
- openclaw memory search "<query>" — 메모리에 대한 의미론적 검색.
Chat slash 명령
채팅 메시지는 /... 명령을 지원합니다 (텍스트 및 네이티브). /tools/slash-commands 참조.
하이라이트:
- 빠른 진단을 위한 /status.
- 지속된 config 변경을 위한 /config.
- 런타임 전용 config 재정의를 위한 /debug (메모리, 디스크 아님; commands.debug: true 필요).
Setup + onboarding
setup
config + workspace를 초기화합니다.
옵션:
- --workspace <dir>: 에이전트 workspace 경로 (기본값 ~/.openclaw/workspace).
- --wizard: 온보딩 마법사 실행.
- --non-interactive: 프롬프트 없이 마법사 실행.
- --mode <local|remote>: 마법사 모드.
- --remote-url <url>: 원격 Gateway URL.
- --remote-token <token>: 원격 Gateway 토큰.
마법사 플래그가 있으면 마법사가 자동 실행됩니다 (--non-interactive, --mode, --remote-url, --remote-token).
onboard
gateway, workspace, skills를 설정하는 대화형 마법사입니다.
옵션:
- --workspace <dir>
- --reset (마법사 전에 config + credentials + sessions + workspace 리셋)
- --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|ai-gateway-api-key|moonshot-api-key|kimi-code-api-key|synthetic-api-key|venice-api-key|gemini-api-key|zai-api-key|apiKey|minimax-api|minimax-api-lightning|opencode-zen|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>
- --gateway-port <port>
- --gateway-bind <loopback|lan|tailnet|auto|custom>
- --gateway-auth <token|password>
- --gateway-token <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
대화형 구성 마법사 (모델, 채널, skills, gateway).
config
비대화형 config 헬퍼 (get/set/unset). 서브명령 없이 openclaw config를 실행하면 마법사가 시작됩니다.
서브명령:
- config get <path>: config 값 출력 (점/대괄호 경로).
- config set <path> <value>: 값 설정 (JSON5 또는 원시 문자열).
- config unset <path>: 값 제거.
doctor
상태 확인 + 빠른 수정 (config + gateway + 레거시 서비스).
옵션:
- --no-workspace-suggestions: workspace 메모리 힌트 비활성화.
- --yes: 프롬프트 없이 기본값 수락 (헤드리스).
- --non-interactive: 프롬프트 건너뜀; 안전한 마이그레이션만 적용.
- --deep: 추가 gateway 설치를 위한 시스템 서비스 스캔.
Channel 헬퍼
channels
채팅 채널 계정을 관리합니다 (WhatsApp/Telegram/Discord/Google Chat/Slack/Mattermost (plugin)/Signal/iMessage/MS Teams).
서브명령:
- channels list: 구성된 채널과 인증 프로필을 표시합니다.
- channels status: gateway 접근성과 채널 상태를 확인합니다 (--probe는 추가 확인을 실행; gateway 상태 조사를 위해 openclaw health 또는 openclaw status --deep 사용).
- 팁: channels status는 일반적인 잘못된 구성을 감지할 수 있을 때 제안된 수정과 함께 경고를 출력합니다 (그런 다음 openclaw doctor를 가리킴).
- channels logs: gateway 로그 파일에서 최근 채널 로그를 표시합니다.
- channels add: 플래그가 전달되지 않으면 마법사 스타일 설정; 플래그는 비대화형 모드로 전환합니다.
- channels remove: 기본적으로 비활성화; 프롬프트 없이 config 항목을 제거하려면 --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
예시:
openclaw channels add --channel telegram --account alerts --name "Alerts Bot" --token $TELEGRAM_BOT_TOKEN
openclaw channels add --channel discord --account work --name "Work Bot" --token $DISCORD_BOT_TOKEN
openclaw channels remove --channel discord --account work --delete
openclaw channels status --probe
openclaw status --deep
skills
사용 가능한 skills와 준비 상태 정보를 나열하고 검사합니다.
서브명령:
- skills list: skills 나열 (서브명령 없을 때 기본값).
- skills info <name>: 하나의 skill에 대한 세부 정보 표시.
- skills check: 준비된 것과 누락된 요구 사항의 요약.
옵션:
- --eligible: 준비된 skills만 표시.
- --json: JSON 출력 (스타일링 없음).
- -v, --verbose: 누락된 요구 사항 세부 정보 포함.
팁: npx clawdhub를 사용하여 skills를 검색, 설치 및 동기화합니다.
pairing
채널 간 DM 페어링 요청을 승인합니다.
서브명령:
- pairing list <channel> [--json]
- pairing approve <channel> <code> [--notify]
webhooks gmail
Gmail Pub/Sub hook 설정 + 러너. /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 config 설치/업데이트 (sudo 필요; macOS 전용).
Messaging + agent
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
Gateway를 통해 에이전트 턴 하나를 실행합니다 (또는 임베디드 --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를 Gateway에 연결하는 ACP 브리지를 실행합니다.
전체 옵션과 예시는 acp 참조.
status
연결된 세션 상태와 최근 수신자를 표시합니다.
옵션:
- --json
- --all (전체 진단; 읽기 전용, 붙여넣기 가능)
- --deep (채널 조사)
- --usage (모델 제공자 사용량/할당량 표시)
- --timeout <ms>
- --verbose
- --debug (--verbose의 별칭)
참고사항:
- 개요에는 사용 가능한 경우 Gateway + node 호스트 서비스 상태가 포함됩니다.
사용량 추적
OpenClaw는 OAuth/API 자격 증명이 사용 가능할 때 제공자 사용량/할당량을 표시할 수 있습니다.
표시 위치:
- /status (사용 가능한 경우 짧은 제공자 사용량 라인 추가)
- openclaw status --usage (전체 제공자 분석 출력)
- macOS 메뉴 바 (Context 아래 Usage 섹션)
참고사항:
- 데이터는 제공자 사용량 엔드포인트에서 직접 가져옵니다 (추정 없음).
- 제공자: Anthropic, GitHub Copilot, OpenAI Codex OAuth, 그리고 해당 제공자 플러그인이 활성화된 경우 Gemini CLI/Antigravity.
- 일치하는 자격 증명이 없으면 사용량이 숨겨집니다.
- 세부 사항: Usage tracking 참조.
health
실행 중인 Gateway에서 상태를 가져옵니다.
옵션:
- --json
- --timeout <ms>
- --verbose
sessions
저장된 대화 세션을 나열합니다.
옵션:
- --json
- --verbose
- --store <path>
- --active <minutes>
Reset / Uninstall
reset
로컬 config/상태를 리셋합니다 (CLI는 설치된 상태로 유지).
옵션:
- --scope <config|config+creds+sessions|full>
- --yes
- --non-interactive
- --dry-run
참고사항:
- --non-interactive는 --scope와 --yes가 필요합니다.
uninstall
gateway 서비스 + 로컬 데이터를 제거합니다 (CLI는 유지).
옵션:
- --service
- --state
- --workspace
- --app
- --all
- --yes
- --non-interactive
- --dry-run
참고사항:
- --non-interactive는 --yes와 명시적 범위 (또는 --all)가 필요합니다.
Gateway
gateway
WebSocket Gateway를 실행합니다.
옵션:
- --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 config + credentials + sessions + workspace 리셋)
- --force (포트의 기존 리스너 종료)
- --verbose
- --claude-cli-logs
- --ws-log <auto|full|compact>
- --compact (--ws-log compact의 별칭)
- --raw-stream
- --raw-stream-path <path>
gateway service
Gateway 서비스를 관리합니다 (launchd/systemd/schtasks).
서브명령:
- gateway status (기본적으로 Gateway RPC 조사)
- gateway install (서비스 설치)
- gateway uninstall
- gateway start
- gateway stop
- gateway restart
참고사항:
- gateway status는 기본적으로 서비스의 해결된 포트/config를 사용하여 Gateway RPC를 조사합니다 (--url/--token/--password로 재정의).
- gateway status는 스크립팅을 위해 --no-probe, --deep, --json을 지원합니다.
- gateway status는 감지할 수 있는 경우 레거시 또는 추가 gateway 서비스도 표시합니다 (--deep는 시스템 수준 스캔 추가). 프로필 이름의 OpenClaw 서비스는 일급으로 처리되며 "extra"로 플래그되지 않습니다.
- gateway status는 CLI가 사용하는 config 경로와 서비스가 사용할 가능성이 있는 config (서비스 env), 그리고 해결된 조사 대상 URL을 출력합니다.
- gateway install|uninstall|start|stop|restart는 스크립팅을 위해 --json을 지원합니다 (기본 출력은 사람 친화적).
- gateway install은 기본적으로 Node 런타임; bun은 권장하지 않음 (WhatsApp/Telegram 버그).
- gateway install 옵션: --port, --runtime, --token, --force, --json.
logs
RPC를 통해 Gateway 파일 로그를 테일합니다.
참고사항:
- TTY 세션은 색상이 있는 구조화된 뷰를 렌더링합니다. 비TTY는 일반 텍스트로 폴백합니다.
- --json은 줄 구분 JSON을 출력합니다 (줄당 하나의 로그 이벤트).
예시:
openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color
gateway <subcommand>
Gateway CLI 헬퍼 (RPC 서브명령에는 --url, --token, --password, --timeout, --expect-final 사용).
서브명령:
- gateway call <method> [--params <json>]
- gateway health
- gateway status
- gateway probe
- gateway discover
- gateway install|uninstall|start|stop|restart
- gateway run
일반 RPC:
- config.apply (config 검증 + 작성 + 재시작 + 깨우기)
- config.patch (부분 업데이트 병합 + 재시작 + 깨우기)
- update.run (업데이트 실행 + 재시작 + 깨우기)
팁: config.set/config.apply/config.patch를 직접 호출할 때, config가 이미 존재하면 config.get에서 baseHash를 전달하세요.
Models
폴백 동작과 스캐닝 전략은 /concepts/models 참조.
선호하는 Anthropic 인증 (setup-token):
claude setup-token
openclaw models auth setup-token --provider anthropic
openclaw models status
models (루트)
openclaw models는 models status의 별칭입니다.
루트 옵션:
- --status-json (models status --json의 별칭)
- --status-plain (models status --plain의 별칭)
models list
옵션:
- --all
- --local
- --provider <name>
- --json
- --plain
models status
옵션:
- --json
- --plain
- --check (exit 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
system event
시스템 이벤트를 대기열에 추가하고 선택적으로 heartbeat를 트리거합니다 (Gateway RPC).
필수:
- --text <text>
옵션:
- --mode <now|next-heartbeat>
- --json
- --url, --token, --timeout, --expect-final
system heartbeat last|enable|disable
Heartbeat 제어 (Gateway RPC).
옵션:
- --json
- --url, --token, --timeout, --expect-final
system presence
시스템 프레즌스 항목 나열 (Gateway RPC).
옵션:
- --json
- --url, --token, --timeout, --expect-final
Cron
예약된 작업을 관리합니다 (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 host
node는 헤드리스 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
Nodes
nodes는 Gateway와 통신하여 페어링된 노드를 대상으로 합니다. /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...> (mac node 또는 헤드리스 node 호스트)
- nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (mac 전용)
Camera:
- 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>]
Canvas + screen:
- 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>]
Location:
- nodes location get --node <id|name|ip> [--max-age <ms>] [--accuracy <coarse|balanced|precise>] [--location-timeout <ms>] [--invoke-timeout <ms>]
Browser
브라우저 제어 CLI (전용 Chrome/Brave/Edge/Chromium). openclaw browser와 Browser tool 참조.
일반 옵션:
- --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 검색
docs [query...]
실시간 문서 인덱스를 검색합니다.
TUI
tui
Gateway에 연결된 터미널 UI를 엽니다.
옵션:
- --url <url>
- --token <token>
- --password <password>
- --session <key>
- --deliver
- --thinking <level>
- --message <text>
- --timeout-ms <ms> (agents.defaults.timeoutSeconds가 기본값)
- --history-limit <n>