Pada awal tahun 2026, OpenClaw — platform runtime ejen dan pembantu AI sumber terbuka — terus diterima meluas oleh pembangun, pasukan penyelidikan dan perusahaan yang mahukan orkestrasi berbilang model merentas saluran seperti Slack, Telegram, WhatsApp, dan pelaksanaan baris perintah setempat. Pada masa yang sama, CometAPI telah muncul sebagai gerbang LLM serasi OpenAI yang berkuasa, mengagregasikan ratusan model (cth., Kimi-K2.5, varian GPT, Claude) di bawah satu titik akhir API.
Artikel ini berfungsi sebagai panduan praktikal langkah demi langkah untuk mengkonfigurasi OpenClaw supaya ia boleh menggunakan CometAPI sebagai penyedia modelnya. Anda akan mempelajari cara memasang, menyediakan penyedia, mentakrif profil pengesahan, mengesahkan kefungsian, dan bertukar antara model — semuanya dengan contoh konfigurasi langsung dan petua berdasarkan dokumentasi terkini serta maklum balas komuniti.
Apakah itu OpenClaw dan mengapa mengintegrasikannya dengan CometAPI?
OpenClaw ialah platform ejen berasaskan peranti sumber terbuka yang menghubungkan AI perbualan kepada aplikasi sembang dan peranti yang sudah digunakan orang ramai — 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 repo mengandungi contoh yang menunjukkan cara OpenClaw memilih penyedia LLM melalui konfigurasi gaya gerbang.
CometAPI ialah platform pengagregatan API yang mendedahkan banyak penyedia model melalui antara muka REST gaya OpenAI tunggal dan SDK. Itu menjadikannya mudah sebagai titik integrasi tunggal jika anda mahu bertukar model, menguji harga, atau memusatkan kebolehcerapan tanpa menukar kod teras OpenClaw.
Mengapa Padankan OpenClaw dengan CometAPI?
OpenClaw tidak bergantung pada model; ia menjalankan ejen dan aliran kerja tetapi bergantung pada penyedia 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 diagregatkan oleh CometAPI
Ini memberikan anda pilihan, fleksibiliti, kawalan kos, dan redunan.
Bagaimanakah saya mengkonfigurasi OpenClaw untuk menggunakan CometAPI sebagai penyedia model?
Jawapan: Tambahkan entri penyedia pada konfigurasi OpenClaw anda yang menghala ke titik akhir REST CometAPI dan petakan model kepada struktur models.providers OpenClaw. Projek OpenClaw menyokong penambahan penyedia tersuai melalui models.providers (pola yang sama digunakan untuk gerbang lain) dan menjangkakan “perisa” api seperti "openai-completions" atau "anthropic-messages" bergantung pada semantik penyedia.
CometAPI menyokong tiga format API. Tambahkan satu atau lebih pada ~/.openclaw/openclaw.json:
| Penyedia | Format API | URL Asas |
|---|---|---|
| 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 |
Apakah Prasyarat untuk Mengkonfigurasi OpenClaw dengan CometAPI?
Sebelum integrasi, pastikan anda mempunyai persekitaran, alatan 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)
- Akses terminal dengan bash/zsh atau PowerShell
Dokumen rasmi juga menyebut bahawa OpenClaw boleh dijalankan melalui Docker, yang sesuai untuk tetapan terasing dan produksi.
Akaun dan Kunci API
Anda perlukan:
- Akaun CometAPI
- Kunci LLM CometAPI yang sah (disimpan dalam pembolehubah persekitaran yang selamat)
- Pilihan: Akaun untuk penyedia OpenClaw tambahan (OpenAI, Anthropic, model setempat 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 tetapan ringkas dan praktikal selama lima minit. Nama fail atau kunci yang tepat bergantung pada versi dan penyebaran OpenClaw anda, tetapi konsepnya terus diterjemah daripada repo dan dokumen rasmi OpenClaw.
Langkah 0 — Tetapkan pembolehubah persekitaran (jalan 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 menyebar ke produksi atau mahukan pengasingan:
docker pull openclaw/openclaw:latestdocker run -d --name openclaw -v ~/.openclaw:/root/.openclaw openclaw/openclaw
Penyebaran berbekas memudahkan pengurusan kebergantungan dan beban kerja.versi nClaw; contoh OpenClaw mengikuti corak ini.)
Langkah 2 — Konfigurasi Penyedia
Mengkonfigurasi penyedia memberitahu OpenClaw di mana hendak mendapatkan backend LLM anda.
Mengedit Fail Konfigurasi OpenClaw
OpenClaw menyimpan konfigurasinya dalam fail JSON di:
~/.openclaw/openclaw.json
Anda akan mentakrifkan penyedia tersuai untuk CometAPI.
Berikut konfigurasi penyedia minimum:
base_urlmemberitahu OpenClaw untuk menghantar permintaan LLM ke titik akhir serasi OpenAI CometAPI.auth_envmerujuk kepada pembolehubah persekitaran yang menyimpan kunci API anda.- Bendera
typemenetapkan 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 penyedia menggunakan kunci yang sama.
Anda boleh menambah mana-mana model daripada Halaman Model CometAPI pada penyedia yang sepadan.
Langkah 3 — Konfigurasi Profil Auth
⚠️ Diperlukan! OpenClaw membaca kunci API daripada fail ini, bukan daripada
openclaw.json. Melangkau ini akan menyebabkan ralatHTTP 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
Semak status dengan:
openclaw auth status
Dan untuk menyenaraikan semua model yang dikonfigurasi:
openclaw models list
Perintah ini mengesahkan sama ada penyedia dan profil auth anda disediakan dengan betul. Semua model harus memaparkan 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 perhatikan log
Mulakan/ mula semula OpenClaw dan ekor log. Lihat khususnya untuk:
- Log permintaan keluar yang memaparkan
base_urlatau nama penyedia. - HTTP 401/403 → isu kunci atau skop.
- 429 → had kadar (pertimbangkan perubahan model/prestasi).
- Kependaman terlalu lama → rangkaian atau pendikit 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, tugasan 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 gesaan (serta 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 patut anda tambah?
Apabila anda memusatkan kepada pengagregator, anda memperoleh kawalan — tetapi anda mesti mengkonfigurasikannya:
Instrumentasi
- Log nama model, penggunaan token, kependaman, dan kod ralat untuk setiap permintaan.
- Tagkan permintaan dengan ejen dan saluran (cth., agent=personal_assistant, channel=telegram) supaya anda boleh mengatributkan kos.
Tuil kawalan kos
- Tetapkan
max_tokensdantimeout_secondsdalam konfigurasi penyedia anda. - Gunakan model yang lebih murah untuk tugas rutin dan simpan model besar untuk aliran bernilai tinggi.
- Konfigurasikan had kadar per ejen dan kuota per pengguna (OpenClaw selalunya boleh diperluas untuk menguatkuasakannya).
CometAPI mengiklankan peralatan untuk penalaan prestasi dan kos; gunakan telemetri kedua-dua pihak (log OpenClaw + metrik penggunaan CometAPI) untuk mencipta pagar pengawal.
Bagaimana saya menyelesaikan ralat biasa dalam integrasi?
Jawapan: Berikut mod kegagalan biasa dan cara menyelesaikannya dengan cepat:
Pembaikan: Panel kawalan OpenClaw akan menunjukkan token sekali guna; tampal ke tetapan UI Kawalan mengikut dokumen. Nota komuniti kerap merujuk langkah ini.
401 Unauthorized
Punca: COMETAPI_KEY hilang, salah, atau tidak disuntik ke proses OpenClaw.
Pembaikan: Eksport kunci dalam shell yang melancarkan OpenClaw atau tuliskannya ke .env OpenClaw anda dan mulakan semula gerbang. Sahkan dengan ujian curl.
Penyedia senyap kembali / lalai
Punca: JSON models.providers tidak terbentuk dengan betul atau api hilang, menyebabkan OpenClaw mengabaikan penyedia.
Pembaikan: Sahkan openclaw.json (lint JSON) dan pastikan api sepadan dengan perisa yang disokong. Thread isu komuniti menunjukkan salah konfigurasi ini kerap berlaku.
Had masa tamat atau kependaman tinggi
Punca: laluan rangkaian atau kelambatan model jauh.
Pembaikan: Pilih model Comet berpendam rendah atau hos OpenClaw berhampiran rantau awan yang sama; pertimbangkan untuk menjalankan model setempat bagi tugasan sensitif kependaman. Dokumentasi dan blog membincangkan pertukaran antara model setempat dan model API (kependaman vs kos).
Penggunaan berlebihan / 429
Punca: mencapai kuota atau had pelan CometAPI.
Pembaikan: Semak papan pemuka Comet untuk kuota; tambah logik retry/backoff dalam tindakan ejen OpenClaw atau cegah permintaan di gerbang. Comet dan dokumen rakan menonjolkan kuota pelan dan corak backoff yang disyorkan.
Token gerbang hilang / putus sambungan websocket
Punca: token kawalan OpenClaw hilang dalam konfigurasi papan pemuka ketika menjalankan Gerbang.
Nota penutup
Menyambungkan OpenClaw ke CometAPI adalah pantas dan membuka kunci backend berbilang model yang berkuasa untuk pembantu peribadi anda. Namun kelajuan bukan alasan untuk mengabaikan keselamatan: ikat gerbang ke localhost semasa menguji, guna senarai benarkan, log segala-galanya, dan minta pengesahan untuk tindakan merosakkan. Dengan kawalan tersebut, anda boleh pergi dari sifar ke ejen OpenClaw → CometAPI yang berfungsi dalam kira-kira lima minit — dan kekalkan data serta sistem anda dilindungi sambil anda bereksperimen.
Pembangun boleh mengakses kimi k-2.5 melalui CometAPI sekarang. Untuk bermula, terokai keupayaan model dalam Playground dan rujuk panduan API untuk arahan terperinci. Sebelum mengakses, pastikan anda telah log masuk ke CometAPI dan memperoleh kunci API. CometAPI menawarkan harga yang jauh lebih rendah daripada harga rasmi untuk membantu anda mengintegrasi.
Ready to Go?→ Daftar untuk OpenClaw hari ini !
Jika anda mahu mengetahui lebih banyak petua, panduan dan berita tentang AI ikuti kami di VK, X dan Discord!