CLI commands
CLI 참조
openclaw는 기본 CLI 진입점입니다. 각 핵심 명령에는 전용 참조 페이지가 있거나 별칭으로 연결되는 명령과 함께 문서화되어 있습니다. 이 색인은 CLI 전반에 적용되는 명령, 전역 플래그, 출력 스타일 규칙을 나열합니다.
명령 페이지
| 영역 | 명령 |
|---|---|
| 설정 및 온보딩 | 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 |
| 네트워크 및 Node | 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 (선택 사항) | 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.
명령 트리
전체 명령 트리
openclaw [--dev] [--profile <name>] <command>
crestodian
setup
onboard
configure
config
get
set
unset
file
schema
validate
completion
doctor
dashboard
backup
create
verify
security
audit
secrets
reload
audit
configure
apply
reset
uninstall
update
wizard
status
channels
list
status
capabilities
resolve
logs
add
remove
login
logout
directory
self
peers list
groups list|members
skills
search
install
update
list
info
check
plugins
list
inspect
install
uninstall
update
enable
disable
doctor
marketplace list
memory
status
index
search
commitments
list
dismiss
wiki
status
doctor
init
ingest
compile
lint
search
get
apply
bridge import
unsafe-local import
obsidian status|search|open|command|daily
message
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
ban
agent
agents
list
add
delete
bindings
bind
unbind
set-identity
acp
mcp
serve
list
show
set
unset
status
health
sessions
cleanup
tasks
list
audit
maintenance
show
notify
cancel
flow list|show|cancel
gateway
call
usage-cost
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
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|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|clear
sandbox
list
recreate
explain
cron
status
list
add
edit
rm
enable
disable
runs
run
nodes
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 get
devices
list
remove
clear
approve
reject
rotate
revoke
node
run
status
install
uninstall
stop
restart
approvals
get
set
allowlist add|remove
exec-policy
show
preset
set
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
proxy
start
run
coverage
sessions
query
blob
purge
pairing
list
approve
qr
clawbot
qr
docs
dns
setup
tui
chat (alias: tui --local)
terminal (alias: tui --local)
Plugin은 추가 최상위 명령을 추가할 수 있습니다(예: 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.
자세한 내용은 사용량 추적을 참조하세요.