> ## Documentation Index
> Fetch the complete documentation index at: https://apidoc.cometapi.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Gunakan OpenClaw dengan CometAPI
> Gunakan panduan ini untuk mengonfigurasi OpenClaw dengan CometAPI dengan menetapkan base URL, API key, serta opsi model atau provider.
Gunakan [CometAPI](https://www.cometapi.com) sebagai provider model untuk [OpenClaw](https://openclaw.ai) — 500+ model dalam satu API.
## Prasyarat
* Node.js ≥ 22 — direkomendasikan melalui [nvm](https://github.com/nvm-sh/nvm)
* Akun CometAPI dengan API key yang aktif — [dapatkan di sini](https://www.cometapi.com/console/token)
## Instalasi
Masuk ke [console CometAPI](https://www.cometapi.com/console/token). Klik **Add API Key** lalu salin CometAPI API key Anda.
**Direkomendasikan** — gunakan installer resmi:
```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```
Atau instal melalui npm:
```bash theme={null}
npm install -g openclaw@latest
```
Lalu jalankan wizard setup sekali:
```bash theme={null}
openclaw onboard --install-daemon
```
Selama onboarding, pilih **Skip** pada langkah Model/Auth jika Anda ingin mengonfigurasi CometAPI secara manual. Setelah onboarding, pastikan gateway sedang berjalan:
```bash theme={null}
openclaw gateway status
openclaw dashboard
```
## Konfigurasi
Tulis kunci Anda ke `~/.openclaw/.env` agar tersedia untuk daemon tanpa di-hardcode di file konfigurasi:
```bash theme={null}
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
```
Jika Anda sudah menyuntikkan `COMETAPI_KEY` melalui shell, service manager, atau alur kerja secrets, lewati langkah ini — konfigurasi di bawah menggunakan `$\{COMETAPI_KEY\}` terlepas dari bagaimana variabel tersebut diatur.
CometAPI mendukung **empat format API**. Tambahkan satu atau beberapa blok provider ke `~/.openclaw/openclaw.json`:
| Provider | Format API | Endpoint yang dipanggil | Base URL |
| --------------------------- | ---------------------- | --------------------------- | --------------------------------- |
| `cometapi-openai` | `openai-completions` | `POST /v1/chat/completions` | `https://api.cometapi.com/v1` |
| `cometapi-openai-responses` | `openai-responses` | `POST /v1/responses` | `https://api.cometapi.com/v1` |
| `cometapi-claude` | `anthropic-messages` | `POST /messages` | `https://api.cometapi.com` |
| `cometapi-google` | `google-generative-ai` | `POST /v1beta/...` | `https://api.cometapi.com/v1beta` |
```json theme={null}
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/your-claude-model-id"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "your-chat-model-id", "name": "OpenAI-compatible text model" }]
},
"cometapi-openai-responses": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-responses",
"models": [{ "id": "your-responses-model-id", "name": "Responses API model" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "your-claude-model-id", "name": "Claude family model" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "your-gemini-model-id", "name": "Gemini family model" }]
}
}
}
}
```
Anda dapat hanya menyimpan provider yang Anda perlukan, atau menyimpan keempatnya untuk merutekan antar format menggunakan referensi `provider/model`.
Ganti setiap placeholder `your-...-model-id` dengan model ID saat ini dari [halaman Models CometAPI](https://www.cometapi.com/models/) yang sesuai dengan blok provider.
Gunakan `cometapi-openai-responses` (`api: "openai-responses"`) untuk model yang memerlukan OpenAI Responses API. Gunakan `cometapi-openai` (`api: "openai-completions"`) untuk model pada jalur Chat Completions klasik. Keduanya berbagi `baseUrl` yang sama (`https://api.cometapi.com/v1`); satu-satunya perbedaan adalah endpoint downstream mana yang dipanggil oleh OpenClaw.
File `auth-profiles.json` **tidak diperlukan** untuk setup ini. Kunci provider di-resolve dari `models.providers.*.apiKey` melalui env var `$\{COMETAPI_KEY\}`. `auth-profiles.json` hanya diperlukan jika Anda menginginkan rotasi kredensial per profil di beberapa kunci.
## Verifikasi
Mulai ulang gateway setelah menambahkan `.env` atau mengubah config provider:
```bash theme={null}
openclaw gateway restart
```
Lalu jalankan diagnostik:
```bash theme={null}
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
```
Setup yang berhasil terlihat seperti:
* `openclaw models status` me-resolve model utama ke `cometapi-claude/your-claude-model-id` tanpa peringatan missing-auth untuk provider CometAPI
* `openclaw models list --provider cometapi-claude` menampilkan model yang Anda konfigurasi
* `openclaw doctor` melaporkan tidak ada error config atau auth untuk provider CometAPI
## Ganti model
```bash theme={null}
# Set the default model in config
openclaw models set cometapi-claude/your-claude-model-id
# Switch for the current chat session
/model cometapi-openai/your-chat-model-id
/model cometapi-openai-responses/your-responses-model-id
/model cometapi-claude/your-claude-model-id
/model cometapi-google/your-gemini-model-id
```
## Pemecahan masalah
Jika Anda sedang memperbaiki setup lama yang rusak, hentikan gateway, hapus `~/.openclaw`, lalu jalankan ulang onboarding sebelum menerapkan konfigurasi CometAPI:
```bash theme={null}
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
```
Ini akan menghapus semua konfigurasi lokal, sesi, log, status auth, dan workspace. Lalu ikuti kembali Langkah 3–5.