Tutorial lima menit untuk mengonfigurasi OpenClaw dengan CometAPI

Pada awal 2026, OpenClaw — platform runtime agen sumber terbuka dan asisten AI — terus banyak diadopsi oleh pengembang, tim riset, dan perusahaan yang menginginkan orkestrasi multi-model di berbagai kanal seperti Slack, Telegram, WhatsApp, dan eksekusi baris perintah lokal. Sementara itu, CometAPI muncul sebagai gateway LLM yang kompatibel dengan OpenAI yang kuat, mengagregasi ratusan model (mis., Kimi-K2.5, varian GPT, Claude) di bawah satu endpoint API.

Artikel ini menjadi panduan praktis langkah demi langkah untuk mengonfigurasi OpenClaw agar dapat menggunakan CometAPI sebagai penyedia model. Anda akan mempelajari cara menginstal, menyiapkan penyedia, mendefinisikan profil autentikasi, memverifikasi fungsionalitas, dan beralih antar model — semuanya dengan contoh konfigurasi langsung dan tips berdasarkan dokumentasi terbaru serta masukan komunitas.

Apa itu OpenClaw dan mengapa mengintegrasikannya dengan CometAPI?

OpenClaw adalah platform agen sumber terbuka yang berfokus pada perangkat, yang menghubungkan AI percakapan ke aplikasi chat dan perangkat yang sudah digunakan orang — WhatsApp, Telegram, Slack, Discord, dan lainnya — sambil memungkinkan Anda menjalankan model di mana pun Anda mau dan menjaga kunci serta data tetap berada di bawah kendali Anda. Proyek dan repositorinya berisi contoh yang menunjukkan bagaimana OpenClaw memilih penyedia LLM melalui konfigurasi bergaya gateway.

CometAPI adalah platform agregasi API yang memaparkan banyak penyedia model melalui antarmuka REST bergaya OpenAI dan SDK. Ini membuatnya nyaman sebagai satu titik integrasi jika Anda ingin mengganti model, mencoba harga, atau memusatkan observabilitas tanpa mengubah kode inti OpenClaw.

Mengapa Memadukan OpenClaw dengan CometAPI?

OpenClaw bersifat agnostik terhadap model; ia menjalankan agen dan alur kerja tetapi bergantung pada penyedia LLM eksternal. CometAPI bertindak sebagai gateway yang kompatibel dengan OpenAI, memungkinkan Anda merutekan panggilan ke:

Model keluarga GPT
Model keluarga Claude
Kimi-K2.5 dan model pihak ketiga lainnya yang diagregasi oleh CometAPI

Ini memberi Anda pilihan, fleksibilitas, kontrol biaya, dan redundansi.

Bagaimana cara mengonfigurasi OpenClaw untuk menggunakan CometAPI sebagai penyedia model?

Jawaban: Tambahkan entri penyedia ke konfigurasi OpenClaw Anda yang menunjuk ke endpoint REST CometAPI dan petakan model ke struktur models.providers milik OpenClaw. Proyek OpenClaw mendukung penambahan penyedia kustom melalui models.providers (pola yang sama digunakan untuk gateway lain) dan mengharapkan sebuah flavor api seperti "openai-completions" atau "anthropic-messages" tergantung pada semantik penyedia.

CometAPI mendukung tiga format API. Tambahkan satu atau lebih ke ~/.openclaw/openclaw.json:

Penyedia	Format API	Base URL
cometapi-openai	openai-completions	https://api.cometapi.com/v1
cometapi-claude	anthropic-messages	https://api.cometapi.com
cometapi-google	google-generative-ai	https://api.cometapi.com/v1beta

Apa Prasyarat untuk Mengonfigurasi OpenClaw dengan CometAPI?

Sebelum integrasi, pastikan Anda memiliki lingkungan, alat, dan akun yang tepat.

Persyaratan Lingkungan

Anda memerlukan:

Lingkungan mirip Unix: Linux, macOS, atau Windows Subsystem for Linux (WSL2)
Node.js dan npm terpasang (OpenClaw menggunakan Node di balik layar)
Akses terminal dengan bash/zsh atau PowerShell

Dokumen resmi juga menyebutkan bahwa OpenClaw dapat dijalankan melalui Docker, yang ideal untuk lingkungan terisolasi dan produksi.

Akun dan Kunci API

Anda membutuhkan:

Akun CometAPI
Kunci LLM CometAPI yang valid (disimpan dalam variabel lingkungan yang aman)
Opsional: Akun untuk penyedia OpenClaw tambahan (OpenAI, Anthropic, model lokal melalui Ollama)

💡 Tip: Gunakan pengelola rahasia (secrets manager) yang aman atau keychain OS alih-alih menyimpan kunci dalam teks biasa. Ini direkomendasikan oleh dokumentasi OpenClaw sendiri untuk keamanan produksi.

Bagaimana mengonfigurasi OpenClaw agar memanggil CometAPI? (langkah demi langkah)

Di bawah ini adalah penyiapan ringkas dan praktis selama lima menit. Nama file atau kunci yang tepat bergantung pada versi dan deployment OpenClaw Anda, tetapi konsepnya langsung diadaptasi dari repo dan dokumentasi resmi OpenClaw.

Langkah 0 — Setel variabel lingkungan (cara cepat yang aman)

Contoh shell (Linux/macOS):

# do NOT commit this to gitexport COMETAPI_KEY="sk-YourCometApiKeyHere"export OPENCLAW_ENV="production"   # or development

Gunakan mekanisme rahasia platform Anda untuk produksi (mis., Docker secrets, systemd, Kubernetes secrets).

Langkah 1 — Instal OpenClaw

Opsi A: Satu baris melalui skrip pemasang

Ini cara tercepat:

curl -fsSL https://openclaw.ai/install.sh | bash# Verify installationopenclaw --version

Skrip ini mendeteksi OS Anda dan menginstal OpenClaw beserta dependensinya.

Opsi B: Instal global via npm

Jika Anda sudah mengelola paket Node:

npm install -g openclaw@latestopenclaw --version

Ini menginstal CLI OpenClaw secara global.

Opsional: Instalasi Docker

Jika Anda menerapkan ke produksi atau menginginkan isolasi:

docker pull openclaw/openclaw:latestdocker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw

Penerapan terkontainer memudahkan pengelolaan dependensi dan beban kerja.nClaw version; OpenClaw’s examples follow this pattern.)

Langkah 2 — Konfigurasikan Penyedia

Mengonfigurasi penyedia memberi tahu OpenClaw di mana menemukan backend LLM Anda.

Menyunting Berkas Konfigurasi OpenClaw

OpenClaw menyimpan konfigurasinya dalam berkas JSON di:

~/.openclaw/openclaw.json

Anda akan mendefinisikan penyedia kustom untuk CometAPI.

Berikut konfigurasi penyedia minimal:

base_url memberi tahu OpenClaw untuk mengirim permintaan LLM ke endpoint CometAPI yang kompatibel dengan OpenAI.
auth_env menunjuk ke variabel lingkungan yang menampung kunci API Anda.
Flag type menentukan jenis protokol API (gaya OpenAI).

{
  "models": {
    "mode": "merge",
    "providers": {
      "cometapi-openai": {
        "baseUrl": "https://api.cometapi.com/v1",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "openai-completions",
        "models": [{ "id": "gpt-5.2", "name": "GPT-5.2" }]
      },
      "cometapi-claude": {
        "baseUrl": "https://api.cometapi.com",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "anthropic-messages",
        "models": [{ "id": "claude-opus-4-6", "name": "Claude Opus 4.6" }]
      },
      "cometapi-google": {
        "baseUrl": "https://api.cometapi.com/v1beta",
        "apiKey": "<YOUR_COMETAPI_KEY>",
        "api": "google-generative-ai",
        "models": [{ "id": "gemini-3-pro-preview", "name": "Gemini 3 Pro" }]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": { "primary": "cometapi-claude/claude-opus-4-6" }
    }
  },
  "auth": {
    "profiles": {
      "cometapi-openai:default": { "provider": "cometapi-openai", "mode": "api_key" },
      "cometapi-claude:default": { "provider": "cometapi-claude", "mode": "api_key" },
      "cometapi-google:default": { "provider": "cometapi-google", "mode": "api_key" }
    }
  }
}

Ganti <YOUR_COMETAPI_KEY> dengan Kunci API Anda. Ketiga penyedia menggunakan kunci yang sama.

Anda dapat menambahkan model apa pun dari Halaman Model CometAPI ke penyedia yang sesuai.

Langkah 3 — Konfigurasikan Profil Auth

⚠️ Wajib! OpenClaw membaca kunci API dari berkas ini, bukan dari openclaw.json. Melewatkannya akan menyebabkan HTTP 401.

Buat ~/.openclaw/agents/main/agent/auth-profiles.json:

{
  "version": 1,
  "profiles": {
    "cometapi-openai:default": {
      "type": "api_key",
      "provider": "cometapi-openai",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-claude:default": {
      "type": "api_key",
      "provider": "cometapi-claude",
      "key": "<YOUR_COMETAPI_KEY>"
    },
    "cometapi-google:default": {
      "type": "api_key",
      "provider": "cometapi-google",
      "key": "<YOUR_COMETAPI_KEY>"
    }
  },
  "lastGood": {
    "cometapi-openai": "cometapi-openai:default",
    "cometapi-claude": "cometapi-claude:default",
    "cometapi-google": "cometapi-google:default"
  }
}

Mulai ulang gateway:

openclaw gateway restart

Periksa status dengan:

openclaw auth status

Dan untuk menampilkan semua model yang dikonfigurasi:

openclaw models list

Perintah ini mengonfirmasi apakah penyedia dan profil auth Anda telah disetel dengan benar. Semua model seharusnya menampilkan Auth = yes:

Model                                        Auth
cometapi-openai/gpt-5.2                      yes
cometapi-claude/claude-opus-4-6              yes
cometapi-google/gemini-3-pro-preview         yes

Tutorial lima menit untuk mengonfigurasi OpenClaw dengan CometAPI

Langkah 4 — Jalankan OpenClaw dan pantau log

Mulai/mulai ulang OpenClaw dan tail log. Perhatikan secara khusus:

Log permintaan keluar yang menampilkan base_url atau nama penyedia.
HTTP 401/403 → masalah kunci atau cakupan.
429 → batas laju (pertimbangkan perubahan model/kinerja).
Latensi yang tidak terduga panjang → jaringan atau throttling model.

Perintah diagnostik cepat (contoh):

# If OpenClaw runs as a system service:journalctl -u openclaw -f# If running in Docker:docker logs -f openclaw

Beralih Model

# Set default model
openclaw models set cometapi-claude/claude-opus-4-6

# Or switch in TUI
/model cometapi-openai/gpt-5.2

Bagaimana Menggunakan OpenClaw dengan CometAPI dalam Alur Kerja Nyata?

Setelah integrasi, Anda dapat membangun alur kerja yang mencakup pembuatan kode, tugas multimodal, otomasi agen, dan posting ke kanal.

Contoh Alur Kerja: Interpretasi Tangkapan Layar

Jika agen Anda mendukung lampiran:

User: Analyze this screenshot and generate a minimal React component.

OpenClaw mengirimkan prompt (plus data gambar) melalui model CometAPI (seperti Kimi K-2.5), yang mengembalikan keluaran kode — ideal untuk membuat prototipe alur kerja UI.

Integrasi Slack / Discord

Setelah CometAPI menjadi backend, Anda dapat merutekan balasan agen ke platform apa pun yang dikonfigurasi:

Channel Slack
Grup WhatsApp
Bot Telegram

OpenClaw menangani perutean dan parsing permintaan; CometAPI menyediakan respons model.

Pemantauan dan kontrol biaya apa yang harus Anda tambahkan?

Saat Anda memusatkan ke agregator, Anda mendapatkan kontrol — tetapi Anda harus mengonfigurasinya:

Instrumentasi

Catat nama model, penggunaan token, latensi, dan kode error untuk setiap permintaan.
Tandai permintaan dengan agen dan kanal (mis., agent=personal_assistant, channel=telegram) sehingga Anda dapat mengatribusikan biaya.

Tombol kontrol biaya

Setel max_tokens dan timeout_seconds dalam konfigurasi penyedia Anda.
Gunakan model yang lebih murah untuk tugas rutin dan cadangkan model besar untuk alur bernilai tinggi.
Konfigurasikan batas laju per agen dan kuota per pengguna (OpenClaw sering dapat diperluas untuk menegakkannya).

CometAPI menyediakan alat untuk penyetelan performa dan biaya; gunakan telemetri dari kedua sisi (log OpenClaw + metrik penggunaan CometAPI) untuk membuat pagar pembatas.

Bagaimana cara memecahkan kesalahan umum dalam integrasi?

Jawaban: Berikut mode kegagalan umum dan cara mengatasinya dengan cepat:

Perbaikan: Panel kontrol OpenClaw akan menampilkan token sekali pakai; tempelkan ke pengaturan Control UI sesuai dokumentasi. Catatan komunitas sering merujuk langkah ini.

401 Unauthorized

Penyebab: COMETAPI_KEY hilang, salah, atau tidak diinjeksi ke proses OpenClaw.

Perbaikan: Ekspor kunci di shell yang meluncurkan OpenClaw atau tuliskan ke .env OpenClaw dan mulai ulang gateway. Konfirmasikan dengan uji curl.

Penyedia diam-diam fallback / menjadi default

Penyebab: JSON models.providers yang salah bentuk atau flavor api hilang, menyebabkannya diabaikan oleh OpenClaw.

Perbaikan: Validasi openclaw.json (lint JSON) dan pastikan api cocok dengan flavor yang didukung. Thread isu komunitas menunjukkan salah konfigurasi ini umum terjadi.

Timeout atau latensi tinggi

Penyebab: rute jaringan atau kelambatan model remote.

Perbaikan: Pilih model Comet dengan latensi lebih rendah atau jalankan OpenClaw dekat dengan wilayah cloud yang sama; pertimbangkan menjalankan model lokal untuk tugas sensitif latensi. Dokumentasi dan blog membahas kompromi antara model lokal dan model API (latensi vs biaya).

Penggunaan berlebih / 429

Penyebab: mencapai kuota atau batas paket CometAPI.

Perbaikan: Periksa dashboard Comet untuk kuota; tambahkan logika retry/backoff dalam aksi agen OpenClaw atau throttle permintaan di gateway. Dokumen Comet dan mitra menyoroti kuota paket dan pola backoff yang direkomendasikan.

Token gateway hilang / websocket terputus

Penyebab: token kontrol OpenClaw hilang dalam konfigurasi dashboard saat menjalankan Gateway.

Catatan penutup

Menghubungkan OpenClaw ke CometAPI cepat dan membuka backend multi-model yang kuat untuk asisten pribadi Anda. Namun kecepatan bukan alasan untuk mengabaikan keamanan: ikat gateway ke localhost saat pengujian, gunakan daftar izin (allowlist), catat semuanya, dan minta konfirmasi untuk tindakan destruktif. Dengan kontrol tersebut, Anda dapat beralih dari nol ke agen OpenClaw → CometAPI yang berfungsi dalam sekitar lima menit — dan tetap menjaga data serta sistem Anda terlindungi saat bereksperimen.

Pengembang dapat mengakses kimi k-2.5 melalui CometAPI sekarang. Untuk memulai, jelajahi kapabilitas model di Playground dan lihat panduan API untuk instruksi terperinci. Sebelum mengakses, pastikan Anda telah masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga jauh lebih rendah daripada harga resmi untuk membantu Anda melakukan integrasi.

Siap Mulai?→ Daftar OpenClaw hari ini !

Jika Anda ingin mengetahui lebih banyak tips, panduan, dan berita tentang AI, ikuti kami di VK, X dan Discord!