Alat coding
Pengaturan Provider TokenLab
Menghubungkan instance OpenClaw yang di-host sendiri ke TokenLab
Biarkan agen saya yang mengatur ini
Salin tugas ini ke agen yang sudah berjalan di komputer Anda:
Read this guide and help me connect OpenClaw to TokenLab:
https://tokenlab.sh/docs/id/guides/tokenlab-provider
Check my installed version and active configuration first.
Preserve existing accounts, providers, permissions and other settings.
Back up local files and show proposed changes.
Have me enter any API key locally; never ask for, print or paste it in chat.
Check configuration loading first.
Explain any paid request test separately before running it.Panduan ini ditujukan untuk OpenClaw yang di-host sendiri. Plugin TokenLab adalah pengaturan tercepat; konfigurasi manual tersedia jika Anda memerlukan format API tertentu.
Instal plugin
Opsional: instal plugin provider yang dipublikasikan 0.1.3. Berikan TOKENLAB_API_KEY melalui lingkungan Gateway yang sama seperti yang dijelaskan di bawah dan gunakan pemilihan model khusus sesi. Wizard onboarding plugin mengubah model default, jadi panduan ini tidak menjalankan openclaw onboard. Pertahankan entri plugin dan izin yang sudah ada. Periksa plugin dan daftar model yang terinstal sebelum membuat permintaan.
Tinjau kapabilitas yang diminta oleh penginstal dan ikuti perintah konfirmasi klien. Jangan memberikan izin yang tidak relevan atau mengubah izin plugin yang sudah ada.
openclaw plugins install @tokenlabai/openclaw-provider@0.1.3
openclaw plugins list
openclaw models list --provider tokenlab/model tokenlab/claude-sonnet-5 -s
/model default -sKonfigurasi provider secara manual
Gunakan models.providers hanya jika OpenClaw memerlukan format Responses, Claude Messages, Gemini, atau MiniMax secara terpisah. Untuk obrolan biasa, entri tokenlab sudah cukup.
| Provider | OpenClaw api | Terbaik 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 Claude Messages asli | https://api.tokenlab.sh |
tokenlab-gemini | google-generative-ai | Format API Gemini asli | https://api.tokenlab.sh |
tokenlab-minimax | anthropic-messages | Model MiniMax melalui format Messages | https://api.tokenlab.sh |
Gunakan akhiran /v1 hanya untuk openai-completions dan openai-responses.
Provider asli seperti anthropic-messages dan google-generative-ai harus menggunakan https://api.tokenlab.sh tanpa /v1, jika tidak, OpenClaw mungkin membuat jalur provider yang salah.
Prasyarat
- Instance OpenClaw yang di-host sendiri
- Untuk OpenClaw 2026.9.4, gunakan Node.js
>=24.16.0 <25 || >=26.1.0(persyaratan versi). Untuk rilis OpenClaw lainnya, periksa persyaratan rilis tersebut. - TokenLab API Key — Dapatkan di sini
Konfigurasi
Edit konfigurasi OpenClaw Anda:
- Self-hosted:
~/.openclaw/openclaw.json
Tambahkan provider TokenLab di bawah models.providers:
Gunakan profil, OPENCLAW_STATE_DIR, dan OPENCLAW_CONFIG_PATH yang sama dengan Gateway yang sedang berjalan. Cadangkan konfigurasi aktif sebelum menggabungkan. Masukkan TOKENLAB_API_KEY ke dalam .env global tepercaya atau lingkungan layanan instance tersebut; ekspor terminal atau .env proyek saja mungkin tidak menjangkau Gateway latar belakang. Lihat penanganan lingkungan.
Cadangkan konfigurasi aktif. Tambahkan hanya entri TokenLab dan pertahankan provider, akun, pemilihan model default, dan izin yang sudah ada. Jika nama sudah digunakan, pilih nama lain dan perbarui perintahnya. Untuk membatalkan pengaturan, hapus hanya entri yang Anda tambahkan 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-v4-pro", name: "DeepSeek V4 Pro" },
{ 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.6-flash", name: "Gemini 3.6 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 provider menggunakan API Key yang sama. Anda hanya memerlukan satu akun TokenLab.
Array models di atas hanya menampilkan contoh umum. Tambahkan ID model lainnya ke setiap provider sesuai kebutuhan.
Menggunakan Model
OpenClaw tetap mereferensikan model dengan format provider/model:
Untuk OpenClaw 2026.9.4, pilih model hanya untuk sesi saat ini dengan -s. Biarkan agents.defaults.model, default agen, dan izin tidak berubah. Gunakan /model default -s untuk mengembalikan sesi ini ke default yang dikonfigurasi.
/model tokenlab-claude/claude-sonnet-5 -s
/model default -sContoh Model
| Provider | Referensi Model | Deskripsi |
|---|---|---|
tokenlab | tokenlab/gpt-5.6-terra | Kompatibel dengan OpenAI (Chat Completions) |
tokenlab-responses | tokenlab-responses/gpt-5.6-terra | Responses API |
tokenlab-claude | tokenlab-claude/claude-sonnet-5 | Claude Messages |
tokenlab-gemini | tokenlab-gemini/gemini-3.6-flash | Gemini |
tokenlab-minimax | tokenlab-minimax/minimax-m3 | MiniMax melalui Messages |
Telusuri semua model yang tersedia di tokenlab.sh/models.
Kapan Menggunakan Provider yang Mana
tokenlab: pilihan default untuk sebagian besar kasus penggunaan agen dan obrolan tujuan umum.tokenlab-responses: gunakan saat alur kerja OpenClaw Anda secara eksplisit bergantung pada semantik OpenAI Responses.tokenlab-claude: gunakan saat Anda menginginkan perilaku Messages asli dari Claude.tokenlab-gemini: gunakan saat Anda menginginkan pemformatan permintaan/tanggapan asli Gemini atau integrasi gaya Gemini yang sudah ada.tokenlab-minimax: gunakan saat Anda menginginkan model MiniMax melalui format Messages.
Jika Anda tidak memerlukan perilaku asli Gemini, Anda masih dapat memanggil model Gemini melalui tokenlab/gemini-* pada format yang kompatibel dengan OpenAI.
Kesalahan Umum
Verifikasi Pengaturan
Mulai ulang instance tersebut, lalu periksa model dan provider yang dipilih. models status tanpa --probe tidak melakukan pengujian panggilan model. --probe langsung atau pesan obrolan dapat menghabiskan token. Periksa balasan nyata terhadap permintaan TokenLab yang cocok sebelum menyatakan pengaturan berhasil. Untuk memulihkan, pilih model sebelumnya dan hapus hanya entri TokenLab yang Anda tambahkan.
openclaw gateway restart
openclaw models statusMenghasilkan gambar dan video di agen yang sama
OpenClaw juga dapat membuat gambar dan video pendek dengan server MCP TokenLab. Setiap pembuatan dibayar dari saldo TokenLab yang sama.
openclaw mcp add tokenlab \
--command npx \
--arg -y \
--arg @tokenlabai/mcp-server@0.6.48 \
--env TOKENLAB_MCP_TOOL_PROFILE=core \
--env 'TOKENLAB_API_KEY=${TOKENLAB_API_KEY}'
openclaw mcp probe tokenlabPertahankan tanda kutip tunggal. OpenClaw kemudian menyimpan referensi ke variabel, bukan kuncinya, dan membaca TOKENLAB_API_KEY dari lingkungan tempat ia berjalan saat memulai server. Probe mencantumkan alat TokenLab. Kemudian coba:
Call get_model_pricing for nano-banana-2, then use create_image with nano-banana-2 at 1k to make a photo of a matte black coffee mug on a white desk.create_video mengembalikan ID tugas. Agen memanggil get_task_status sampai video siap.
Langkah Selanjutnya
Setelah OpenClaw terhubung, panduan ini membantu Anda menggunakan TokenLab dengan lebih efektif:
- Format API — pahami perbedaan antara rute OpenAI, Responses, Anthropic, dan Gemini
- Kompatibilitas IDE / SDK — lihat kapan
/v1/responseslebih cocok digunakan - Penanganan Kesalahan — pelajari mode kegagalan umum dan pola pemulihan
- Ikhtisar Model — telusuri ID model sebelum menghubungkannya ke agen