CLI commands

CLI 참조

openclaw는 기본 CLI 진입점입니다. 각 핵심 명령은 전용 참조 페이지가 있거나 별칭을 지정하는 명령과 함께 문서화되어 있습니다. 이 색인은 CLI 전반에 적용되는 명령, 전역 플래그, 출력 스타일 규칙을 나열합니다.

의도에 따라 설정 명령을 사용하세요.

openclaw setup은 전체 안내형 온보딩 흐름을 진행하지 않고 기본 구성과 워크스페이스를 만듭니다.
openclaw onboard는 Gateway, 모델 인증, 워크스페이스, 채널, Skills, 상태 점검을 위한 전체 안내형 최초 실행 경로입니다.
openclaw configure는 모델 인증, Gateway, 채널, Plugin, Skills처럼 기존 설정의 특정 부분을 변경합니다.
openclaw channels add는 기본 설정이 존재한 뒤 채널 계정을 구성합니다. 안내형 채널 설정에는 플래그 없이 실행하고, 스크립트에는 채널별 플래그와 함께 실행하세요.

명령 페이지

영역	명령
설정 및 온보딩	`crestodian` · `setup` · `onboard` · `configure` · `config` · `completion` · `doctor` · `dashboard`
재설정 및 제거	`backup` · `reset` · `uninstall` · `update`
메시징 및 에이전트	`message` · `agent` · `agents` · `acp` · `mcp`
상태 점검 및 세션	`status` · `health` · `sessions`
Gateway 및 로그	`gateway` · `logs` · `system`
모델 및 추론	`models` · `infer` · `capability` (`infer`의 별칭) · `memory` · `commitments` · `wiki`
네트워크 및 노드	`directory` · `nodes` · `devices` · `node`
런타임 및 샌드박스	`approvals` · `exec-policy` (`approvals` 참조) · `sandbox` · `tui` · `chat`/`terminal` (`tui --local`의 별칭) · `browser`
자동화	`cron` · `tasks` · `hooks` · `webhooks`
탐색 및 문서	`dns` · `docs`
페어링 및 채널	`pairing` · `qr` · `channels`
보안 및 Plugin	`security` · `secrets` · `skills` · `plugins` · `proxy`
레거시 별칭	`daemon` (Gateway 서비스) · `clawbot` (네임스페이스)
Plugin(선택 사항)	`path` · `voicecall` (설치된 경우)

전역 플래그

플래그	목적
`--dev`	상태를 `~/.openclaw-dev` 아래로 격리하고 기본 포트를 변경합니다
`--profile <name>`	상태를 `~/.openclaw-<name>` 아래로 격리합니다
`--container <name>`	실행할 이름 있는 컨테이너를 대상으로 지정합니다
`--no-color`	ANSI 색상을 비활성화합니다(`NO_COLOR=1`도 존중됨)
`--update`	`openclaw update`의 축약형입니다(소스 설치만 해당)
`-V`, `--version`, `-v`	버전을 출력하고 종료합니다

출력 모드

ANSI 색상과 진행률 표시기는 TTY 세션에서만 렌더링됩니다.
OSC-8 하이퍼링크는 지원되는 곳에서 클릭 가능한 링크로 렌더링됩니다. 그렇지 않으면 CLI가 일반 URL로 대체합니다.
--json(및 지원되는 경우 --plain)은 깔끔한 출력을 위해 스타일을 비활성화합니다.
장시간 실행되는 명령은 진행률 표시기를 보여줍니다(지원되는 경우 OSC 9;4).

팔레트의 단일 진실 공급원: src/terminal/palette.ts.

명령 트리

전체 명령 트리

Code

openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig  get  set  unset  file  schema  validatecompletiondoctordashboardbackup  create  verifysecurity  auditsecrets  reload  audit  configure  applyresetuninstallupdate  wizard  statuschannels  list  status  capabilities  resolve  logs  add  remove  login  logoutdirectory  self  peers list  groups list|membersskills  search  install  update  list  info  checkplugins  list  inspect  install  uninstall  update  enable  disable  doctor  marketplace listmemory  status  index  searchpath  resolve  find  set  validate  emitcommitments  list  dismisswiki  status  doctor  init  ingest  compile  lint  search  get  apply  bridge import  unsafe-local import  obsidian status|search|open|command|dailymessage  send  broadcast  poll  react  reactions  read  edit  delete  pin  unpin  pins  permissions  search  thread create|list|reply  emoji list|upload  sticker send|upload  role info|add|remove  channel info|list  member info  voice status  event list|create  timeout  kick  banagentagents  list  add  delete  bindings  bind  unbind  set-identityacpmcp  serve  list  show  set  unsetstatushealthsessions  cleanuptasks  list  audit  maintenance  show  notify  cancel  flow list|show|cancelgateway  call  usage-cost  health  status  probe  discover  install  uninstall  start  stop  restart  rundaemon  status  install  uninstall  start  stop  restartlogssystem  event  heartbeat last|enable|disable  presencemodels  list  status  set  set-image  aliases list|add|remove  fallbacks list|add|remove|clear  image-fallbacks list|add|remove|clear  scaninfer (alias: capability)  list  inspect  model run|list|inspect|providers|auth login|logout|status  image generate|edit|describe|describe-many|providers  audio transcribe|providers  tts convert|voices|providers|status|enable|disable|set-provider  video generate|describe|providers  web search|fetch|providers  embedding create|providers  auth add|login|login-github-copilot|setup-token|paste-token  auth order get|set|clearsandbox  list  recreate  explaincron  status  list  get  add  edit  rm  enable  disable  runs  runnodes  status  describe  list  pending  approve  reject  rename  invoke  notify  push  canvas snapshot|present|hide|navigate|eval  canvas a2ui push|reset  camera list|snap|clip  screen record  location getdevices  list  remove  clear  approve  reject  rotate  revokenode  run  status  install  uninstall  stop  restartapprovals  get  set  allowlist add|removeexec-policy  show  preset  setbrowser  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  pdfhooks  list  info  check  enable  disable  install  updatewebhooks  gmail setup|runproxy  start  run  coverage  sessions  query  blob  purgepairing  list  approveqrclawbot  qrdocsdns  setuptuichat (alias: tui --local)terminal (alias: tui --local)

Plugin은 추가 최상위 명령을 추가할 수 있습니다(예: openclaw voicecall).

채팅 슬래시 명령

채팅 메시지는 /... 명령을 지원합니다. 슬래시 명령을 참조하세요.

주요 항목:

/status — 빠른 진단입니다.
/trace — 세션 범위 Plugin 추적/디버그 줄입니다.
/config — 영구 저장되는 구성 변경입니다.
/debug — 런타임 전용 구성 재정의입니다(메모리, 디스크 아님. commands.debug: true 필요).

사용량 추적

openclaw status --usage와 Control UI는 OAuth/API 자격 증명을 사용할 수 있을 때 공급자 사용량/할당량을 표시합니다. 데이터는 공급자 사용량 엔드포인트에서 직접 가져오며 X% left로 정규화됩니다. 현재 사용량 창이 있는 공급자: Anthropic, GitHub Copilot, Gemini CLI, OpenAI Codex, MiniMax, Xiaomi, z.ai.

자세한 내용은 사용량 추적을 참조하세요.