openclaw configure 설정 마법사 튜토리얼

명령 개요

openclaw configure는 OpenClaw의 설정 관리 명령으로, 대화형 수정, 가져오기/내보내기, 설정 검증을 지원합니다.

대화형 설정

openclaw configure

대화형 설정 메뉴가 시작됩니다:

OpenClaw Configuration
======================

What would you like to configure?
  [1] Providers (Model providers)
  [2] Models (Model settings)
  [3] Channels (Messaging channels)
  [4] Skills (AI skills and tools)
  [5] Security (Auth and access control)
  [6] Gateway (Server settings)
  [7] Logging (Log settings)
  [0] Exit

>

현재 설정 조회

# 전체 설정 표시 (민감 정보 마스킹)
openclaw configure --show

# 특정 섹션 표시
openclaw configure --show providers
openclaw configure --show channels
openclaw configure --show models

출력 예시:

{
  "providers": {
    "openai": {
      "type": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "sk-****...****",
      "models": ["gpt-4o", "gpt-4o-mini"]
    }
  }
}

설정 항목 직접 변경

대화형 모드에 진입하지 않고 직접 설정을 수정합니다:

# Gateway 포트 설정
openclaw configure set gateway.port 3001

# 모델 온도 설정
openclaw configure set models.main.temperature 0.8

# 채널 시스템 프롬프트 설정
openclaw configure set channels.telegram.systemPrompt "당신은 유용한 어시스턴트입니다"

설정 항목 읽기

openclaw configure get gateway.port
# 출력: 3000

openclaw configure get providers.openai.baseUrl
# 출력: https://api.openai.com/v1

설정 검증

openclaw configure --validate

출력:

Validating configuration...
  ✓ JSON syntax: valid
  ✓ Required fields: present
  ✓ Provider references: valid
  ✓ Model references: valid
  ⚠ Warning: Channel "slack" references undefined model "slack-model"
  ✓ Security settings: valid

Validation result: 1 warning, 0 errors

가져오기/내보내기

설정 내보내기

# 전체 설정 내보내기 (키 값 제외)
openclaw configure --export config-backup.json

# 키 포함 전체 설정 내보내기 (암호화)
openclaw configure --export config-full.enc --include-secrets

설정 가져오기

# 파일에서 가져오기
openclaw configure --import config-backup.json

# 병합 가져오기 (로컬 기존 설정 유지)
openclaw configure --import config-backup.json --merge

설정 차이 비교

# 현재 설정과 파일 비교
openclaw configure --diff config-old.json

출력:

- "gateway.port": 3000
+ "gateway.port": 3001

+ "providers.anthropic": { ... }

- "models.main.temperature": 0.7
+ "models.main.temperature": 0.8

설정 초기화

# 특정 섹션 초기화
openclaw configure --reset providers

# 전체 설정을 기본값으로 초기화
openclaw configure --reset-all

환경 변수 오버라이드

설정 파일의 값을 환경 변수로 덮어쓸 수 있습니다:

# 포트 오버라이드
OPENCLAW_GATEWAY_PORT=3001 openclaw start

# 모델 오버라이드
OPENCLAW_DEFAULT_MODEL=gpt-4o-mini openclaw start

환경 변수 명명 규칙: OPENCLAW_ + 설정 경로 대문자 + _로 연결

설정 파일 형식

OpenClaw은 JSON과 YAML 형식의 설정 파일을 지원합니다:

# YAML 형식 사용
openclaw configure --format yaml --export config.yaml

일괄 수정

JSON Patch를 사용한 일괄 수정:

openclaw configure --patch '[
  {"op": "replace", "path": "/gateway/port", "value": 3001},
  {"op": "add", "path": "/models/new-model", "value": {"provider": "openai", "model": "gpt-4o"}}
]'

설정 이력

OpenClaw은 설정 수정 이력을 보존합니다:

# 수정 이력 조회
openclaw configure --history

# 이전 버전으로 롤백
openclaw configure --rollback 3

정리

openclaw configure는 OpenClaw 설정을 관리하는 핵심 도구입니다. 대화형 수정이든 스크립트 기반 일괄 작업이든 유연하게 대응할 수 있습니다. 중요한 수정 전에 --export로 백업하고, 수정 후에는 --validate로 검증하는 것을 권장합니다.