Tutorial lima minit tentang mengkonfigurasi OpenClaw dengan CometAPI

CometAPI
AnnaFeb 24, 2026
Tutorial lima minit tentang mengkonfigurasi OpenClaw dengan CometAPI

Pada awal 2026, OpenClaw — platform runtime ejen sumber terbuka dan pembantu AI — terus diterima secara meluas oleh pembangun, pasukan penyelidikan, dan perusahaan yang mahukan orkestrasi berbilang model merentas saluran seperti Slack, Telegram, WhatsApp, serta pelaksanaan baris arahan tempatan. Sementara itu, CometAPI muncul sebagai gerbang LLM serasi OpenAI yang berkuasa, mengagregasi ratusan model (cth., Kimi-K2.5, varian GPT, Claude) di bawah satu titik akhir API.

Artikel ini ialah panduan praktikal langkah demi langkah untuk mengkonfigurasi OpenClaw supaya ia boleh menggunakan CometAPI sebagai pembekal modelnya. Anda akan belajar cara memasang, menyediakan pembekal, mentakrif profil pengesahan, mengesahkan kefungsian, dan bertukar antara model — semuanya dengan contoh konfigurasi langsung dan petua berdasarkan dokumentasi terkini dan maklum balas komuniti.

Apakah OpenClaw dan mengapa mengintegrasikannya dengan CometAPI?

OpenClaw ialah platform ejen sumber terbuka berpusatkan peranti yang menghubungkan AI perbualan kepada aplikasi chat dan peranti yang sudah digunakan orang — WhatsApp, Telegram, Slack, Discord dan banyak lagi — sambil membolehkan anda menjalankan model di tempat yang anda mahu dan menyimpan kunci serta data di bawah kawalan anda. Projek dan reposnya mengandungi contoh yang menunjukkan bagaimana OpenClaw memilih pembekal LLM melalui konfigurasi gaya gerbang.

CometAPI ialah platform pengagregatan API yang mendedahkan banyak pembekal model melalui satu antara muka REST gaya OpenAI dan SDK. Ini menjadikannya mudah sebagai titik integrasi tunggal jika anda mahu menukar model, mencuba harga, atau memusatkan observabiliti tanpa menukar kod teras OpenClaw.

Mengapa Memadankan OpenClaw dengan CometAPI?

OpenClaw adalah agnostik model; ia menjalankan ejen dan aliran kerja tetapi bergantung pada pembekal LLM luaran. CometAPI bertindak sebagai gerbang serasi OpenAI, membolehkan anda menghala panggilan ke:

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

Ini memberikan anda pilihan, fleksibiliti, kawalan kos, dan redundansi.

Bagaimana saya mengkonfigurasi OpenClaw untuk menggunakan CometAPI sebagai pembekal model?

Jawapan: Tambah entri pembekal ke konfigurasi OpenClaw yang menunjuk ke titik akhir REST CometAPI dan petakan model ke struktur models.providers OpenClaw. Projek OpenClaw menyokong penambahan pembekal tersuai melalui models.providers (pola yang sama digunakan untuk gerbang lain) dan menjangkakan varian api seperti "openai-completions" atau "anthropic-messages" bergantung pada semantik pembekal.

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

PenyediaFormat APIURL Asas
cometapi-openaiopenai-completionshttps://api.cometapi.com/v1
cometapi-claudeanthropic-messageshttps://api.cometapi.com
cometapi-googlegoogle-generative-aihttps://api.cometapi.com/v1beta

Apakah Prasyarat untuk Mengkonfigurasi OpenClaw dengan CometAPI?

Sebelum integrasi, pastikan anda mempunyai persekitaran, alat, dan akaun yang betul.

Keperluan Persekitaran

Anda perlukan:

  • Persekitaran seperti Unix: Linux, macOS, atau Windows Subsystem for Linux (WSL2)
  • Node.js dan npm dipasang (OpenClaw menggunakan Node di bawah hud)
  • Akses terminal dengan bash/zsh atau PowerShell

Dokumen rasmi juga menyebut bahawa OpenClaw boleh dijalankan melalui Docker, yang ideal untuk setap terasing dan produksi.

Akaun dan Kunci API

Anda perlukan:

  1. Akaun CometAPI
  2. Kunci LLM CometAPI yang sah (disimpan dalam pembolehubah persekitaran yang selamat)
  3. Pilihan: Akaun untuk pembekal OpenClaw tambahan (OpenAI, Anthropic, model tempatan melalui Ollama)

💡 Petua: Gunakan pengurus rahsia yang selamat atau keychain OS dan bukannya menyimpan kunci dalam teks biasa. Ini disyorkan oleh dokumentasi OpenClaw sendiri untuk keselamatan produksi.

Bagaimana anda mengkonfigurasi OpenClaw untuk memanggil CometAPI? (langkah demi langkah)

Di bawah ialah setap pantas yang ringkas dalam lima minit. Nama fail atau kunci yang tepat bergantung pada versi dan penggunaan OpenClaw anda, tetapi konsepnya diterjemahkan terus daripada repo dan dokumen rasmi OpenClaw.

Langkah 0 — Tetapkan pembolehubah persekitaran (laluan pantas yang selamat)

Contoh shell (Linux/macOS):

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

Gunakan mekanisme rahsia platform anda untuk produksi (cth., rahsia Docker, systemd, rahsia Kubernetes).

Langkah 1 — Pasang OpenClaw

Pilihan A: Satu Baris melalui Skrip Pemasang

Ini cara terpantas:

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

Skrip ini mengesan OS anda dan memasang OpenClaw bersama kebergantungan.

Pilihan B: Pemasangan Global npm

Jika anda sudah mengurus pakej Node:

npm install -g openclaw@latestopenclaw --version

Ini memasang CLI OpenClaw secara global.

Pilihan: Pemasangan Docker

Jika anda mengeluarkan ke produksi atau mahukan pengasingan:

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

Pengeluaran berbekas memudahkan pengurusan kebergantungan dan beban kerja.nVersi OpenClaw; contoh OpenClaw mengikuti corak ini.)

Langkah 2 — Konfigurasi Pembekal

Mengkonfigurasi pembekal memberitahu OpenClaw di mana untuk mencari backend LLM anda.

Mengedit Fail Konfigurasi OpenClaw

OpenClaw menyimpan konfigurasinya dalam fail JSON di:

~/.openclaw/openclaw.json

Anda akan mentakrifkan pembekal tersuai untuk CometAPI.

Berikut ialah konfigurasi pembekal minimum:

  • base_url memberitahu OpenClaw untuk menghantar permintaan LLM ke titik akhir serasi OpenAI CometAPI.
  • auth_env menunjuk ke pembolehubah persekitaran yang menyimpan kunci API anda.
  • Bendera 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" }
    }
  }
}

Gantikan <YOUR_COMETAPI_KEY> dengan Kunci API anda. Ketiga-tiga pembekal menggunakan kunci yang sama.

Anda boleh menambah mana-mana model daripada CometAPI Models Page kepada pembekal yang sepadan.

Langkah 3 — Konfigurasi Profil Auth

⚠️ Diperlukan! OpenClaw membaca kunci API daripada fail ini, bukan daripada openclaw.json. Melangkau ini menyebabkan ralat HTTP 401.

Cipta ~/.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"
  }
}

Mulakan semula gerbang:

openclaw gateway restart

Periksa status dengan:

openclaw auth status

Dan untuk menyenaraikan semua model yang dikonfigurasi:

openclaw models list

Perintah ini mengesahkan sama ada pembekal dan profil auth anda ditetapkan dengan betul.Semua model sepatutnya menunjukkan 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 minit tentang mengkonfigurasi OpenClaw dengan CometAPI

Langkah 4 — Jalankan OpenClaw dan pantau log

Mulakan/mulakan semula OpenClaw dan lakukan tail pada log. Perhatikan khusus untuk:

  • Log permintaan keluar yang menunjukkan base_url atau nama pembekal.
  • HTTP 401/403 → isu kunci atau skop.
  • 429 → had kadar (pertimbangkan perubahan model/prestasi).
  • Kependaman terlalu panjang di luar jangkaan → rangkaian atau throttle model.

Perintah diagnostik pantas (contoh):

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

Tukar 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 Aliran Kerja Sebenar?

Selepas integrasi, anda boleh membina aliran kerja yang merangkumi penjanaan kod, tugas multimodal, automasi ejen, dan pengeposan saluran.

Contoh Aliran Kerja: Tafsiran Tangkapan Skrin

Jika ejen anda menyokong lampiran:

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

OpenClaw menghantar prompt (ditambah data imej) melalui model CometAPI (seperti Kimi K-2.5), yang mengembalikan output kod — sesuai untuk prototaip aliran kerja UI.

Integrasi Slack / Discord

Sebaik sahaja CometAPI menjadi backend, anda boleh menghala balasan ejen ke mana-mana platform yang dikonfigurasi:

  • Saluran Slack
  • Kumpulan WhatsApp
  • Bot Telegram

OpenClaw mengendalikan penghalaan dan penghuraian permintaan; CometAPI menyediakan respons model.

Pemantauan dan kawalan kos apa yang perlu anda tambah?

Apabila anda memusatkan kepada pengagregator, anda mendapat kawalan — tetapi anda mesti mengkonfigurasikannya:

Instrumentasi

  • Log nama model, penggunaan token, kependaman, dan kod ralat untuk setiap permintaan.
  • Tag permintaan dengan agen dan saluran (cth., agent=personal_assistant, channel=telegram) supaya anda boleh mengaitkan kos.

Tombol kawalan kos

  • Tetapkan max_tokens dan timeout_seconds dalam konfigurasi pembekal anda.
  • Gunakan model yang lebih murah untuk tugas rutin dan simpan model besar untuk aliran bernilai tinggi.
  • Konfigurasikan had kadar per-agen dan kuota per-pengguna (OpenClaw selalunya boleh diperluas untuk menguatkuasakannya).

CometAPI mengiklankan alat untuk penalaan prestasi dan kos; gunakan telemetri kedua-dua pihak (log OpenClaw + metrik penggunaan CometAPI) untuk mewujudkan pagar pengawal.

Bagaimana saya menyelesaikan ralat biasa dalam integrasi?

Jawapan: Berikut ialah mod kegagalan biasa dan cara menyelesaikannya dengan cepat:

Penyelesaian: Papan kawalan OpenClaw akan memaparkan token sekali; tampalkan ia ke tetapan Control UI mengikut dokumen. Nota komuniti kerap merujuk langkah ini.

401 Tidak Dibenarkan

Sebab: COMETAPI_KEY hilang, salah, atau tidak disuntik ke proses OpenClaw.

Penyelesaian: Eksport kunci dalam shell yang melancarkan OpenClaw atau tuliskannya ke .env OpenClaw anda dan mulakan semula gerbang. Sahkan dengan ujian curl.

Pembekal diam-diam kembali / menggunakan lalai

Sebab: JSON models.providers rosak atau varian api hilang, menyebabkan OpenClaw mengabaikan pembekal.

Penyelesaian: Validasi openclaw.json (lint JSON) dan pastikan api sepadan dengan varian yang disokong. Benang isu komuniti menunjukkan salah konfigurasi ini biasa berlaku.

Had masa atau kependaman tinggi

Sebab: laluan rangkaian atau kelambatan model jauh.

Penyelesaian: Pilih model Comet yang lebih rendah kependaman atau hos OpenClaw berhampiran wilayah awan yang sama; pertimbangkan menjalankan model tempatan untuk tugas sensitif kependaman. Dokumentasi dan blog membincangkan pertukaran antara model tempatan dan model API (kependaman vs kos).

Penggunaan berlebihan / 429

Sebab: melepasi kuota atau had pelan CometAPI.

Penyelesaian: Semak papan pemuka Comet untuk kuota; tambah logik cuba semula/backoff dalam tindakan ejen OpenClaw atau throttle permintaan di gerbang. Dokumen Comet dan rakan kongsi menyorot kuota pelan dan corak backoff yang disyorkan.

Token gerbang hilang / penyambungan websocket terputus

Sebab: token kawalan OpenClaw hilang dalam konfigurasi papan pemuka apabila menjalankan Gerbang.

Catatan penutup

Menghubungkan OpenClaw ke CometAPI adalah pantas dan membuka backend berbilang model yang berkuasa untuk pembantu peribadi anda. Tetapi kelajuan bukan alasan untuk mengabaikan keselamatan: ikat gerbang kepada localhost semasa ujian, gunakan senarai benarkan, log segala-galanya, dan minta pengesahan bagi tindakan yang destruktif. Dengan kawalan tersebut, anda boleh pergi dari sifar ke ejen OpenClaw → CometAPI yang berfungsi dalam kira-kira lima minit — dan memastikan data serta sistem anda dilindungi semasa anda bereksperimen.

Pembangun boleh mengakses kimi k-2.5 melalui CometAPI sekarang.Untuk bermula, jelajahi keupayaan model dalam Playground dan rujuk panduan API untuk arahan terperinci. Sebelum mengakses, sila pastikan anda telah log masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga rasmi untuk membantu anda berintegrasi.

Sedia untuk bermula?→ Daftar untuk OpenClaw hari ini !

Jika anda mahu mengetahui lebih banyak petua, panduan dan berita tentang AI ikuti kami di VK, X dan Discord!

Baca Lagi

500+ Model dalam Satu API

Sehingga 20% Diskaun