跳转到主要内容
本指南适用于希望将 LemonData 作为 AI Provider 接入的 OpenClaw 自托管用户。
如果你更想直接使用托管方案,可以创建一个 LemonClaw 实例;托管版默认已配置好 LemonData,可直接在 WebUI 中开始使用。

概览

针对当前 OpenClaw 版本,推荐通过 models.providers 配置 LemonData 自定义 provider。 如果你只想先跑起来,至少配置 lemondata 即可;如果还需要 Responses APIClaude 原生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-completionsopenai-responsesanthropic-messagesgoogle-generative-ai 这类原生 provider 不要带 /v1,否则很容易拼出错误路径。

前置条件

  • 一个自托管 OpenClaw 实例
  • 一个 LemonData API Key — 在此获取

配置

编辑您的 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 的 models 数组里追加即可。

使用模型

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 API
lemondata-geminilemondata-gemini/gemini-2.5-flashGemini 原生 API 路径
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 兼容路径。

常见错误

当前 OpenClaw 官方文档已以 models.providers 为准。如果你还在用旧的顶层 providers 数组,通常会出现 provider 不生效、模型前缀无法识别,或配置被 OpenClaw 忽略的问题。
openai-responses 走的是 LemonData 的 /v1/responses 路径,所以 lemondata-responsesbaseUrl 必须写成 https://api.lemondata.cc/v1
anthropic-messagesgoogle-generative-ai 都应该使用 https://api.lemondata.cc,不要带 /v1。否则会导致 OpenClaw 拼接出的实际请求路径错误。
支持。当前 OpenClaw 官方配置参考仍保留内置 google provider,同时也支持自定义 provider 使用 api: "google-generative-ai"。所以接 LemonData 时,lemondata-gemini 这条原生 Gemini 路径仍然是成立的,并不是“不支持了”。

验证配置

保存配置后,重启 OpenClaw 实例,并发送一条简单消息进行测试。如果能正常收到响应,说明 provider 已配置成功。
# 自托管:重启服务
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

下一步

接好 OpenClaw 后,建议继续阅读这些文档,更好地使用 LemonData: