설정 가이드

📄 설정 파일 위치

OpenClaw의 메인 설정 파일은 다음 위치에 있어요:

~/.openclaw/openclaw.json

여기서 ~는 여러분의 사용자 홈 디렉토리를 의미해요. 예를 들어 macOS에서는 전체 경로가 보통 /Users/사용자이름/.openclaw/openclaw.json이에요.

⚙️ 주요 설정 항목

설정 파일에서 가장 자주 사용하는 설정 항목을 소개할게요:

AI 모델 선택

기본으로 사용할 AI 모델을 설정하세요:

{
  "model": {
    "provider": "anthropic",
    "name": "claude-sonnet-4-20250514",
    "api_key": "sk-ant-..."
  }
}

provider를 "openai", "deepseek", 또는 "google"로 변경하고, 해당 모델 이름과 API 키를 입력하면 돼요.

세션 관리

AI 대화의 동작을 제어하세요:

{
  "session": {
    "max_history": 50,
    "timeout_minutes": 30,
    "system_prompt": "당신은 유용한 AI 비서입니다..."
  }
}

• max_history — 각 대화에서 최대 몇 개의 메시지 기록을 유지할지
• timeout_minutes — 몇 분 동안 대화가 없으면 자동으로 새 대화를 시작할지
• system_prompt — AI의 "캐릭터 설정"으로, AI의 성격을 커스터마이징할 수 있어요

채널 설정

각 채팅 플랫폼의 연결 정보를 설정하세요:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "bot_token": "123456:ABC-DEF..."
    },
    "discord": {
      "enabled": true,
      "bot_token": "MTIz..."
    }
  }
}

🔄 핫 리로드

OpenClaw는 핫 리로드(Hot Reload)를 지원해요. 이것은 설정 파일을 수정한 후, OpenClaw를 재시작할 필요 없이 자동으로 변경 사항을 감지하고 새 설정을 적용한다는 뜻이에요.

간단히 말하면: 설정 파일을 편집하고 저장하기만 하면, OpenClaw가 자동으로 새 설정으로 실행돼요. 정말 편리하죠!