Langsung ke konten utama
Gunakan CometAPI sebagai provider model untuk OpenClaw — 500+ model dalam satu API. Panduan ini mencakup alur onboarding saat ini (2026.3.8+).

​
Prasyarat

  • Node.js ≥ 22 — direkomendasikan melalui nvm
  • Akun CometAPI dengan API key yang aktif — dapatkan di sini
1

Dapatkan CometAPI API key Anda

Masuk ke konsol CometAPI. Klik Add API Key lalu salin key sk-xxxxx Anda.
Dashboard CometAPI yang menampilkan tombol Add API Key
Detail API key CometAPI dengan base URL
2

Instal atau perbarui OpenClaw

Direkomendasikan — gunakan installer resmi:
curl -fsSL https://openclaw.ai/install.sh | bash
Atau instal melalui npm:
npm install -g openclaw@latest
Lalu jalankan setup wizard sekali:
openclaw onboard --install-daemon
Saat onboarding, pilih Skip pada langkah Model/Auth jika Anda ingin mengonfigurasi CometAPI secara manual. Setelah onboarding, pastikan gateway sedang berjalan:
openclaw gateway status
openclaw dashboard
3

Simpan key CometAPI Anda

Tulis key Anda ke ~/.openclaw/.env agar tersedia untuk daemon tanpa di-hardcode di file config:
printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
Jika Anda sudah menyuntikkan COMETAPI_KEY melalui shell, service manager, atau workflow secrets, lewati langkah ini — config di bawah menggunakan $\{COMETAPI_KEY\} terlepas dari bagaimana variabel tersebut ditetapkan.
4

Konfigurasikan provider CometAPI

CometAPI mendukung empat format API. Tambahkan satu atau lebih blok provider ke ~/.openclaw/openclaw.json:
ProviderFormat APIEndpoint yang dipanggilBase URL
cometapi-openaiopenai-completionsPOST /v1/chat/completionshttps://api.cometapi.com/v1
cometapi-openai-responsesopenai-responsesPOST /v1/responseshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messagesPOST /messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aiPOST /v1beta/...https://api.cometapi.com/v1beta
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/your-claude-model-id"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
      },
      "cometapi-openai-responses": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-responses",
        "models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
      }
    }
  }
}
Anda bisa hanya menyimpan provider yang dibutuhkan, atau menyimpan keempatnya untuk melakukan routing antar format menggunakan referensi provider/model.Ganti setiap placeholder your-...-model-id dengan model ID terbaru dari halaman Models CometAPI yang sesuai dengan blok provider.
Gunakan cometapi-openai-responses (api: "openai-responses") untuk model yang memerlukan OpenAI Responses API. Gunakan cometapi-openai (api: "openai-completions") untuk model di jalur Chat Completions klasik. Keduanya berbagi baseUrl yang sama (https://api.cometapi.com/v1); satu-satunya perbedaan adalah endpoint downstream mana yang dipanggil oleh OpenClaw.
File auth-profiles.json tidak diperlukan untuk setup ini. Key provider di-resolve dari models.providers.*.apiKey melalui env var $\{COMETAPI_KEY\}. auth-profiles.json hanya diperlukan jika Anda ingin rotasi kredensial per profil di beberapa key.
5

Restart dan verifikasi

Restart gateway setelah menambahkan .env atau mengubah config provider:
openclaw gateway restart
Lalu jalankan diagnostik:
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
Setup yang berhasil akan terlihat seperti ini:
  • openclaw models status me-resolve model utama ke cometapi-claude/your-claude-model-id tanpa peringatan missing-auth untuk provider CometAPI
  • openclaw models list --provider cometapi-claude menampilkan model yang Anda konfigurasikan
  • openclaw doctor melaporkan tidak ada error config atau auth untuk provider CometAPI
Status models OpenClaw yang menunjukkan provider CometAPI telah diautentikasi
6

Ganti model

# Setel model default di config
openclaw models set cometapi-claude/your-claude-model-id

# Ganti untuk sesi chat saat ini
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id
Jika Anda sedang memperbaiki setup lama yang rusak, hentikan gateway, hapus ~/.openclaw, lalu jalankan ulang onboarding sebelum menerapkan config CometAPI:
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
Ini akan menghapus semua config lokal, sesi, log, status auth, dan workspace. Lalu ikuti kembali Langkah 3–5.