跳轉到主要內容

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.

本指南適用於希望將 LemonData 作為 AI 提供者連接的 自我部署(self-hosted)OpenClaw 使用者。

概覽

對於目前的 OpenClaw 版本,建議的做法是透過 models.providers 來配置 LemonData。 如果您只是想快速開始,僅設定 lemondata 即足夠。僅在您明確需要 Responses APIClaude nativeGemini nativeMiniMax native 行為時才新增其他提供者。
ProviderOpenClaw api適用於baseUrl
lemondataopenai-completions適用於 GPT、DeepSeek、Qwen 以及大多數與 OpenAI 相容的呼叫https://api.lemondata.cc/v1
lemondata-responsesopenai-responses期望 /v1/responses 語意的 OpenAI Responses 工作流程https://api.lemondata.cc/v1
lemondata-claudeanthropic-messages原生 Claude Messages APIhttps://api.lemondata.cc
lemondata-geminigoogle-generative-ai原生 Gemini API 格式https://api.lemondata.cc
lemondata-minimaxanthropic-messages原生 MiniMax 路由https://api.lemondata.cc
僅對 openai-completionsopenai-responses 使用 /v1 後綴。anthropic-messagesgoogle-generative-ai 這類原生提供者應使用 https://api.lemondata.cc(不要加 /v1),否則 OpenClaw 可能會組成錯誤的上游路徑。

前置需求

  • 一個自我部署的 OpenClaw 實例
  • 一個 LemonData API Key — 在這裡取得

設定

編輯您的 OpenClaw 設定檔:
  • 自我部署: ~/.openclaw/openclaw.json
models.providers 下新增 LemonData 提供者:
{
  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 個提供者使用相同的 API Key。您只需要一個 LemonData 帳戶。
上面 models 陣列僅顯示常見範例。視需要為每個提供者新增更多模型 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 瀏覽所有可用模型。

何時使用哪個提供者

  • lemondata: 大多數通用代理與聊天使用情境的預設選擇。
  • lemondata-responses: 當您的 OpenClaw 工作流程明確依賴 OpenAI Responses 語意時使用。
  • lemondata-claude: 當您想要 Claude 的原生 Messages 行為時使用。
  • lemondata-gemini: 當您需要 Gemini 原生的請求/回應格式或已有 Gemini 風格的整合時使用。
  • lemondata-minimax: 當您想要透過 MiniMax 的原生路由時使用。
如果您不需要 Gemini 原生行為,仍然可以透過 OpenAI 相容路由使用 lemondata/gemini-* 呼叫 Gemini 模型。

常見錯誤

目前的 OpenClaw 文件使用 models.providers。如果您保留舊的頂層 providers 陣列格式,OpenClaw 可能會忽略該設定或無法如預期解析提供者前綴。
openai-responses 映射到 LemonData 的 /v1/responses 路徑,因此 lemondata-responses 必須使用 https://api.lemondata.cc/v1
anthropic-messagesgoogle-generative-ai 應使用 https://api.lemondata.cc(不要加 /v1)。加上 /v1 會產生不正確的請求路徑。
支援。現行 OpenClaw 文件仍包含內建的 google 提供者,並且也支援使用 api: "google-generative-ai" 的自訂提供者。因此 lemondata-gemini 對於 OpenClaw 使用者來說仍然是有效的原生 Gemini 路由。

驗證設定

儲存設定後,重新啟動您的 OpenClaw 實例並用簡單訊息測試。如果您看到回應,表示提供者已正確配置。
# Self-hosted: restart the service
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

下一步

一旦 OpenClaw 已連線,以下指南可協助您更有效地使用 LemonData:
  • API 格式 — 了解 OpenAI、Responses、Anthropic 與 Gemini 路由之間的差異
  • IDE / SDK 相容性 — 了解何時使用 /v1/responses 較為適合
  • 錯誤處理 — 學習常見失敗模式與復原策略
  • 模型總覽 — 在將模型接入代理前先瀏覽模型 ID