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
스킬 관리
skill - 스킬 관리
# 설치된 스킬 목록
openclaw skill list
# 스킬 설치
openclaw skill install <skill-name>
# 스킬 제거
openclaw skill remove <skill-name>
# 스킬 업데이트
openclaw skill update <skill-name>
# 스킬 검색
openclaw skill search <keyword>
로그 및 디버깅
logs - 로그 확인
# 최근 로그
openclaw logs
# 실시간 로그 보기
openclaw logs --follow
# 특정 레벨 필터링
openclaw logs --level error
# 로그 파일 경로
openclaw logs --path
debug - 디버깅 모드
# 디버그 모드로 시작
openclaw --debug gateway start
# 상세 로그
openclaw --verbose logs
환경 변수
필수 환경 변수
| 변수 | 설명 | 예시 |
|---|---|---|
OPENCLAW_API_KEY |
API 인증 키 | sk-... |
OPENCLAW_WORKSPACE |
워크스페이스 경로 | ~/.openclaw/workspace |
선택적 환경 변수
| 변수 | 설명 | 기본값 |
|---|---|---|
OPENCLAW_CONFIG |
설정 파일 경로 | ~/.openclaw/openclaw.json |
OPENCLAW_LOG_LEVEL |
로그 레벨 | info |
OPENCLAW_TIMEOUT |
요청 타임아웃 (초) | 30 |
자주 사용하는 명령 조합
빠른 시작
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
종료 코드
| 코드 | 의미 | 일반적인 원인 |
|---|---|---|
| 0 | 성공 | - |
| 1 | 일반 오류 | 설정 파일 오류, 권한 문제 |
| 2 | 사용자 오류 | 잘못된 인자, 부족한 인자 |
| 127 | 명령을 찾을 수 없음 | 설치되지 않음 |
팁
생산성 향상
별칭(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
주의사항
- Root 권한 없이 실행: OpenClaw는 사용자 권한으로 실행됩니다.
sudo를 사용하지 마세요. - 백그라운드 실행: 서버 환경에서는
systemd서비스로 실행을 권장합니다. - 다중 인스턴스: 동일 시스템에서 여러 Gateway 실행은 지원하지 않습니다. 이미 실행 중인 경우
openclaw gateway restart를 사용하세요.
참고: