참조 (Reference)
OpenClaw의 전체 설정, CLI 명령어, 환경 변수에 대한 빠른 참조입니다.
섹션 개요
| 문서 | 내용 |
|---|---|
| CLI 명령어 | 모든 CLI 명령어 |
| Configuration | 설정 파일 참조 |
| 환경 변수 | 환경 변수 목록 |
빠른 참조
CLI 명령어
# 게이트웨이
openclaw gateway start
openclaw gateway stop
openclaw gateway status
# 설정
openclaw config get
openclaw config set <key> <value>
openclaw config edit
# 로그
openclaw logs --follow
openclaw logs --level error
설정 파일
{
"channels": {
"<channel>": {
"enabled": true
}
},
"agents": {
"default": {
"model": "claude-sonnet-4-20250514"
}
}
}
환경 변수
export OPENCLAW_API_KEY="sk-..."
export OPENCLAW_WORKSPACE="~/.openclaw/workspace"
export OPENCLAW_LOG_LEVEL="debug"
상세 참조
CLI 명령어
- Gateway 관리: 시작, 중지, 상태, 재시작
- 채널 관리: 추가, 제거, 활성화
- 설정 관리: 조회, 변경, 편집
- 세션 관리: 목록, 정보, 삭제
- 워크스페이스: 경로, 정리, 백업
- 스킬 관리: 목록, 설치, 제거
- 로그: 확인, 필터링, 경로
Configuration
- 채널 설정: 각 채널별 필드
- 에이전트 설정: 모델, 라우팅
- 자동화: Heartbeat, Cron, 트리거
- 메모리: 세션, 기록 제한
- 보안: API 키, 권한
- 고급: 서브 에이전트, 멀티 모델
환경 변수
- 연결: API 키, URL, 포트
- 워크스페이스: 경로, 설정 파일
- 로깅: 레벨, 파일 경로
- 네트워크: 호스트, 포트, 타임아웃
- 채널별: 각 채널의 환경 변수
- AI 모델: API 키별 모델
자주 사용하는 명령
빠른 시작
openclaw gateway start && openclaw logs --follow
설정 후 재시작
openclaw gateway restart
문제 해결
openclaw gateway status
openclaw logs --level error --follow
청소
openclaw session clear
openclaw workspace clean
설정 계층 구조
openclaw.json
├── channels # 채널 설정
│ ├── telegram
│ ├── slack
│ └── ...
├── agents # 에이전트 설정
│ ├── default
│ └── ...
├── automation # 자동화
│ ├── heartbeat
│ ├── cron
│ └── triggers
├── memory # 메모리
│ ├── sessions
│ └── ...
├── security # 보안
│ └── ...
└── advanced # 고급
├── agents
├── models
└── ...
트러블슈팅
설정 오류
# 설정 검증
openclaw config validate
# JSON 구문 확인
cat ~/.openclaw/openclaw.json | jq .
명령을 찾을 수 없음
# 재설치
curl -sSL https://install.openclaw.ai | sh
# 또는
npm install -g @openclaw/cli
자주 묻는 질문
Q: 설정 파일을 수동으로 편집할 수 있나요?
A: ~/.openclaw/openclaw.json을 직접 편집하거나 openclaw config edit를 사용하세요.
Q: 환경 변수가 설정 파일보다 우선하나요?
A: 우선순위: 환경 변수 > 설정 파일 > 기본값
Q: CLI 자동완성을 사용할 수 있나요?
A: openclaw completion을 셸 설정에 추가하세요.
참고: