Tutorial lima menit tentang mengonfigurasi OpenClaw dengan CometAPI

CometAPI
AnnaFeb 24, 2026
Tutorial lima menit tentang mengonfigurasi OpenClaw dengan CometAPI

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

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

Apa itu OpenClaw dan mengapa mengintegrasikannya dengan CometAPI?

OpenClaw adalah platform agen berbasis 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 mengekspos banyak penyedia model melalui satu antarmuka REST dan SDK bergaya OpenAI. Hal ini membuatnya nyaman sebagai satu titik integrasi jika Anda ingin mengganti model, mencoba harga, atau memusatkan observabilitas tanpa mengubah kode inti OpenClaw.

Mengapa Memasangkan OpenClaw dengan CometAPI?

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

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

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

Bagaimana saya mengonfigurasi OpenClaw untuk menggunakan CometAPI sebagai penyedia model?

Jawaban: Tambahkan entri penyedia ke konfigurasi OpenClaw yang mengarah 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:

PenyediaFormat APIURL Dasar
cometapi-openaiopenai-completionshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aihttps://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 belakang layar)
  • Akses terminal dengan bash/zsh atau PowerShell

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

Akun dan Kunci API

Anda memerlukan:

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

💡 Tips: Gunakan pengelola rahasia yang aman atau keychain OS alih-alih menyimpan kunci dalam plaintext. Hal ini direkomendasikan oleh dokumentasi OpenClaw untuk keamanan produksi.

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

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

Langkah 0 — Set variabel lingkungan (jalur 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., rahasia Docker, systemd, rahasia Kubernetes).

Langkah 1 — Pasang OpenClaw

Opsi A: Satu Baris melalui Skrip Installer

Ini cara tercepat:

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

Skrip ini mendeteksi OS Anda dan memasang OpenClaw beserta dependensinya.

Opsi B: Instal Global via npm

Jika Anda sudah mengelola paket Node:

npm install -g openclaw@latestopenclaw --version

Ini memasang CLI OpenClaw secara global.

Opsional: Instal Docker

Jika Anda melakukan deployment ke produksi atau menginginkan isolasi:

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

Penempatan terkontainer memudahkan pengelolaan dependensi dan beban kerja.nClaw version; contoh OpenClaw mengikuti pola ini.)

Langkah 2 — Konfigurasi Penyedia

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

Mengedit File Konfigurasi OpenClaw

OpenClaw menyimpan konfigurasinya dalam file 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 menyimpan 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 — Konfigurasi Profil Autentikasi

⚠️ Wajib! OpenClaw membaca kunci API dari file ini, bukan dari openclaw.json. Melewati langkah ini 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-perintah ini mengonfirmasi apakah penyedia dan profil autentikasi Anda sudah disiapkan dengan benar. Semua model harus 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

Langkah 4 — Jalankan OpenClaw dan pantau log

Mulai/ulang OpenClaw dan tail log. Perhatikan khususnya:

  • Log permintaan keluar yang menampilkan base_url atau nama penyedia.
  • HTTP 401/403 → masalah kunci atau cakupan.
  • 429 → batas kecepatan (pertimbangkan perubahan model/kinerja).
  • Latensi yang sangat lama → throttling jaringan atau 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 Anda 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 Screenshot

Jika agen Anda mendukung lampiran:

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

OpenClaw mengirimkan prompt (beserta 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 mana pun yang dikonfigurasi:

  • Kanal 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 mendapat kendali — 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 bisa mengatribusikan biaya.

Tuas kontrol biaya

  • Set max_tokens dan timeout_seconds di 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 menegakkan ini).

CometAPI mengiklankan perkakas untuk tuning kinerja dan biaya; gunakan telemetri di kedua sisi (log OpenClaw + metrik penggunaan CometAPI) untuk membuat pagar pengaman.

Bagaimana cara memecahkan masalah umum dalam integrasi?

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

Perbaikan: Panel kontrol OpenClaw akan menampilkan token sekali pakai; tempelkan ke pengaturan Control UI sesuai dokumen. 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 tulis ke .env OpenClaw dan mulai ulang gateway. Konfirmasi dengan tes curl.

Penyedia diam-diam jatuh kembali / default

Penyebab: JSON models.providers tidak valid atau flavor api hilang, menyebabkan OpenClaw mengabaikan penyedia.

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

Timeout atau latensi tinggi

Penyebab: rute jaringan atau kelambatan model jarak jauh.

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

Penggunaan berlebihan / 429

Penyebab: mencapai kuota CometAPI atau batas paket.

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

Token gateway hilang / pemutusan websocket

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

Catatan penutup

Menghubungkan OpenClaw ke CometAPI itu 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 allowlist, log semuanya, dan minta konfirmasi untuk tindakan yang destruktif. Dengan kontrol tersebut, Anda dapat beralih dari nol ke agen OpenClaw → CometAPI yang berfungsi dalam sekitar lima menit — dan menjaga data serta sistem Anda terlindungi saat bereksperimen.

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

Siap Mulai? → Daftar OpenClaw hari ini!

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

Akses Model Terbaik dengan Biaya Rendah

Baca Selengkapnya