Gateway 설정 완전 레퍼런스

개요

이 문서는 OpenClaw Gateway 설정의 완전한 레퍼런스로, 사용 가능한 모든 설정 항목과 기본값, 유형, 사용 설명을 다룹니다.

설정 파일 위치

~/.openclaw/config.json

환경 변수로 지정할 수도 있습니다:

export OPENCLAW_CONFIG="/path/to/config.json"

Gateway 핵심 설정

{
  "gateway": {
    "host": "0.0.0.0",
    "port": 3000,
    "baseUrl": "https://your-domain.com",
    "corsOrigins": ["*"],
    "maxRequestSize": "10mb",
    "timeout": 120000
  }
}

Provider 설정

{
  "providers": {
    "provider-name": {
      "type": "openai",
      "baseUrl": "https://api.openai.com/v1",
      "apiKey": "{{ENV_VAR_NAME}}",
      "models": ["gpt-4o"],
      "timeout": 30000,
      "retries": 3
    }
  }
}

Model 설정

{
  "models": {
    "model-alias": {
      "provider": "provider-name",
      "model": "actual-model-id",
      "temperature": 0.7,
      "maxTokens": 4096,
      "fallback": null
    }
  }
}

Channel 설정

{
  "channels": {
    "channel-name": {
      "type": "telegram",
      "model": "model-alias",
      "systemPrompt": "당신은 유용한 어시스턴트입니다.",
      "historyLimit": 20,
      "tools": ["web_search", "code_exec"]
    }
  }
}

Security 설정

{
  "security": {
    "allowlist": {"enabled": false, "users": []},
    "rateLimit": {"global": {"maxRequests": 100, "window": 60}},
    "contentFilter": {"enabled": false},
    "audit": {"enabled": true}
  }
}

Logging 설정

{
  "logging": {
    "level": "info",
    "format": "json",
    "file": "~/.openclaw/logs/gateway.log",
    "maxSize": "50m",
    "maxFiles": 5
  }
}

환경 변수 참조

설정 파일에서 환경 변수를 참조할 수 있습니다:

{
  "providers": {
    "openai": {
      "apiKey": "{{OPENAI_API_KEY}}"
    }
  }
}

정리

이 레퍼런스는 Gateway의 모든 핵심 설정 항목을 다룹니다. 설정 변경 후에는 항상 openclaw configure --validate를 실행하여 검증하고, 설정 오류로 인한 서비스 장애를 방지하세요.