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

npm · GitHub

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

ProviderOpenClaw apiTerbaik 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 Claude Messages aslihttps://api.tokenlab.sh
tokenlab-geminigoogle-generative-aiFormat API Gemini aslihttps://api.tokenlab.sh
tokenlab-minimaxanthropic-messagesModel MiniMax melalui format Messageshttps://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 -s

Contoh Model

ProviderReferensi ModelDeskripsi
tokenlabtokenlab/gpt-5.6-terraKompatibel dengan OpenAI (Chat Completions)
tokenlab-responsestokenlab-responses/gpt-5.6-terraResponses API
tokenlab-claudetokenlab-claude/claude-sonnet-5Claude Messages
tokenlab-geminitokenlab-gemini/gemini-3.6-flashGemini
tokenlab-minimaxtokenlab-minimax/minimax-m3MiniMax 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 status

Menghasilkan 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 tokenlab

Pertahankan 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:

Di halaman ini