Panduan ini ditujukan untuk pengguna OpenClaw self-hosted yang ingin menghubungkan LemonData sebagai provider AI.
Ringkasan
Pada versi OpenClaw saat ini, cara yang direkomendasikan untuk menghubungkan LemonData adalah melaluimodels.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.
| Provider | api OpenClaw | Cocok untuk | baseUrl |
|---|---|---|---|
lemondata | openai-completions | GPT, DeepSeek, Qwen, dan sebagian besar panggilan yang kompatibel dengan OpenAI | https://api.lemondata.cc/v1 |
lemondata-responses | openai-responses | Workflow OpenAI Responses yang mengharapkan semantik /v1/responses | https://api.lemondata.cc/v1 |
lemondata-claude | anthropic-messages | API Messages native Claude | https://api.lemondata.cc |
lemondata-gemini | google-generative-ai | Format API Gemini native | https://api.lemondata.cc |
lemondata-minimax | anthropic-messages | Rute native MiniMax | https://api.lemondata.cc |
Prasyarat
- Satu instance OpenClaw self-hosted
- Satu LemonData API Key — dapatkan di sini
Konfigurasi
Edit konfigurasi OpenClaw milikmu:- Self-hosted:
~/.openclaw/openclaw.json
models.providers:
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 formatprovider/model untuk mereferensikan model:
Contoh model
| Provider | Referensi model | Deskripsi |
|---|---|---|
lemondata | lemondata/gpt-4o | Rute kompatibel OpenAI |
lemondata | lemondata/deepseek-r1 | Model reasoning DeepSeek |
lemondata-responses | lemondata-responses/gpt-4o | Rute Responses API |
lemondata-claude | lemondata-claude/claude-sonnet-4-6 | Rute native Claude Messages |
lemondata-gemini | lemondata-gemini/gemini-2.5-flash | Rute native Gemini |
lemondata-minimax | lemondata-minimax/minimax-m1 | Rute native MiniMax |
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.
lemondata/gemini-* pada rute yang kompatibel dengan OpenAI.
Kesalahan umum
Masih memakai array providers lama di level teratas
Masih memakai array providers lama di level teratas
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.Lupa menambahkan /v1 pada lemondata-responses
Lupa menambahkan /v1 pada lemondata-responses
openai-responses mengarah ke path /v1/responses milik LemonData, jadi lemondata-responses harus memakai https://api.lemondata.cc/v1.Menambahkan /v1 ke lemondata-claude, lemondata-gemini, atau lemondata-minimax
Menambahkan /v1 ke lemondata-claude, lemondata-gemini, atau lemondata-minimax
anthropic-messages dan google-generative-ai harus memakai https://api.lemondata.cc tanpa /v1. Menambahkan /v1 bisa menghasilkan path request yang salah.Apakah OpenClaw masih mendukung Gemini native?
Apakah OpenClaw masih mendukung Gemini native?
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.Langkah berikutnya
Setelah OpenClaw terhubung, panduan berikut akan membantu kamu menggunakan LemonData dengan lebih baik:- API Formats — pahami perbedaan antara rute OpenAI, Responses, Anthropic, dan Gemini
- IDE / SDK Compatibility — lihat kapan
/v1/responseslebih cocok digunakan - Error Handling — pelajari kegagalan umum dan cara pemulihannya
- Ringkasan model — cek model ID yang tersedia sebelum menghubungkannya ke agent