Penyiapan Penyedia TokenLab

Panduan ini ditujukan untuk pengguna self-hosted OpenClaw yang ingin menghubungkan TokenLab sebagai penyedia AI mereka.

Disarankan: instal plugin

Untuk eksekusi agen OpenClaw standar, instal plugin penyedia TokenLab:

openclaw plugins install @tokenlabai/openclaw-provider
openclaw onboard --tokenlab-api-key "$TOKENLAB_API_KEY"

Plugin mengambil katalog model chat aktif TokenLab dan menyimpan 18 model fallback untuk penemuan offline. Model menggunakan format tokenlab/<model-id>. Paket npm · Daftar ClawHub · Kode sumber

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.

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
Kunci API TokenLab — Dapatkan satu di sini

Konfigurasi

Edit konfigurasi OpenClaw Anda:

Hosting sendiri: ~/.openclaw/openclaw.json

Tambahkan penyedia TokenLab di bawah models.providers:

{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-claude/claude-sonnet-4-6"
      }
    }
  },
  models: {
    mode: "merge",
    providers: {
      tokenlab: {
        api: "openai-completions",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o" },
          { id: "deepseek-r1", name: "DeepSeek R1" },
          { id: "qwen3-coder-flash", name: "Qwen 3 Coder Flash" }
        ]
      },
      "tokenlab-responses": {
        api: "openai-responses",
        baseUrl: "https://api.tokenlab.sh/v1",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "gpt-4o", name: "GPT-4o (Responses)" },
          { id: "gpt-5.2", name: "GPT-5.2 (Responses)" }
        ]
      },
      "tokenlab-claude": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "claude-sonnet-4-6", name: "Claude Sonnet 4.6" },
          { id: "claude-opus-4-6", name: "Claude Opus 4.6" }
        ]
      },
      "tokenlab-gemini": {
        api: "google-generative-ai",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-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: "sk-your-tokenlab-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:

{
  agents: {
    defaults: {
      model: {
        primary: "tokenlab-gemini/gemini-3.5-flash"
      }
    }
  }
}

Contoh Model

Penyedia	Referensi model	Deskripsi
`tokenlab`	`tokenlab/gpt-4o`	Rute yang kompatibel dengan OpenAI
`tokenlab`	`tokenlab/deepseek-r1`	Model penalaran DeepSeek
`tokenlab-responses`	`tokenlab-responses/gpt-4o`	Rute Responses API
`tokenlab-claude`	`tokenlab-claude/claude-sonnet-4-6`	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

Masih menggunakan array penyedia tingkat atas yang lama

Dokumentasi OpenClaw saat ini menggunakan models.providers. Jika Anda mempertahankan format array providers tingkat atas yang lebih lama, OpenClaw mungkin mengabaikan konfigurasi atau gagal menyelesaikan prefix penyedia sebagaimana diharapkan.

Lupa menambahkan /v1 pada tokenlab-responses

openai-responses memetakan ke path /v1/responses di TokenLab, jadi tokenlab-responses harus menggunakan https://api.tokenlab.sh/v1.

Menambahkan /v1 ke tokenlab-claude, tokenlab-gemini, atau tokenlab-minimax

anthropic-messages dan google-generative-ai harus menggunakan https://api.tokenlab.sh tanpa /v1. Menambahkan /v1 dapat menghasilkan path permintaan yang tidak benar.

Apakah OpenClaw masih mendukung Gemini native?

Ya. Dokumentasi OpenClaw saat ini masih menyertakan penyedia bawaan google dan juga mendukung penyedia kustom yang menggunakan api: "google-generative-ai". Jadi tokenlab-gemini tetap menjadi rute Gemini native yang valid bagi pengguna OpenClaw.

Verifikasi Pengaturan

Setelah menyimpan konfigurasi, restart instance OpenClaw Anda dan uji dengan pesan sederhana. Jika Anda melihat respons, penyedia dikonfigurasi dengan benar.

# Hosting sendiri: mulai ulang layanan
systemctl --user restart openclaw    # Linux
launchctl stop cc.tokenlab.openclaw && launchctl start cc.tokenlab.openclaw  # macOS

Langkah 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/responses adalah pilihan yang lebih cocok
Penanganan error — pelajari mode kegagalan umum dan pola pemulihan
Ringkasan model — telusuri ID model sebelum menghubungkannya ke agen

Matriks kompatibilitas

Alat coding

SDK native

Framework & platform

Aplikasi chat

Penyiapan Penyedia TokenLab

Disarankan: instal plugin

Konfigurasi penyedia manual

Prasyarat

Konfigurasi

Menggunakan Model

Contoh Model

Kapan Menggunakan Penyedia Mana

Kesalahan Umum

Verifikasi Pengaturan

Langkah Selanjutnya

​Disarankan: instal plugin

​Konfigurasi penyedia manual

​Prasyarat

​Konfigurasi

​Menggunakan Model

​Contoh Model

​Kapan Menggunakan Penyedia Mana

​Kesalahan Umum

​Verifikasi Pengaturan

​Langkah Selanjutnya

Disarankan: instal plugin

Konfigurasi penyedia manual

Prasyarat

Konfigurasi

Menggunakan Model

Contoh Model

Kapan Menggunakan Penyedia Mana

Kesalahan Umum

Verifikasi Pengaturan

Langkah Selanjutnya