CLI 명령어 참조

OpenClaw의 모든 CLI 명령어를 빠르게 찾아보세요.

개요

CLI 사용법

# 기본 형식
openclaw [command] [options] [arguments]

# 도움말
openclaw --help
openclaw [command] --help

주요 명령어

Gateway 관리

gateway - 게이트웨이 제어

# Gateway 시작
openclaw gateway start

# Gateway 중지
openclaw gateway stop

# Gateway 상태 확인
openclaw gateway status

# Gateway 재시작
openclaw gateway restart

상태 출력 예시:

Gateway Status: Running
PID: 12345
Uptime: 2 hours 30 minutes
Channels: 3 active (Slack, Telegram, Discord)

채널 관리

channel - 채널 관리

# 채널 목록
openclaw channel list

# 채널 추가
openclaw channel add --type slack --token "xoxb-..."

# 채널 제거
openclaw channel remove --type slack

# 채널 활성화/비활성화
openclaw channel enable --type telegram
openclaw channel disable --type discord

설정 관리

config - 설정 관리

# 설정 조회
openclaw config get

# 특정 설정 조회
openclaw config get channels.slack.enabled

# 설정 변경
openclaw config set agents.model "claude-sonnet-4-20250514"

# 설정 삭제
openclaw config delete channels.slack.enabled

# 설정 편집기
openclaw config edit

설정 파일 경로:

• Linux/macOS: ~/.openclaw/openclaw.json
• Windows: %USERPROFILE%\.openclaw\openclaw.json

세션 관리

session - 세션 관리

# 활성 세션 목록
openclaw session list

# 세션 정보
openclaw session info <session-id>

# 세션 삭제
openclaw session delete <session-id>

# 모든 세션 삭제
openclaw session clear

워크스페이스 관리

workspace - 워크스페이스 관리

# 워크스페이스 경로 확인
openclaw workspace path

# 워크스페이스 정리
openclaw workspace clean

# 워크스페이스 백업
openclaw workspace backup

스킬 관리

skills - 스킬 관리 (v2026.3.22 업데이트)

v2026.3.22부터 skills 명령이 ClawHub 네이티브 검색·설치·업데이트 플로우를 지원합니다:

# 스킬 검색 (ClawHub)
openclaw skills search <keyword>

# 스킬 설치
openclaw skills install <skill-name>

# 스킬 업데이트
openclaw skills update <skill-name>

# 설치된 스킬 목록
openclaw skill list

로그 및 디버깅

logs - 로그 확인

# 최근 로그
openclaw logs

# 실시간 로그 보기
openclaw logs --follow

# 특정 레벨 필터링
openclaw logs --level error

# 로그 파일 경로
openclaw logs --path

debug - 디버깅 모드

# 디버그 모드로 시작
openclaw --debug gateway start

# 상세 로그
openclaw --verbose logs

환경 변수

필수 환경 변수

선택적 환경 변수

자주 사용하는 명령 조합

빠른 시작

openclaw gateway start && openclaw logs --follow

설정 후 재시작

openclaw gateway restart

문제 해결

openclaw gateway status
openclaw logs --level error --follow

청소

openclaw gateway stop
openclaw session clear
openclaw workspace clean

종료 코드

팁

생산성 향상

별칭(Alias) 설정:

# ~/.bashrc 또는 ~/.zshrc
alias og='openclaw'
alias og-start='openclaw gateway start'
alias og-stop='openclaw gateway stop'
alias og-logs='openclaw logs --follow'

Shell 자동완성:

openclaw completion >> ~/.zshrc
source ~/.zshrc

주의사항

1. Root 권한 없이 실행: OpenClaw는 사용자 권한으로 실행됩니다. sudo를 사용하지 마세요.
2. 백그라운드 실행: 서버 환경에서는 systemd 서비스로 실행을 권장합니다.
3. 다중 인스턴스: 동일 시스템에서 여러 Gateway 실행은 지원하지 않습니다. 이미 실행 중인 경우 openclaw gateway restart를 사용하세요.

신규 명령어 (2026.3 ~ 2026.4)

infer — 추론 워크플로우 허브 (v2026.4.7)

provider 기반 추론 워크플로우를 위한 통합 허브입니다. 모델, 미디어, 웹, 임베딩 작업을 지원합니다:

openclaw infer model "질문을 입력하세요"
openclaw infer audio providers --json

exec-policy — 실행 정책 관리 (v2026.4.12)

로컬 exec 허가 파일과 tools.exec.* 설정을 동기화하는 명령어입니다:

# 현재 exec 정책 확인
openclaw exec-policy show

# 정책 프리셋 적용
openclaw exec-policy preset <preset-name>

# 정책 직접 설정
openclaw exec-policy set <key> <value>

flows — Task Flow 관리 (v2026.3.31)

백그라운드 Task Flow를 조회·취소하는 명령어입니다:

# Task Flow 목록
openclaw flows list

# Task Flow 상세 보기
openclaw flows show <flow-id>

# Task Flow 취소
openclaw flows cancel <flow-id>

--container 옵션 (v2026.3.24)

실행 중인 Docker 또는 Podman OpenClaw 컨테이너 내에서 명령을 실행합니다 (#52651):

# 컨테이너 내에서 실행
openclaw --container gateway status
openclaw --container logs --follow

# 환경 변수로도 지정 가능
OPENCLAW_CONTAINER=my-openclaw-container openclaw gateway status

/btw — 사이드 질문 (v2026.3.22)

현재 세션 컨텍스트를 변경하지 않고 빠른 답변을 얻는 채팅 명령어입니다. TUI에서는 in-session 답변으로 표시되고, 외부 채널에서는 명시적 BTW 응답으로 전송됩니다.

참고:

• 공식 CLI 문서