메인 콘텐츠로 건너뛰기
이 가이드는 LemonData를 AI provider로 연결하려는 셀프 호스팅 OpenClaw 사용자를 위한 문서입니다.
호스팅된 구성을 원한다면 LemonClaw 인스턴스를 생성하세요. LemonData는 기본으로 이미 구성되어 있으므로 WebUI에서 바로 시작할 수 있습니다.

​
개요

현재 OpenClaw 버전에서는 LemonData를 models.providers로 설정하는 방식이 권장됩니다. 빠르게 시작만 하고 싶다면 lemondata 하나만으로도 충분합니다. Responses API, Claude 네이티브, Gemini 네이티브, MiniMax 네이티브 동작이 필요할 때만 나머지 provider를 추가하세요.
ProviderOpenClaw api적합한 용도baseUrl
lemondataopenai-completionsGPT, DeepSeek, Qwen 및 대부분의 OpenAI 호환 호출https://api.lemondata.cc/v1
lemondata-responsesopenai-responses/v1/responses 의미 체계를 기대하는 OpenAI Responses 워크플로https://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesClaude의 네이티브 Messages APIhttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiGemini의 네이티브 API 형식https://api.lemondata.cc
lemondata-minimaxanthropic-messagesMiniMax 네이티브 경로https://api.lemondata.cc
/v1 접미사는 openai-completions와 openai-responses에만 사용하세요.anthropic-messages, google-generative-ai 같은 네이티브 provider는 /v1 없이 https://api.lemondata.cc를 사용해야 합니다. 그렇지 않으면 OpenClaw가 잘못된 upstream 경로를 만들 수 있습니다.

​
사전 준비

​
설정

OpenClaw 설정 파일을 수정하세요.
  • 셀프 호스팅: ~/.openclaw/openclaw.json
LemonData provider를 models.providers 아래에 추가하세요. 
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      lemondata: {
        api: "openai-completions",
        baseUrl: "https://api.lemondata.cc/v1",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-32b", name: "Qwen 3 32B" }
        ]
      },
      "lemondata-responses": {
        api: "openai-responses",
        baseUrl: "https://api.lemondata.cc/v1",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "lemondata-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.lemondata.cc",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "lemondata-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.lemondata.cc",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "gemini-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "lemondata-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.lemondata.cc",
        apiKey: "sk-your-lemondata-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
5개의 provider는 모두 같은 API Key를 사용합니다. LemonData 계정 하나만 있으면 됩니다.
위의 models 배열은 대표적인 예시만 보여 줍니다. 필요에 따라 각 provider에 다른 model ID를 추가하세요.

​
모델 사용하기

OpenClaw는 계속해서 provider/model 형식으로 모델을 참조합니다. 
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
모델 예시

Provider모델 참조설명
lemondatalemondata/gpt-4oOpenAI 호환 경로
lemondatalemondata/deepseek-r1DeepSeek 추론 모델
lemondata-responseslemondata-responses/gpt-4oResponses API 경로
lemondata-claudelemondata-claude/claude-sonnet-4-6Claude Messages 네이티브 경로
lemondata-geminilemondata-gemini/gemini-2.5-flashGemini 네이티브 경로
lemondata-minimaxlemondata-minimax/minimax-m1MiniMax 네이티브 경로
사용 가능한 모든 모델은 lemondata.cc/models에서 확인할 수 있습니다.

​
어떤 provider를 언제 써야 하나요?

  • lemondata: 대부분의 일반적인 채팅 및 agent 시나리오를 위한 기본 선택입니다.
  • lemondata-responses: OpenClaw 워크플로가 OpenAI Responses 의미 체계에 명확히 의존할 때 사용합니다.
  • lemondata-claude: Claude Messages의 네이티브 동작이 필요할 때 사용합니다.
  • lemondata-gemini: Gemini 네이티브 형식이나 Gemini용 기존 통합이 필요할 때 사용합니다.
  • lemondata-minimax: MiniMax를 네이티브 경로로 사용하고 싶을 때 사용합니다.
Gemini의 네이티브 동작이 필요 없다면 lemondata/gemini-*를 사용해 OpenAI 호환 경로에서 Gemini 모델을 계속 호출할 수 있습니다.

​
자주 하는 실수

현재 OpenClaw 문서는 models.providers를 기준으로 합니다. 예전 top-level providers 형식을 그대로 유지하면 OpenClaw가 설정을 무시하거나 provider prefix를 제대로 해석하지 못할 수 있습니다.
openai-responses는 LemonData의 /v1/responses 경로를 사용하므로 lemondata-responses는 반드시 https://api.lemondata.cc/v1를 사용해야 합니다.
anthropic-messages와 google-generative-ai는 /v1 없이 https://api.lemondata.cc를 사용해야 합니다. /v1를 붙이면 잘못된 요청 경로가 만들어질 수 있습니다.
네. 현재 OpenClaw 문서에는 여전히 내장 google provider가 있고, api: "google-generative-ai"를 사용하는 커스텀 provider도 지원합니다. 따라서 lemondata-gemini는 OpenClaw 사용자에게 여전히 유효한 Gemini 네이티브 경로입니다.

​
설정 확인

설정을 저장한 뒤 OpenClaw 인스턴스를 재시작하고 간단한 메시지로 테스트하세요. 응답이 오면 provider 설정이 올바르게 완료된 것입니다. 
# 셀프 호스팅: 서비스 재시작
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

​
다음 단계

OpenClaw를 연결한 뒤에는 다음 가이드를 참고하면 LemonData를 더 잘 활용할 수 있습니다.
  • API Formats — OpenAI, Responses, Anthropic, Gemini 경로 차이를 이해하기
  • IDE / SDK Compatibility — /v1/responses가 더 적합한 경우 보기
  • Error Handling — 자주 발생하는 실패 유형과 복구 방법 익히기
  • 모델 개요 — agent에 연결하기 전에 사용 가능한 model ID 확인하기