Gunakan OpenClaw dengan CometAPI

Gunakan CometAPI sebagai provider model untuk OpenClaw — 500+ model dalam satu API.

Prasyarat

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

Instalasi

Dapatkan CometAPI API key Anda

Masuk ke console CometAPI. Klik Add API Key lalu salin CometAPI API key Anda.

Dashboard CometAPI yang menampilkan tombol Add API Key

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 wizard setup sekali:

openclaw onboard --install-daemon

Selama 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

Konfigurasi

Simpan kunci CometAPI Anda

Tulis kunci Anda ke ~/.openclaw/.env agar tersedia untuk daemon tanpa di-hardcode di file konfigurasi:

printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env

Jika Anda sudah menyuntikkan COMETAPI_KEY melalui shell, service manager, atau alur kerja secrets, lewati langkah ini — konfigurasi di bawah menggunakan $\{COMETAPI_KEY\} terlepas dari bagaimana variabel tersebut diatur.

Konfigurasikan provider CometAPI

CometAPI mendukung empat format API. Tambahkan satu atau beberapa 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 dapat hanya menyimpan provider yang Anda perlukan, atau menyimpan keempatnya untuk merutekan antar format menggunakan referensi provider/model.Ganti setiap placeholder your-...-model-id dengan model ID saat ini 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 pada 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. Kunci provider di-resolve dari models.providers.*.apiKey melalui env var $\{COMETAPI_KEY\}. auth-profiles.json hanya diperlukan jika Anda menginginkan rotasi kredensial per profil di beberapa kunci.

Verifikasi

Mulai ulang dan verifikasi

Mulai ulang 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 terlihat seperti:

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 konfigurasi
openclaw doctor melaporkan tidak ada error config atau auth untuk provider CometAPI

OpenClaw models status yang menunjukkan provider CometAPI terautentikasi

Ganti model

# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id

# Switch for the current chat session
/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

Pemecahan masalah

Instal ulang bersih (opsional)

Jika Anda sedang memperbaiki setup lama yang rusak, hentikan gateway, hapus ~/.openclaw, lalu jalankan ulang onboarding sebelum menerapkan konfigurasi CometAPI:

openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon

Ini akan menghapus semua konfigurasi lokal, sesi, log, status auth, dan workspace. Lalu ikuti kembali Langkah 3–5.

Ikhtisar

Agen coding AI

Agen AI

Klien chat AI

Terjemahan dan bahasa

Platform otomasi

Observabilitas dan evaluasi

Framework AI

Prasyarat

Instalasi

Konfigurasi

Verifikasi

Ganti model

Pemecahan masalah

​Prasyarat

​Instalasi

​Konfigurasi

​Verifikasi

​Ganti model

​Pemecahan masalah

Prasyarat

Instalasi

Konfigurasi

Verifikasi

Ganti model

Pemecahan masalah