설정 우선순위
OpenClaw의 설정 소스는 다음 우선순위로 적용됩니다 (높은 순서부터):
- 명령줄 파라미터
- 환경 변수
.env파일- 사용자 설정 파일 (
~/.openclaw/config.json) - 기본값
환경 변수 명명 규칙
모든 환경 변수는 OPENCLAW_ 접두사를 사용합니다:
OPENCLAW_PORT=3000
OPENCLAW_HOST=0.0.0.0
OPENCLAW_OPENAI_API_KEY=sk-your-key
OPENCLAW_LOG_LEVEL=info
다중 환경 설정
openclaw start --env-file .env.development
openclaw start --env-file .env.production
조건부 설정
{
"models": {
"main": {
"provider": "openai",
"model": "{{OPENCLAW_DEFAULT_MODEL|gpt-4o-mini}}"
}
}
}
{{VAR|default}} 문법은 기본값을 지원합니다.
설정 핫 리로드
openclaw reload
핫 리로드 가능: 모델 파라미터, 시스템 프롬프트, 로그 수준, 속도 제한 재시작 필요: Gateway 포트/주소, 채널 추가/삭제, 공급자 추가/삭제
설정 디버그
openclaw configure --dump
openclaw configure --trace gateway.port
보안 주의사항
.env파일을 Git에 커밋하지 마세요- 키 관리에는 secrets를 사용하세요
- 설정 파일 권한을 제한하세요:
chmod 600 ~/.openclaw/config.json - 프로덕션 환경에서는 debug 레벨 로그를 피하세요
정리
OpenClaw의 설정 시스템은 다양한 소스와 유연한 우선순위 메커니즘을 지원합니다. 환경 변수, 설정 파일, secrets 시스템을 적절히 활용하면 개발, 테스트, 프로덕션 환경 간 설정을 안전하게 관리할 수 있습니다.