OpenClaw

Hubungkan OpenClaw ke CometAPI: instal melalui curl atau npm, simpan key Anda di ~/.openclaw/.env, konfigurasikan provider OpenAI/Anthropic/Google, dan jalankan 500+ model.

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.

   

   
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:

   Provider	Format API	Endpoint yang dipanggil	Base URL
   cometapi-openai	openai-completions	POST /v1/chat/completions	https://api.cometapi.com/v1
   cometapi-openai-responses	openai-responses	POST /v1/responses	https://api.cometapi.com/v1
   cometapi-claude	anthropic-messages	POST /messages	https://api.cometapi.com
   cometapi-google	google-generative-ai	POST /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

   
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
   

Instal ulang bersih (opsional)

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.