CLI commands
CLI 참고 자료
openclaw은 기본 CLI 진입점입니다. 각 핵심 명령에는 전용
참조 페이지가 있거나 별칭 대상 명령과 함께 문서화되어 있습니다. 이 색인에는
CLI 전반에 적용되는 명령, 전역 플래그 및 출력 스타일 규칙이 나열되어 있습니다.
목적별 설정 명령:
openclaw setup과openclaw onboard는 먼저 추론을 확인한 다음 Gateway, 작업 공간, 채널, Skills 및 상태 설정을 위해 Crestodian을 시작합니다.openclaw setup --baseline은 안내형 온보딩 흐름을 거치지 않고 기준 구성과 작업 공간을 생성합니다.openclaw configure는 기존 설정의 특정 부분인 모델 인증, Gateway, 채널, Plugin 또는 Skills를 변경합니다.openclaw channels add는 기준 구성이 존재한 후 채널 계정을 구성합니다. 안내형 설정에는 플래그 없이 실행하고, 스크립트에서는 채널별 플래그와 함께 실행합니다.
명령 페이지
| 영역 | 명령 |
|---|---|
| 설정 및 온보딩 | crestodian · setup · onboard · configure · config · completion · doctor · dashboard |
| 초기화, 백업 및 마이그레이션 | backup · migrate · reset · uninstall · update |
| 메시징 및 에이전트 | message · agent · agents · attach · acp · mcp |
| 상태 및 세션 | status · health · sessions · audit |
| Gateway 및 로그 | gateway · logs · system |
| 모델 및 추론 | models · promos · infer · capability (infer의 별칭) · memory · commitments · wiki |
| 네트워크 및 Node | 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 아래에 격리하고, 기본 Gateway 포트를 19001로 설정하며 파생 포트를 이동 |
--profile <name> |
상태를 ~/.openclaw-<name> 아래에 격리 (OPENCLAW_STATE_DIR/OPENCLAW_CONFIG_PATH) |
--container <name> |
<name>이라는 실행 중인 Podman/Docker 컨테이너 내부에서 CLI 실행(기본값: 환경 변수 OPENCLAW_CONTAINER) |
--log-level <level> |
파일 및 콘솔 출력의 전역 로그 수준 재정의 |
--no-color |
ANSI 색상 비활성화(NO_COLOR=1도 적용됨) |
--update |
openclaw update의 축약형. 소스 체크아웃과 패키지 설치 모두에서 작동 |
-V, --version, -v |
버전을 출력하고 종료 |
출력 모드
- ANSI 색상과 진행률 표시기는 TTY 세션에서만 렌더링됩니다.
- OSC-8 하이퍼링크는 지원되는 환경에서 클릭 가능한 링크로 렌더링되며, 그렇지 않으면 CLI가 일반 URL로 대체합니다.
--json(지원되는 경우--plain도 포함)은 깔끔한 출력을 위해 스타일을 비활성화합니다.- 장시간 실행되는 명령은 진행률 표시기를 표시합니다(지원되는 경우 OSC 9;4).
색상 팔레트
OpenClaw은 CLI 출력에 바닷가재 색상 팔레트를 사용합니다.
| 토큰 | 16진수 | 용도 |
|---|---|---|
accent |
#FF5A2D |
제목, 레이블, 기본 강조 |
accentBright |
#FF7A3D |
명령 이름, 강조 |
accentDim |
#D14A22 |
보조 강조 텍스트 |
info |
#FF8A5B |
정보 값 |
success |
#2FBF71 |
성공 상태 |
warn |
#FFB020 |
경고, 옵션 플래그, 대체 동작 |
error |
#E23D2D |
오류, 실패 |
muted |
#8B7F77 |
약한 강조, 메타데이터 |
팔레트의 기준 소스: packages/terminal-core/src/palette.ts.
명령 트리
전체 명령 트리
이 맵은 핵심 명령과 주요 하위 명령을 다룹니다. Plugin이 추가한
하위 명령(예: skills, plugins, wiki 아래의 명령)은
독립적으로 변경됩니다. 신뢰할 수 있는 최신 목록은 <command> --help를 실행하여 확인하세요.
openclaw [--dev] [--profile <name>] <command>crestodiansetuponboardconfigureconfig get set unset file schema validatecompletiondoctordashboardbackup create verifymigrate list plan <provider> apply <provider>security auditsecrets reload audit configure applyresetuninstallupdate wizard status repairchannels list status capabilities resolve logs add remove login logoutdirectory self peers list groups list|membersskills search install update verify workshop list|inspect|propose-create|propose-update|revise|apply|reject|quarantine list info checkplugins list search inspect install uninstall update enable disable doctor build validate init registry marketplace list|entries|refreshworkboard list create show dispatchmemory status index searchtranscripts list show pathpath resolve find set validate emitcommitments list dismisswiki status doctor init compile lint ingest okf import search get apply synthesis|metadata bridge import unsafe-local import chatgpt import|rollback 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 cleanupaudittasks list audit maintenance show notify cancel flow list|show|cancelgateway call usage-cost health stability diagnostics export 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 scan auth list|add|login|setup-token|paste-token|paste-api-key|login-github-copilot auth order get|set|clearpromos list claim <slug>infer (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|personas|providers|status|enable|disable|set-provider|set-persona video generate|describe|providers web search|fetch|providers embedding create|providerssandbox 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와 제어 UI에 제공자 사용량/할당량이 표시됩니다. 데이터는 제공자의 사용량 엔드포인트에서 직접 가져오며 X% left 형식으로 정규화됩니다. 현재 사용량 기간을 지원하는 제공자는 Anthropic, Gemini CLI, GitHub Copilot, MiniMax, OpenAI Codex, Xiaomi 및 z.ai입니다.
자세한 내용은 사용량 추적을 참조하세요.
관련 항목
Was this useful?