Saltar para o conteúdo principal

Documentation Index

Fetch the complete documentation index at: https://docs.lemondata.cc/llms.txt

Use this file to discover all available pages before exploring further.

Este guia é para usuários do OpenClaw self-hosted que desejam conectar o LemonData como seu provedor de IA.

Visão geral

Para as versões atuais do OpenClaw, a abordagem recomendada é configurar o LemonData através de models.providers. Se você só quer começar rapidamente, configurar apenas lemondata já é suficiente. Adicione os outros provedores somente quando precisar explicitamente do comportamento Responses API, Claude nativo, Gemini nativo ou MiniMax nativo.
ProvedorOpenClaw apiIndicado parabaseUrl
lemondataopenai-completionsGPT, DeepSeek, Qwen e a maioria das chamadas compatíveis com OpenAIhttps://api.lemondata.cc/v1
lemondata-responsesopenai-responsesFluxos de trabalho OpenAI Responses que esperam a semântica /v1/responseshttps://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesAPI nativa Claude Messageshttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiFormato nativo da API Geminihttps://api.lemondata.cc
lemondata-minimaxanthropic-messagesRoteamento nativo MiniMaxhttps://api.lemondata.cc
Use o sufixo /v1 somente para openai-completions e openai-responses.Provedores nativos como anthropic-messages e google-generative-ai devem usar https://api.lemondata.cc sem /v1, caso contrário o OpenClaw pode construir um caminho upstream incorreto.

Pré-requisitos

  • Uma instância OpenClaw self-hosted
  • Uma API Key do LemonData — Obtenha uma aqui

Configuração

Edite sua configuração do OpenClaw:
  • Self-hosted: ~/.openclaw/openclaw.json
Adicione os provedores LemonData em 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" }
        ]
      }
    }
  }
}
Todos os 5 provedores usam a mesma API Key. Você precisa de apenas uma conta LemonData.
Os arrays models acima mostram apenas exemplos comuns. Adicione mais IDs de modelo a cada provedor conforme necessário.

Usando Modelos

O OpenClaw continua referenciando modelos no formato provider/model:
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-gemini/gemini-2.5-flash"
      }
    }
  }
}

Exemplos de Modelos

ProvedorReferência do modeloDescrição
lemondatalemondata/gpt-4oRota compatível com OpenAI
lemondatalemondata/deepseek-r1Modelo de raciocínio DeepSeek
lemondata-responseslemondata-responses/gpt-4oRota Responses API
lemondata-claudelemondata-claude/claude-sonnet-4-6Rota nativa Claude Messages
lemondata-geminilemondata-gemini/gemini-2.5-flashRota nativa Gemini
lemondata-minimaxlemondata-minimax/minimax-m1Rota nativa MiniMax
Consulte todos os modelos disponíveis em lemondata.cc/models.

Quando usar cada provedor

  • lemondata: escolha padrão para a maioria dos casos de uso gerais de agentes e chat.
  • lemondata-responses: use quando seu fluxo no OpenClaw depender explicitamente da semântica do OpenAI Responses.
  • lemondata-claude: use quando você quiser o comportamento nativo de Claude Messages.
  • lemondata-gemini: use quando você quiser formatação de requisição/resposta nativa do Gemini ou integrações já existentes no estilo Gemini.
  • lemondata-minimax: use quando quiser o MiniMax em sua rota nativa.
Se você não precisa do comportamento nativo do Gemini, ainda pode chamar modelos Gemini através de lemondata/gemini-* pela rota compatível com OpenAI.

Erros comuns

A documentação atual do OpenClaw usa models.providers. Se você mantiver o formato antigo providers no nível superior, o OpenClaw pode ignorar a configuração ou falhar ao resolver os prefixos dos provedores como esperado.
openai-responses mapeia para o caminho /v1/responses do LemonData, então lemondata-responses deve usar https://api.lemondata.cc/v1.
anthropic-messages e google-generative-ai devem usar https://api.lemondata.cc sem /v1. Adicionar /v1 pode gerar caminhos de requisição incorretos.
Sim. A documentação atual do OpenClaw ainda inclui o provedor interno google e também suporta provedores personalizados usando api: "google-generative-ai". Portanto, lemondata-gemini continua sendo uma rota Gemini nativa válida para usuários do OpenClaw.

Verificar a configuração

Após salvar a configuração, reinicie sua instância OpenClaw e teste com uma mensagem simples. Se você receber uma resposta, o provedor está configurado corretamente.
# Self-hosted: restart the service
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

Próximos passos

Depois que o OpenClaw estiver conectado, estes guias ajudam você a usar o LemonData de forma mais eficaz: