Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://docs.tokenlab.sh/llms.txt

Use this file to discover all available pages before exploring further.

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

​
Ikhtisar

Untuk versi OpenClaw saat ini, pendekatan yang direkomendasikan adalah mengonfigurasi TokenLab melalui models.providers. Jika Anda hanya ingin mulai dengan cepat, 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

​
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-32b", name: "Qwen 3 32B" }
        ]
      },
      "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-2.5-flash", name: "Gemini 2.5 Flash" },
          { id: "gemini-3-flash-preview", name: "Gemini 3 Flash Preview" }
        ]
      },
      "tokenlab-minimax": {
        api: "anthropic-messages",
        baseUrl: "https://api.tokenlab.sh",
        apiKey: "sk-your-tokenlab-key",
        models: [
          { id: "minimax-m1", name: "MiniMax M1" }
        ]
      }
    }
  }
}
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-2.5-flash"
      }
    }
  }
}

​
Contoh Model

PenyediaReferensi modelDeskripsi
tokenlabtokenlab/gpt-4oRute yang kompatibel dengan OpenAI
tokenlabtokenlab/deepseek-r1Model penalaran DeepSeek
tokenlab-responsestokenlab-responses/gpt-4oRute Responses API
tokenlab-claudetokenlab-claude/claude-sonnet-4-6Rute native Claude Messages
tokenlab-geminitokenlab-gemini/gemini-2.5-flashRute native Gemini
tokenlab-minimaxtokenlab-minimax/minimax-m1Rute 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

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.
openai-responses memetakan ke path /v1/responses di TokenLab, jadi tokenlab-responses harus menggunakan https://api.tokenlab.sh/v1.
anthropic-messages dan google-generative-ai harus menggunakan https://api.tokenlab.sh tanpa /v1. Menambahkan /v1 dapat menghasilkan path permintaan yang tidak benar.
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: