Chuyển đến nội dung chính
Hướng dẫn này dành cho người dùng OpenClaw tự lưu trữ muốn kết nối LemonData làm provider AI.
Nếu bạn muốn dùng giải pháp được lưu trữ sẵn, hãy tạo một instance LemonClaw. LemonData đã được cấu hình mặc định, vì vậy bạn có thể bắt đầu ngay trong WebUI.

​
Tổng quan

Với các phiên bản OpenClaw hiện tại, cách được khuyến nghị để kết nối LemonData là cấu hình qua models.providers. Nếu bạn chỉ muốn bắt đầu nhanh, chỉ cần lemondata là đủ. Chỉ thêm các provider khác khi bạn cần Responses API, Claude native, Gemini native hoặc MiniMax native.
Providerapi của OpenClawPhù hợp chobaseUrl
lemondataopenai-completionsGPT, DeepSeek, Qwen và hầu hết các lời gọi tương thích OpenAIhttps://api.lemondata.cc/v1
lemondata-responsesopenai-responsesWorkflow OpenAI Responses cần ngữ nghĩa /v1/responseshttps://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesAPI Messages native của Claudehttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiĐịnh dạng API Gemini nativehttps://api.lemondata.cc
lemondata-minimaxanthropic-messagesTuyến MiniMax nativehttps://api.lemondata.cc
Chỉ dùng hậu tố /v1 với openai-completions và openai-responses.Các provider native như anthropic-messages và google-generative-ai phải dùng https://api.lemondata.cc không có /v1; nếu không, OpenClaw có thể tạo sai đường dẫn upstream.

​
Điều kiện tiên quyết

  • Một instance OpenClaw tự lưu trữ
  • Một LemonData API Key — lấy tại đây

​
Cấu hình

Chỉnh sửa cấu hình OpenClaw của bạn:
  • Tự lưu trữ: ~/.openclaw/openclaw.json
Thêm các provider LemonData vào trong 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" }
        ]
      }
    }
  }
}
Cả 5 provider đều dùng cùng một API Key. Bạn chỉ cần một tài khoản LemonData.
Các mảng models phía trên chỉ là ví dụ phổ biến. Hãy thêm model ID khác vào từng provider khi cần.

​
Sử dụng model

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

​
Ví dụ model

ProviderTham chiếu modelMô tả
lemondatalemondata/gpt-4oTuyến tương thích OpenAI
lemondatalemondata/deepseek-r1Model suy luận DeepSeek
lemondata-responseslemondata-responses/gpt-4oTuyến Responses API
lemondata-claudelemondata-claude/claude-sonnet-4-6Tuyến native Claude Messages
lemondata-geminilemondata-gemini/gemini-2.5-flashTuyến native Gemini
lemondata-minimaxlemondata-minimax/minimax-m1Tuyến native MiniMax
Xem tất cả model khả dụng tại lemondata.cc/models.

​
Khi nào nên dùng từng provider

  • lemondata: lựa chọn mặc định cho hầu hết các trường hợp chat và agent phổ thông.
  • lemondata-responses: dùng khi workflow 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 native của Claude Messages.
  • lemondata-gemini: dùng khi bạn muốn định dạng native của Gemini hoặc các tích hợp vốn đã dành cho Gemini.
  • lemondata-minimax: dùng khi bạn muốn MiniMax trên tuyến native của nó.
Nếu bạn không cần hành vi native của Gemini, bạn vẫn có thể gọi model Gemini qua lemondata/gemini-* trên tuyến tương thích OpenAI.

​
Lỗi thường gặp

Tài liệu OpenClaw hiện tại dùng models.providers. Nếu bạn vẫn giữ định dạng cũ với providers ở cấp cao nhất, OpenClaw có thể bỏ qua cấu hình hoặc không nhận diện đúng prefix của provider.
openai-responses trỏ tới đường dẫn /v1/responses của LemonData, vì vậy lemondata-responses phải dùng https://api.lemondata.cc/v1.
anthropic-messages và google-generative-ai phải dùng https://api.lemondata.cc không có /v1. Việc thêm /v1 có thể tạo ra đường dẫn request sai.
Có. Tài liệu OpenClaw hiện tại vẫn có provider tích hợp google và cũng hỗ trợ provider tùy chỉnh với api: "google-generative-ai". Vì vậy lemondata-gemini vẫn là một tuyến Gemini native hợp lệ cho người dùng OpenClaw.

​
Xác minh cấu hình

Sau khi lưu cấu hình, hãy khởi động lại instance OpenClaw của bạn và thử bằng một tin nhắn đơn giản. Nếu nhận được phản hồi, provider đã được cấu hình đúng. 
# Tự lưu trữ: khởi động lại dịch vụ
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

​
Bước tiếp theo

Sau khi kết nối OpenClaw, các hướng dẫn sau sẽ giúp bạn dùng LemonData hiệu quả hơn:
  • API Formats — hiểu sự khác biệt giữa các tuyến OpenAI, Responses, Anthropic và Gemini
  • IDE / SDK Compatibility — xem khi nào /v1/responses phù hợp hơn
  • Error Handling — tìm hiểu các lỗi phổ biến và cách khôi phục
  • Tổng quan model — xem model ID khả dụng trước khi gắn chúng vào agent