CometAPI × OpenClaw

Konfigurasi
OpenClaw
via CometAPI

Gunakan CometAPI sebagai penyedia model kustom untuk OpenClaw: satu API, 500+ model, diskon hingga 20%. Panduan ini selaras dengan alur onboarding OpenClaw saat ini (2026.3.8+) dan mencakup instalasi, konfigurasi penyedia, verifikasi, dan penggantian model.

~/.openclaw/openclaw.json
# Hanya contoh—verifikasi dengan versi OpenClaw Anda sebelum produksi
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}
00 — Mulai di sini

Cakupan panduan
dan prasyarat

Ikhtisar panduan

Konfigurasi OpenClaw dengan CometAPI

Gunakan CometAPI sebagai penyedia model kustom untuk OpenClaw guna mengakses 500+ model melalui satu API, dengan diskon hingga 20% pada rute yang didukung. Halaman ini mengikuti alur onboarding OpenClaw saat ini (2026.3.8+).

Prasyarat

Prasyarat

Node.js >= 22 dan API key CometAPI diperlukan. Untuk instalasi daemon, simpan COMETAPI_KEY di ~/.openclaw/.env agar openclaw.json dapat mereferensikan ${COMETAPI_KEY} tanpa mengkodekan rahasia secara langsung.

Perintah cepat
openclaw onboard --install-daemon
openclaw gateway status
openclaw dashboard

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

Setelah menambahkan ~/.openclaw/.env atau mengedit konfigurasi penyedia, mulai ulang sekali dengan openclaw gateway restart, lalu jalankan diagnostik. Gunakan referensi provider/model lengkap di semua perintah dan sesi. Untuk penyimpangan versi, periksa kembali Referensi konfigurasi.

01 — Catatan pengaturan penyedia

Mengapa tiga penyedia
untuk satu API key CometAPI

Perutean penyedia berbasis bentuk API
OpenClaw merutekan berdasarkan kompatibilitas API (bukan hanya label vendor), jadi gunakan penyedia terpisah untuk openai-completions, anthropic-messages, dan google-generative-ai.
Satu key, konfigurasi multi-penyedia
Pertahankan satu COMETAPI_KEY dan gunakan kembali di blok cometapi-openai, cometapi-claude, dan cometapi-google. Gunakan referensi provider/model eksplisit di mana saja.
Verifikasi alur saat ini
Jalankan onboarding sekali, mulai ulang gateway setelah perubahan, lalu validasi dengan models status, models list berlingkup penyedia, dan diagnostik doctor.
02 — Hubungkan ke OpenClaw

Instal, onboard, konfigurasi,
verifikasi, ganti

Catatan berbasis versi

OpenClaw menggunakan ~/.openclaw/openclaw.json sebagai konfigurasi sumber yang Anda edit. Penyedia kustom dimaterialisasikan ke dalam file models.json per-agen di bawah ~/.openclaw/agents/<agentId>/. Periksa kembali kunci dan perilaku setelah upgrade menggunakan panduan Referensi konfigurasi dan Variabel lingkungan . Perlakukan URL dasar CometAPI hanya seperti yang didefinisikan dalam dokumentasi langsung.

01 Instal atau perbarui OpenClaw
Direkomendasikan: curl -fsSL https://openclaw.ai/install.sh | bash. Atau npm install -g openclaw@latest jika mempertahankan instalasi npm global.
02 Jalankan onboarding sekali
Jalankan: openclaw onboard --install-daemon. Di Model/Auth pilih Skip untuk instalasi dasar, pertahankan workspace default kecuali diperlukan, dan biarkan wizard menyelesaikan daemon dan health check.
03 Simpan COMETAPI_KEY
Untuk instalasi daemon, tambahkan COMETAPI_KEY ke ~/.openclaw/.env dan jalankan chmod 600. Lanjutkan menggunakan alur kerja secrets shell/layanan yang sudah ada.
04 Tambahkan penyedia CometAPI di openclaw.json
Tambahkan cometapi-openai (openai-completions), cometapi-claude (anthropic-messages), dan cometapi-google (google-generative-ai), lalu atur primary ke cometapi-claude/claude-sonnet-4-6.
05 Mulai ulang dan verifikasi
Jalankan openclaw gateway restart, lalu openclaw models status, openclaw models list --provider cometapi-claude, dan openclaw doctor. Tidak ada kesalahan skema konfigurasi/autentikasi yang diharapkan untuk penyedia CometAPI.
06 Ganti model dengan provider/model
Atur default dengan openclaw models set cometapi-claude/claude-sonnet-4-6. Di obrolan, ganti via /model cometapi-openai/gpt-5.4 atau /model cometapi-google/gemini-3.1-pro-preview.
07 Instalasi ulang bersih opsional
Saat memperbaiki instalasi lama yang rusak: hentikan gateway, hapus ~/.openclaw, jalankan ulang onboarding, lalu terapkan kembali konfigurasi CometAPI. Ini mereset konfigurasi lokal, sesi, log, dan status autentikasi.
Cuplikan konfigurasi (gabungkan ke openclaw.json)
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "cometapi-claude/claude-sonnet-4-6"
      }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "${COMETAPI_KEY}",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "${COMETAPI_KEY}",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "${COMETAPI_KEY}",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
      }
    }
  }
}

Pengaturan dasar tidak memerlukan pembuatan manual auth-profiles.json. Gunakan ${COMETAPI_KEY} di penyedia dan injeksikan variabel melalui ~/.openclaw/.env, shell, atau manajer layanan.

03 — Harga referensi

Tarif langsung di
situs CometAPI

Tabel di bawah menggunakan harga ilustratif per juta token. Katalog model, diskon, dan SLA sesuai dengan apa yang Dokumentasi dan konsol CometAPI tampilkan saat ini.

Model (contoh)Input / 1M tokenOutput / 1M tokenCatatan
Claude Opus 4.6$4.00$20.00Dari data referensi
MiniMax-M2.7$0.24$0.96Dari data referensi
GLM 5 Turbo$0.96$3.26Dari data referensi
GPT-5.4 pro$24.00$144Dari data referensi
Gemini 3.1 Pro$1.60$9.60Dari data referensi
qwen3.5-plus$0.32$1.92Dari data referensi
Ilustrasi biaya penggunaan
Diperkirakan dari tarif per juta token versus referensi ilustratif "saluran resmi"—hanya untuk pemahaman, bukan jaminan harga. Selalu ikuti harga langsung di situs CometAPI.
Tarif disinkronkan dengan dokumentasi
Harga input
$4.00 / 1M
Harga output
$20.00 / 1M
Baca otomatis dari konfigurasi model yang dipilih
CometAPI (1M input + 1M output)
$24.00
Referensi resmi (penggunaan sama)
$30.00
Penghematan ilustratif
$6.00
~20% di bawah referensi (ilustratif)
04 — Pertanyaan yang sering diajukan

Periksa ini
sebelum mengintegrasikan

Apakah saya memerlukan auth-profiles.json untuk pengaturan ini?

Tidak untuk pengaturan dasar. OpenClaw dapat menyelesaikan apiKey penyedia dari models.providers.*.apiKey via ${COMETAPI_KEY}. Gunakan auth-profiles.json hanya untuk rahasia tersimpan per profil atau rotasi.

Mengapa ada 3 entri penyedia untuk satu vendor?

OpenClaw merutekan berdasarkan kompatibilitas format API. Pertahankan entri terpisah untuk openai-completions, anthropic-messages, dan google-generative-ai jika Anda memerlukan ketiga keluarga API.

Di mana konfigurasi sebenarnya diedit dan dimaterialisasikan?

Edit ~/.openclaw/openclaw.json. Penyedia kustom dimaterialisasikan ke models.json per-agen di bawah ~/.openclaw/agents/<agentId>/ setelah sync/load.

ID model apa yang digunakan dalam panduan ini?

gpt-5.4, claude-sonnet-4-6, dan gemini-3.1-pro-preview. Anda dapat menambahkan model apa pun dari halaman model CometAPI ke blok penyedia yang sesuai.