OpenClaw
구성 가이드6 분 소요

OpenClaw 구성 베이스라인: '안전하고 사용 가능한' 템플릿

Model/Gateway/Channel/Skills에 대한 최소 구성 예제. 보안 기본값과 복사하여 붙여넣기 가능한 스니펫 포함.

O

OpenClaw Guides

Tutorial Authors

최소 구성

검증된 최소 구성 템플릿(보안 기본값 포함):

json
// ~/.openclaw/openclaw.json
{
  "model": {
    "provider": "anthropic",
    "default": "claude-3-5-sonnet",
    "apiKey": "${ANTHROPIC_API_KEY}"
  },
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1"
  },
  "channels": [
    { "type": "whatsapp", "enabled": false },
    { "type": "telegram", "enabled": false },
    { "type": "discord", "enabled": false }
  ],
  "security": {
    "rateLimiting": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    }
  }
}

구성 섹션 설명

모델 구성

json
{
  "model": {
    "provider": "anthropic",
    "default": "claude-3-5-sonnet",
    "apiKey": "${ANTHROPIC_API_KEY}"
  }
}

사용 가능한 모델:

  • claude-3-5-haiku - 빠르고 비용 효율적 ($0.25/1M 입력, $1.25/1M 출력)
  • claude-3-5-sonnet - 균형 잡힌 성능 ($3/1M 입력, $15/1M 출력)
  • claude-sonnet-4 - 최신 세대, 최고 품질 ($3/1M 입력, $15/1M 출력)

Gateway 구성

json
{
  "gateway": {
    "port": 18789,
    "host": "127.0.0.1",
    "timeout": 30000
  }
}

보안 참고: 적절한 방화벽 규칙이 없다면 host를 0.0.0.0으로 설정하지 마세요.

채널 구성

각 채널은 독립적으로 구성할 수 있습니다:

json
{
  "channels": [
    {
      "type": "whatsapp",
      "enabled": true,
      "sessionPath": "~/.openclaw/whatsapp-session"
    },
    {
      "type": "telegram",
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}"
    },
    {
      "type": "discord",
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "intents": ["GUILDS", "GUILD_MESSAGES", "MESSAGE_CONTENT"]
    }
  ]
}

보안 구성

json
{
  "security": {
    "rateLimiting": {
      "enabled": true,
      "maxRequests": 100,
      "windowMs": 60000
    },
    "quotas": {
      "daily": {
        "enabled": true,
        "maxTokens": 100000
      }
    }
  }
}

환경 변수

OpenClaw 디렉토리에 .env 파일 생성:

bash
# ~/.openclaw/.env
ANTHROPIC_API_KEY=sk-ant-xxxxx
TELEGRAM_BOT_TOKEN=123456:ABC-xxxxx
DISCORD_BOT_TOKEN=xxxxx.xxxxx.xxxxx

검증

구성 검증:

bash
openclaw config validate

다음을 확인합니다:

  • 필수 필드
  • 유효한 API 키
  • 올바른 형식

다음 단계