Chuyển đến nội dung chính

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.

Hướng dẫn này dành cho người dùng self-hosted OpenClaw muốn kết nối LemonData làm provider AI của họ.

​
Tổng quan

Đối với các phiên bản OpenClaw hiện tại, cách khuyến nghị là cấu hình LemonData qua models.providers. Nếu bạn chỉ muốn bắt đầu nhanh, chỉ cần cấu hình lemondata là đủ. Chỉ thêm các provider khác khi bạn thực sự cần hành vi Responses API, Claude native, Gemini native, hoặc MiniMax native.
Nhà cung cấpOpenClaw apiPhù hợp chobaseUrl
lemondataopenai-completionsGPT, DeepSeek, Qwen, và hầu hết các gọi tương thích OpenAIhttps://api.lemondata.cc/v1
lemondata-responsesopenai-responsesCác luồng công việc OpenAI Responses mong đợi ngữ nghĩa /v1/responseshttps://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesAPI Messages gốc của Claudehttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiĐịnh dạng API Gemini gốchttps://api.lemondata.cc
lemondata-minimaxanthropic-messagesĐiều hướng MiniMax gốchttps://api.lemondata.cc
Use the /v1 suffix only for openai-completions and openai-responses.Native providers such as anthropic-messages and google-generative-ai should use https://api.lemondata.cc without /v1, otherwise OpenClaw may construct the wrong upstream path.

​
Yêu cầu tiên quyết

  • Một instance OpenClaw self-hosted
  • Một LemonData API Key — Get one here

​
Cấu hình

Edit your OpenClaw config:
  • Self-hosted: ~/.openclaw/openclaw.json
Add LemonData providers under 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" }
        ]
      }
    }
  }
}
All 5 providers use the same API Key. You only need one LemonData account.
The models arrays above only show common examples. Add more model IDs to each provider as needed.

​
Sử dụng Models

OpenClaw vẫn tham chiếu các model theo định dạng provider/model: 
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-gemini/gemini-2.5-flash"
      }
    }
  }
}

​
Ví dụ Model

Nhà cung cấpTham chiếu modelMô tả
lemondatalemondata/gpt-4oRoute tương thích OpenAI
lemondatalemondata/deepseek-r1Mô hình suy luận DeepSeek
lemondata-responseslemondata-responses/gpt-4oRoute Responses API
lemondata-claudelemondata-claude/claude-sonnet-4-6Route Messages gốc của Claude
lemondata-geminilemondata-gemini/gemini-2.5-flashRoute Gemini gốc
lemondata-minimaxlemondata-minimax/minimax-m1Route MiniMax gốc
Browse all available models at lemondata.cc/models.

​
Khi nào sử dụng provider nào

  • lemondata: lựa chọn mặc định cho hầu hết các trường hợp sử dụng agent và chat đa dụng.
  • lemondata-responses: dùng khi luồng công việc OpenClaw của bạn phụ thuộc rõ ràng vào ngữ nghĩa OpenAI Responses.
  • lemondata-claude: dùng khi bạn muốn hành vi Messages gốc của Claude.
  • lemondata-gemini: dùng khi bạn cần định dạng yêu cầu/đáp trả gốc của Gemini hoặc tích hợp theo kiểu Gemini hiện có.
  • lemondata-minimax: dùng khi bạn muốn MiniMax theo route gốc của nó.
Nếu bạn không cần hành vi Gemini-gốc, bạn vẫn có thể gọi các model Gemini thông qua lemondata/gemini-* trên route tương thích OpenAI.

​
Những lỗi phổ biến

Tài liệu OpenClaw hiện tại sử dụng models.providers. Nếu bạn giữ định dạng mảng providers cấp cao cũ, OpenClaw có thể bỏ qua cấu hình hoặc không thể giải quyết tiền tố provider như mong đợi.
openai-responses ánh xạ đến đường dẫn /v1/responses của LemonData, nên lemondata-responses phải sử dụng https://api.lemondata.cc/v1.
anthropic-messages và google-generative-ai nên sử dụng https://api.lemondata.cc mà không có /v1. Thêm /v1 có thể tạo ra các đường dẫn yêu cầu không chính xác.
Có. Tài liệu OpenClaw hiện tại vẫn bao gồm provider tích hợp sẵn google và cũng hỗ trợ các provider tùy chỉnh sử dụng api: "google-generative-ai". Vì vậy lemondata-gemini vẫn là một route Gemini gốc hợp lệ cho người dùng OpenClaw.

​
Xác minh cấu hình

Sau khi lưu cấu hình, khởi động lại instance OpenClaw của bạn và thử với một tin nhắn đơn giản. Nếu bạn nhận được phản hồi, provider đã được cấu hình chính xác. 
# Self-hosted: restart the service
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

​
Bước tiếp theo

Khi OpenClaw đã kết nối, các hướng dẫn sau sẽ giúp bạn sử dụng LemonData hiệu quả hơn:
  • API Formats — hiểu sự khác nhau giữa các route OpenAI, Responses, Anthropic và Gemini
  • IDE / SDK Compatibility — xem khi nào /v1/responses là lựa chọn phù hợp hơn
  • Error Handling — tìm hiểu các chế độ thất bại phổ biến và các mẫu phục hồi
  • Models Overview — duyệt các ID model trước khi kết nối chúng vào agents