Alat coding
Penyiapan Penyedia TokenLab
Konfigurasikan TokenLab sebagai penyedia kustom di OpenClaw menggunakan rute yang kompatibel dengan OpenAI, Responses, Anthropic, dan Gemini
Serahkan pengaturan kepada agen saya
Salin tugas ini ke agen yang sudah berfungsi di komputer Anda:
Baca panduan ini dan bantu saya menghubungkan OpenClaw ke TokenLab:
https://tokenlab.sh/docs/id/guides/tokenlab-provider
Periksa terlebih dahulu versi yang terpasang dan konfigurasi yang aktif.
Pertahankan akun, penyedia, izin, dan pengaturan lain yang sudah ada.
Cadangkan file lokal dan tampilkan perubahan yang diusulkan.
Biarkan saya memasukkan kunci API yang diperlukan secara lokal; jangan pernah meminta, menampilkan, atau menempelkannya di chat.
Periksa terlebih dahulu apakah konfigurasi dapat dimuat.
Jelaskan secara terpisah biaya setiap pengujian yang mengirim permintaan berbayar sebelum menjalankannya.Panduan ini ditujukan untuk pengguna self-hosted OpenClaw yang ingin menghubungkan TokenLab sebagai penyedia AI mereka.
Disarankan: instal plugin
Opsional: pasang plugin penyedia 0.1.0 yang telah dirilis. Sediakan TOKENLAB_API_KEY melalui lingkungan Gateway yang dijelaskan di bawah dan pilih model hanya untuk sesi. Wizard onboarding mengubah model default, jadi panduan ini tidak menjalankan openclaw onboard. Pertahankan plugin dan izin yang ada; periksa pemuatan plugin dan daftar model sebelum mengirim permintaan.
Tinjau kapabilitas yang diminta penginstal dan ikuti konfirmasi klien. Jangan berikan izin yang tidak terkait atau ubah izin plugin yang sudah ada.
openclaw plugins install @tokenlabai/openclaw-provider@0.1.0
openclaw plugins list
openclaw models list --provider tokenlab/model tokenlab/claude-sonnet-5 -s
/model default -sKonfigurasi penyedia manual
Gunakan entri models.providers manual di bawah hanya saat Anda secara eksplisit membutuhkan rute terpisah untuk Responses API, Claude native, Gemini native, atau MiniMax native.
Jika Anda memilih konfigurasi manual, mengonfigurasi tokenlab saja sudah cukup. Tambahkan penyedia lain hanya ketika Anda secara eksplisit membutuhkan perilaku Responses API, Claude native, Gemini native, atau MiniMax native.
| Penyedia | OpenClaw api | Cocok untuk | baseUrl |
|---|---|---|---|
tokenlab | openai-completions | GPT, DeepSeek, Qwen, dan sebagian besar panggilan yang kompatibel dengan OpenAI | https://api.tokenlab.sh/v1 |
tokenlab-responses | openai-responses | Alur kerja OpenAI Responses yang mengharapkan semantik /v1/responses | https://api.tokenlab.sh/v1 |
tokenlab-claude | anthropic-messages | API Pesan Claude Native | https://api.tokenlab.sh |
tokenlab-gemini | google-generative-ai | Format API Gemini native | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | Routing MiniMax native | https://api.tokenlab.sh |
Gunakan sufiks /v1 hanya untuk openai-completions dan openai-responses.
Penyedia native seperti anthropic-messages dan google-generative-ai harus menggunakan https://api.tokenlab.sh tanpa /v1, jika tidak OpenClaw mungkin menyusun path upstream yang salah.
Prasyarat
- Instance OpenClaw self-hosted
- OpenClaw 2026.9.4 memerlukan Node.js
>=24.16.0 <25 || >=26.1.0(persyaratan versi). Untuk rilis OpenClaw lainnya, periksa persyaratan rilis tersebut. - Kunci API TokenLab — Dapatkan satu di sini
Konfigurasi
Edit konfigurasi OpenClaw Anda:
- Hosting sendiri:
~/.openclaw/openclaw.json
Tambahkan penyedia TokenLab di bawah models.providers:
Gunakan profil, OPENCLAW_STATE_DIR, dan OPENCLAW_CONFIG_PATH yang sama dengan Gateway aktif, lalu cadangkan konfigurasi. Simpan TOKENLAB_API_KEY di .env global tepercaya atau lingkungan layanan instansi itu. Export terminal atau .env proyek mungkin tidak diteruskan ke proses latar. Lihat lingkungan.
Cadangkan konfigurasi aktif. Tambahkan hanya entri TokenLab dan pertahankan penyedia, akun, model default, serta izin yang ada. Jika namanya sudah dipakai, pilih nama lain dan sesuaikan perintah. Untuk membatalkan, hapus hanya entri tambahan atau pulihkan cadangan sebelumnya.
{
models: {
mode: "merge",
providers: {
tokenlab: {
api: "openai-completions",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "gpt-5.6-terra", name: "GPT-5.6 Terra" },
{ id: "deepseek-reasoner", name: "DeepSeek Reasoner" },
{ id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
]
},
"tokenlab-responses": {
api: "openai-responses",
baseUrl: "https://api.tokenlab.sh/v1",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "gpt-5.6-terra", name: "GPT-5.6 Terra (Responses)" },
{ id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
]
},
"tokenlab-claude": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "claude-sonnet-5", name: "Claude Sonnet 5" },
{ id: "claude-opus-5", name: "Claude Opus 5" }
]
},
"tokenlab-gemini": {
api: "google-generative-ai",
baseUrl: "https://api.tokenlab.sh",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "gemini-3.5-flash", name: "Gemini 3.5 Flash" },
{ id: "gemini-2.5-pro", name: "Gemini 2.5 Pro" }
]
},
"tokenlab-minimax": {
api: "anthropic-messages",
baseUrl: "https://api.tokenlab.sh",
apiKey: "${TOKENLAB_API_KEY}",
models: [
{ id: "minimax-m3", name: "MiniMax M3" }
]
}
}
}
}Kelima penyedia menggunakan API Key yang sama. Anda hanya membutuhkan satu akun TokenLab.
Array models di atas hanya menampilkan contoh umum. Tambahkan lebih banyak ID model ke masing-masing penyedia sesuai kebutuhan.
Menggunakan Model
OpenClaw masih merujuk model dengan format provider/model:
Pada OpenClaw 2026.9.4, pilih model hanya untuk sesi saat ini dengan -s. Pertahankan agents.defaults.model, default agen, dan izin. Gunakan /model default -s untuk mengembalikan sesi ini ke model default.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sContoh Model
| Penyedia | Referensi model | Deskripsi |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | Rute yang kompatibel dengan OpenAI |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | Rute Responses API |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Rute native Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.5-flash | Rute native Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | Rute native MiniMax |
Telusuri semua model yang tersedia di tokenlab.sh/models.
Kapan Menggunakan Penyedia Mana
tokenlab: pilihan default untuk sebagian besar kasus penggunaan agen dan obrolan umum.tokenlab-responses: gunakan ketika alur kerja OpenClaw Anda secara eksplisit bergantung pada semantik OpenAI Responses.tokenlab-claude: gunakan ketika Anda menginginkan perilaku Messages native Claude.tokenlab-gemini: gunakan ketika Anda menginginkan pemformatan permintaan/respon native Gemini atau integrasi bergaya Gemini yang sudah ada.tokenlab-minimax: gunakan ketika Anda menginginkan MiniMax melalui rute native-nya.
Jika Anda tidak memerlukan perilaku Gemini-native, Anda masih dapat memanggil model Gemini melalui tokenlab/gemini-* pada rute yang kompatibel dengan OpenAI.
Kesalahan Umum
Verifikasi Pengaturan
Mulai ulang instansi yang sama dan periksa model serta penyedia. models status tanpa --probe bukan uji panggilan model. Probe langsung dan pesan dapat memakai token. Cocokkan balasan dengan catatan TokenLab. Untuk memulihkan, pilih model lama dan hapus hanya entri tambahan.
openclaw gateway restart
openclaw models statusLangkah Selanjutnya
Setelah OpenClaw tersambung, panduan berikut membantu Anda menggunakan TokenLab dengan lebih efektif:
- Format API — pahami perbedaan antara rute OpenAI, Responses, Anthropic, dan Gemini
- IDE / SDK Compatibility — lihat kapan
/v1/responsesadalah pilihan yang lebih cocok - Penanganan error — pelajari mode kegagalan umum dan pola pemulihan
- Ringkasan model — telusuri ID model sebelum menghubungkannya ke agen