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 [--dev] [--profile <name>] <command>
  setup
  onboard
  configure
  config
    get
    set
    unset
  completion
  doctor
  dashboard
  backup
    create
    verify
  security
    audit
  secrets
    reload
    migrate
  reset
  uninstall
  update
  channels
    list
    status
    logs
    add
    remove
    login
    logout
  directory
  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
  daemon
    status
    install
    uninstall
    start
    stop
    restart
  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
  qr
  clawbot
    qr
  docs
  dns
    setup
  tui

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

보안

openclaw security audit — 일반적인 보안 취약점에 대해 설정 + 로컬 상태를 감사합니다.
openclaw security audit --deep — 최선 노력의 실시간 게이트웨이 점검.
openclaw security audit --fix — 안전한 기본값을 강화하고 상태/설정 파일 권한을 변경합니다.

시크릿

openclaw secrets reload — 참조를 다시 해석하고 런타임 스냅샷을 원자적으로 교체합니다.
openclaw secrets audit — 평문 잔여물, 미해석 참조, 우선순위 드리프트를 검사합니다.
openclaw secrets configure — 프로바이더 설정 + SecretRef 매핑 + 사전검사/적용을 위한 대화형 도우미.
openclaw secrets apply --from <plan.json> — 이전에 생성된 계획을 적용합니다(--dry-run 지원).

플러그인

확장 프로그램과 설정을 관리합니다:

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 (마법사 전에 설정 + 자격 증명 + 세션 초기화)
--reset-scope <config|config+creds+sessions|full> (기본값 config+creds+sessions; 워크스페이스도 제거하려면 full 사용)
--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)
--secret-input-mode <plaintext|ref> (기본값 plaintext; 평문 키 대신 프로바이더 기본 env 참조를 저장하려면 ref 사용)
--anthropic-api-key <key>
--openai-api-key <key>
--mistral-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 권장; bun은 게이트웨이 런타임에 비권장)
--json

`configure`

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

`config`

비대화형 설정 도우미 (get/set/unset/file/validate). 하위 명령어 없이 openclaw config를 실행하면 마법사가 시작됩니다.

하위 명령어:

config get <path>: 설정 값을 출력합니다(점/대괄호 경로).
config set <path> <value>: 값을 설정합니다(JSON5 또는 원시 문자열).
config unset <path>: 값을 제거합니다.
config file: 활성 설정 파일 경로를 출력합니다.
config validate: 게이트웨이를 시작하지 않고 현재 설정을 스키마에 대해 유효성 검사합니다.
config validate --json: 기계 판독 가능 JSON 출력을 생성합니다.

`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: 플래그 없이 실행하면 마법사 스타일 설정; 플래그를 사용하면 비대화형 모드로 전환됩니다.
- 아직 단일 계정 최상위 설정을 사용하는 채널에 기본이 아닌 계정을 추가할 때, OpenClaw은 계정 범위 값을 channels.<channel>.accounts.default로 이동한 후 새 계정을 기록합니다.
- 비대화형 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

예시:

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

게이트웨이를 통해 에이전트 턴 1회 실행 (또는 --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]를 사용합니다. accountId를 생략하면 OpenClaw이 채널 기본값/플러그인 훅을 통해 계정 범위를 해석할 수 있습니다; 그렇지 않으면 명시적 계정 범위가 없는 채널 바인딩이 됩니다.

`agents bindings`

라우팅 바인딩을 나열합니다.

옵션:

--agent <id>
--json

`agents bind`

에이전트에 라우팅 바인딩을 추가합니다.

옵션:

--agent <id>
--bind <channel[:accountId]> (반복 가능)
--json

`agents unbind`

에이전트의 라우팅 바인딩을 제거합니다.

옵션:

--agent <id>
--bind <channel[:accountId]> (반복 가능)
--all
--json

`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 메뉴 바 (Context 아래 Usage 섹션)

참고:

데이터는 프로바이더 사용량 엔드포인트에서 직접 제공됩니다(추정치 없음).
프로바이더: Anthropic, GitHub Copilot, OpenAI Codex OAuth, 그리고 해당 프로바이더 플러그인이 활성화된 경우 Gemini CLI/Antigravity.
매칭되는 자격 증명이 없으면 사용량이 숨겨집니다.
세부 사항: Usage tracking 참조.

`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>
--password-file <path>
--tailscale <off|serve|funnel>
--tailscale-reset-on-exit
--allow-unconfigured
--dev
--reset (개발 설정 + 자격 증명 + 세션 + 워크스페이스 초기화)
--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가 사용하는 설정 경로와 서비스가 사용할 가능성이 있는 설정(서비스 env), 해석된 점검 대상 URL을 출력합니다.
Linux systemd 설치에서 status 토큰 드리프트 검사는 유닛에서 Environment=과 EnvironmentFile= 값을 모두 읽습니다(%h, 따옴표 경로, 여러 파일, 선택적 - 파일 포함).
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을 출력합니다(줄당 하나의 로그 이벤트).

예시:

openclaw logs --follow
openclaw logs --limit 200
openclaw logs --plain
openclaw logs --json
openclaw logs --no-color

`gateway <subcommand>`

게이트웨이 CLI 도우미(RPC 하위 명령어에는 --url, --token, --password, --timeout, --expect-final 사용). --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

일반 RPC:

config.apply (설정 유효성 검사 + 기록 + 재시작 + 깨우기)
config.patch (부분 업데이트 병합 + 재시작 + 깨우기)
update.run (업데이트 실행 + 재시작 + 깨우기)

팁: config.set/config.apply/config.patch를 직접 호출할 때, 설정이 이미 존재하면 config.get에서 baseHash를 전달하세요.

모델

폴백 동작과 스캐닝 전략은 /concepts/models를 참조하세요.

Anthropic setup-token (지원됨):

claude setup-token
openclaw models auth setup-token --provider anthropic
openclaw models status

정책 참고: 이것은 기술적 호환성입니다. Anthropic은 과거에 Claude Code 외부에서의 일부 구독 사용을 차단한 적이 있습니다; 프로덕션에서 setup-token에 의존하기 전에 현재 Anthropic 약관을 확인하세요.

`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 (종료 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`

시스템 이벤트를 큐에 넣고 선택적으로 하트비트를 트리거합니다(게이트웨이 RPC).

필수:

--text <text>

옵션:

--mode <now|next-heartbeat>
--json
--url, --token, --timeout, --expect-final

`system heartbeat last|enable|disable`

하트비트 제어(게이트웨이 RPC).

옵션:

--json
--url, --token, --timeout, --expect-final

`system presence`

시스템 프레즌스 항목을 나열합니다(게이트웨이 RPC).

옵션:

--json
--url, --token, --timeout, --expect-final

Cron

예약된 작업을 관리합니다(게이트웨이 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는 env/config에서 게이트웨이 인증을 해석합니다(--token/--password 플래그 없음): OPENCLAW_GATEWAY_TOKEN / OPENCLAW_GATEWAY_PASSWORD, 그 다음 gateway.auth.*. 로컬 모드에서 노드 호스트는 의도적으로 gateway.remote.*를 무시합니다; gateway.mode=remote에서는 gateway.remote.*가 원격 우선순위 규칙에 따라 참여합니다.
레거시 CLAWDBOT_GATEWAY_* 환경 변수는 노드 호스트 인증 해석에서 의도적으로 무시됩니다.

노드

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...> (mac 노드 또는 헤드리스 노드 호스트)
nodes notify --node <id|name|ip> [--title <text>] [--body <text>] [--sound <name>] [--priority <passive|active|timeSensitive>] [--delivery <system|overlay|auto>] [--invoke-timeout <ms>] (mac만)

카메라:

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와 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 [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>

CLI 레퍼런스

명령어 페이지

전역 플래그

출력 스타일

색상 팔레트

명령어 트리

보안

시크릿

플러그인

메모리

채팅 슬래시 명령어

설정 + 온보딩

setup

onboard

configure

config

doctor

채널 도우미

channels

skills

pairing

devices

webhooks gmail

dns setup

메시징 + 에이전트

message

agent

agents

agents list

agents add [name]

agents bindings

agents bind

agents unbind

agents delete <id>

acp

status

사용량 추적

health

sessions

초기화 / 제거

reset

uninstall

게이트웨이

gateway

gateway service

logs

gateway <subcommand>

모델

models (루트)

models list

models status

models set <model>

models set-image <model>

models aliases list|add|remove

models fallbacks list|add|remove|clear

models image-fallbacks list|add|remove|clear

models scan

models auth add|setup-token|paste-token

models auth order get|set|clear

시스템

system event

system heartbeat last|enable|disable

system presence

Cron

노드 호스트

노드

브라우저

문서 검색

docs [query...]

TUI

tui

`setup`

`onboard`

`configure`

`config`

`doctor`

`channels`

`skills`

`pairing`

`devices`

`webhooks gmail`

`dns setup`

`message`

`agent`

`agents`

`agents list`

`agents add [name]`

`agents bindings`

`agents bind`

`agents unbind`

`agents delete <id>`

`acp`

`status`

`health`

`sessions`

`reset`

`uninstall`

`gateway`

`gateway service`

`logs`

`gateway <subcommand>`

`models` (루트)

`models list`

`models status`

`models set <model>`

`models set-image <model>`

`models aliases list|add|remove`

`models fallbacks list|add|remove|clear`

`models image-fallbacks list|add|remove|clear`

`models scan`

`models auth add|setup-token|paste-token`

`models auth order get|set|clear`

`system event`

`system heartbeat last|enable|disable`

`system presence`

`docs [query...]`

`tui`