CLI commands

CLI 참조

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

의도에 맞게 설정 명령을 사용하세요.

openclaw setup 및 openclaw onboard는 Gateway, 모델 인증, 작업 영역, 채널, Skills, 상태 점검을 위한 전체 안내식 최초 실행 경로를 실행합니다.
openclaw setup --baseline은 안내식 온보딩 흐름을 거치지 않고 기준 구성과 작업 영역을 생성합니다.
openclaw configure는 모델 인증, Gateway, 채널, Plugin 또는 Skills 같은 기존 설정의 특정 부분을 변경합니다.
기준 구성이 존재한 뒤 openclaw channels add로 채널 계정을 구성합니다. 안내식 채널 설정에는 플래그 없이 실행하고, 스크립트에는 채널별 플래그를 함께 사용하세요.

명령 페이지

영역	명령
설정 및 온보딩	`crestodian` · `setup` · `onboard` · `configure` · `config` · `completion` · `doctor` · `dashboard`
재설정 및 제거	`backup` · `reset` · `uninstall` · `update`
메시징 및 에이전트	`message` · `agent` · `agents` · `attach` · `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` · `transcripts`
검색 및 문서	`dns` · `docs`
페어링 및 채널	`pairing` · `qr` · `channels`
보안 및 Plugin	`security` · `secrets` · `skills` · `plugins` · `proxy`
레거시 별칭	`daemon` (Gateway 서비스) · `clawbot` (네임스페이스)
Plugin(선택 사항)	`path` · `policy` · `voicecall` · `workboard` (설치된 경우)

전역 플래그

플래그	목적
`--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 listworkboard  list  create  show  dispatchmemory  status  index  searchtranscripts  list  show  pathpath  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-identityattachacpmcp  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 workboard 또는 openclaw voicecall 같은 추가 최상위 명령을 더할 수 있습니다.

채팅 슬래시 명령

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

주요 항목:

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

사용량 추적

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

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