本指南适用于希望将 LemonData 作为 AI Provider 接入的 OpenClaw 自托管用户。
概览
针对当前 OpenClaw 版本,推荐通过models.providers 配置 LemonData 自定义 provider。
如果你只想先跑起来,至少配置 lemondata 即可;如果还需要 Responses API、Claude 原生、Gemini 原生 或 MiniMax 原生 路径,再继续补对应 provider。
| Provider | OpenClaw api | 适用场景 | baseUrl |
|---|---|---|---|
lemondata | openai-completions | GPT、DeepSeek、Qwen 以及大多数 OpenAI 兼容调用 | https://api.lemondata.cc/v1 |
lemondata-responses | openai-responses | 需要 /v1/responses 语义的 OpenAI Responses 工作流 | https://api.lemondata.cc/v1 |
lemondata-claude | anthropic-messages | Claude 原生 Messages API | https://api.lemondata.cc |
lemondata-gemini | google-generative-ai | Gemini 原生 API 格式 | https://api.lemondata.cc |
lemondata-minimax | anthropic-messages | MiniMax 原生路径 | https://api.lemondata.cc |
前置条件
- 一个自托管 OpenClaw 实例
- 一个 LemonData API Key — 在此获取
配置
编辑您的 OpenClaw 配置文件:- 自托管:
~/.openclaw/openclaw.json
models.providers 中:
这 5 个 provider 使用的是 同一个 API Key。你只需要一个 LemonData 账户。
上面的
models 数组只列了常用示例。需要更多模型时,按相同格式继续往对应 provider 的 models 数组里追加即可。使用模型
OpenClaw 中仍然使用provider/model 格式引用模型:
模型示例
| Provider | 模型引用 | 说明 |
|---|---|---|
lemondata | lemondata/gpt-4o | OpenAI 兼容路径 |
lemondata | lemondata/deepseek-r1 | DeepSeek 推理模型 |
lemondata-responses | lemondata-responses/gpt-4o | Responses API 路径 |
lemondata-claude | lemondata-claude/claude-sonnet-4-6 | Claude 原生 Messages API |
lemondata-gemini | lemondata-gemini/gemini-2.5-flash | Gemini 原生 API 路径 |
lemondata-minimax | lemondata-minimax/minimax-m1 | MiniMax 原生路径 |
什么时候用哪个 provider?
lemondata:默认首选,兼容性最好,适合大多数通用对话和 agent 场景。lemondata-responses:当你的 OpenClaw 工作流明确依赖 OpenAI Responses 语义时使用。lemondata-claude:当你需要 Claude 的原生 Messages 行为时使用。lemondata-gemini:当你需要 Gemini 原生请求/响应格式,或想沿用 Gemini 生态的调用方式时使用。lemondata-minimax:当你需要 MiniMax 的原生路径时使用。
lemondata/gemini-* 走 OpenAI 兼容路径。
常见错误
还在使用旧的 providers 数组写法
还在使用旧的 providers 数组写法
当前 OpenClaw 官方文档已以
models.providers 为准。如果你还在用旧的顶层 providers 数组,通常会出现 provider 不生效、模型前缀无法识别,或配置被 OpenClaw 忽略的问题。lemondata-responses 忘记带 /v1
lemondata-responses 忘记带 /v1
openai-responses 走的是 LemonData 的 /v1/responses 路径,所以 lemondata-responses 的 baseUrl 必须写成 https://api.lemondata.cc/v1。lemondata-claude / lemondata-gemini / lemondata-minimax 错误带上了 /v1
lemondata-claude / lemondata-gemini / lemondata-minimax 错误带上了 /v1
anthropic-messages 和 google-generative-ai 都应该使用 https://api.lemondata.cc,不要带 /v1。否则会导致 OpenClaw 拼接出的实际请求路径错误。OpenClaw 现在还支持 Gemini 原生吗?
OpenClaw 现在还支持 Gemini 原生吗?
支持。当前 OpenClaw 官方配置参考仍保留内置
google provider,同时也支持自定义 provider 使用 api: "google-generative-ai"。所以接 LemonData 时,lemondata-gemini 这条原生 Gemini 路径仍然是成立的,并不是“不支持了”。验证配置
保存配置后,重启 OpenClaw 实例,并发送一条简单消息进行测试。如果能正常收到响应,说明 provider 已配置成功。下一步
接好 OpenClaw 后,建议继续阅读这些文档,更好地使用 LemonData:- 多格式 API — 理解 OpenAI、Responses、Anthropic、Gemini 的接口差异
- IDE / SDK 兼容性 — 了解什么时候该用
/v1/responses - Error Handling — 熟悉常见错误及恢复方式
- 模型总览 — 在把模型接入 agent 前先查看可用模型 ID