Langsung ke konten utama
Panduan ini ditujukan untuk pengguna OpenClaw self-hosted yang ingin menghubungkan LemonData sebagai provider AI.
Jika kamu lebih suka solusi terkelola, buat instance LemonClaw. LemonData sudah dikonfigurasi secara default, jadi kamu bisa langsung mulai dari WebUI.

Ringkasan

Pada versi OpenClaw saat ini, cara yang direkomendasikan untuk menghubungkan LemonData adalah melalui models.providers. Jika kamu hanya ingin cepat mulai, lemondata saja sudah cukup. Tambahkan provider lain hanya saat kamu membutuhkan Responses API, Claude native, Gemini native, atau MiniMax native.
Providerapi OpenClawCocok untukbaseUrl
lemondataopenai-completionsGPT, DeepSeek, Qwen, dan sebagian besar panggilan yang kompatibel dengan OpenAIhttps://api.lemondata.cc/v1
lemondata-responsesopenai-responsesWorkflow OpenAI Responses yang mengharapkan semantik /v1/responseshttps://api.lemondata.cc/v1
lemondata-claudeanthropic-messagesAPI Messages native Claudehttps://api.lemondata.cc
lemondata-geminigoogle-generative-aiFormat API Gemini nativehttps://api.lemondata.cc
lemondata-minimaxanthropic-messagesRute native MiniMaxhttps://api.lemondata.cc
Gunakan sufiks /v1 hanya untuk openai-completions dan openai-responses.Provider native seperti anthropic-messages dan google-generative-ai harus memakai https://api.lemondata.cc tanpa /v1; jika tidak, OpenClaw bisa membentuk path upstream yang salah.

Prasyarat

  • Satu instance OpenClaw self-hosted
  • Satu LemonData API Key — dapatkan di sini

Konfigurasi

Edit konfigurasi OpenClaw milikmu:
  • Self-hosted: ~/.openclaw/openclaw.json
Tambahkan provider LemonData di dalam 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" }
        ]
      }
    }
  }
}
Kelima provider memakai API Key yang sama. Kamu hanya butuh satu akun LemonData.
Array models di atas hanya menunjukkan contoh umum. Tambahkan model ID lain ke tiap provider sesuai kebutuhan.

Menggunakan model

OpenClaw tetap menggunakan format provider/model untuk mereferensikan model:
{
  agents: {
    defaults: {
      model: {
        primary: "lemondata-gemini/gemini-2.5-flash"
      }
    }
  }
}

Contoh model

ProviderReferensi modelDeskripsi
lemondatalemondata/gpt-4oRute kompatibel OpenAI
lemondatalemondata/deepseek-r1Model reasoning DeepSeek
lemondata-responseslemondata-responses/gpt-4oRute Responses API
lemondata-claudelemondata-claude/claude-sonnet-4-6Rute native Claude Messages
lemondata-geminilemondata-gemini/gemini-2.5-flashRute native Gemini
lemondata-minimaxlemondata-minimax/minimax-m1Rute native MiniMax
Lihat semua model yang tersedia di lemondata.cc/models.

Kapan memakai provider tertentu

  • lemondata: pilihan default untuk sebagian besar use case chat dan agent umum.
  • lemondata-responses: gunakan saat workflow OpenClaw kamu secara eksplisit bergantung pada semantik OpenAI Responses.
  • lemondata-claude: gunakan saat kamu ingin perilaku native Claude Messages.
  • lemondata-gemini: gunakan saat kamu ingin format native Gemini atau integrasi yang sudah dirancang untuk Gemini.
  • lemondata-minimax: gunakan saat kamu ingin MiniMax melalui rute native-nya.
Jika kamu tidak membutuhkan perilaku native Gemini, kamu tetap bisa memanggil model Gemini lewat lemondata/gemini-* pada rute yang kompatibel dengan OpenAI.

Kesalahan umum

Dokumentasi OpenClaw saat ini menggunakan models.providers. Jika kamu tetap memakai format lama dengan providers di level teratas, OpenClaw bisa mengabaikan konfigurasi tersebut atau gagal mengenali prefix provider dengan benar.
openai-responses mengarah ke path /v1/responses milik LemonData, jadi lemondata-responses harus memakai https://api.lemondata.cc/v1.
anthropic-messages dan google-generative-ai harus memakai https://api.lemondata.cc tanpa /v1. Menambahkan /v1 bisa menghasilkan path request yang salah.
Ya. Dokumentasi OpenClaw saat ini masih mencantumkan provider bawaan google dan juga mendukung provider kustom dengan api: "google-generative-ai". Jadi lemondata-gemini tetap merupakan rute Gemini native yang valid untuk pengguna OpenClaw.

Verifikasi konfigurasi

Setelah menyimpan konfigurasi, restart instance OpenClaw kamu dan uji dengan pesan sederhana. Jika muncul respons, berarti provider sudah dikonfigurasi dengan benar.
# Self-hosted: restart service
systemctl --user restart openclaw    # Linux
launchctl stop cc.lemondata.openclaw && launchctl start cc.lemondata.openclaw  # macOS

Langkah berikutnya

Setelah OpenClaw terhubung, panduan berikut akan membantu kamu menggunakan LemonData dengan lebih baik: