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 -s

npm · GitHub

Konfigurasi 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.

PenyediaOpenClaw apiCocok untukbaseUrl
tokenlabopenai-completionsGPT, DeepSeek, Qwen, dan sebagian besar panggilan yang kompatibel dengan OpenAIhttps://api.tokenlab.sh/v1
tokenlab-responsesopenai-responsesAlur kerja OpenAI Responses yang mengharapkan semantik /v1/responseshttps://api.tokenlab.sh/v1
tokenlab-claudeanthropic-messagesAPI Pesan Claude Nativehttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiFormat API Gemini nativehttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesRouting MiniMax nativehttps://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 -s

Contoh Model

PenyediaReferensi modelDeskripsi
tokenlabtokenlab/gpt-5.6-terraRute yang kompatibel dengan OpenAI
tokenlab-responsestokenlab-responses/gpt-5.6-terraRute Responses API
tokenlab-claudetokenlab-claude/claude-sonnet-5Rute native Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.5-flashRute native Gemini
tokenlab-minimaxtokenlab-minimax/minimax-m3Rute 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 status

Langkah Selanjutnya

Setelah OpenClaw tersambung, panduan berikut membantu Anda menggunakan TokenLab dengan lebih efektif:

Di halaman ini