Langsung ke konten utama

Documentation Index

Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt

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

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

1

Dapatkan CometAPI API key Anda

Masuk ke konsol CometAPI. Klik Add API Key lalu salin CometAPI API key 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 wizard setup sekali:
openclaw onboard --install-daemon
Saat onboarding, pilih Skip pada langkah Model/Auth jika Anda ingin mengonfigurasi CometAPI secara manual. Setelah onboarding, pastikan gateway berjalan:
openclaw gateway status
openclaw dashboard

​
Konfigurasi

1

Simpan CometAPI key Anda

Tulis key 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 menyisipkan COMETAPI_KEY melalui shell, service manager, atau alur kerja secrets, lewati langkah ini — konfigurasi di bawah menggunakan $\{COMETAPI_KEY\} terlepas dari bagaimana variabel tersebut disetel.
2

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 dapat hanya menyimpan provider yang dibutuhkan, atau menyimpan keempatnya untuk merutekan antarformat 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 menggunakan baseUrl yang sama (https://api.cometapi.com/v1); satu-satunya perbedaan adalah endpoint downstream mana yang dipanggil 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 menginginkan rotasi kredensial per profil di beberapa key.

​
Verifikasi

1

Restart dan verifikasi

Restart gateway setelah menambahkan .env atau mengubah konfigurasi 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 konfigurasi
  • openclaw doctor melaporkan tidak ada error konfigurasi atau auth untuk provider CometAPI
Status model OpenClaw yang menunjukkan provider CometAPI telah terautentikasi

​
Ganti model

1

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

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 menghapus semua konfigurasi lokal, sesi, log, status auth, dan workspace. Setelah itu, ikuti lagi Langkah 3–5.