> ## 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.
# Usa OpenClaw con CometAPI
> Usa questa guida per configurare OpenClaw con CometAPI impostando il base URL, la chiave API e le opzioni di model o provider.
Usa [CometAPI](https://www.cometapi.com) come provider di modelli per [OpenClaw](https://openclaw.ai) — oltre 500 modelli in un'unica API.
## Prerequisiti
* Node.js ≥ 22 — consigliato tramite [nvm](https://github.com/nvm-sh/nvm)
* Un account CometAPI con una chiave API attiva — [ottienila qui](https://www.cometapi.com/console/token)
## Installazione
Accedi alla [console CometAPI](https://www.cometapi.com/console/token). Fai clic su **Add API Key** e copia la tua chiave API CometAPI.
**Consigliato** — usa l'installer ufficiale:
```bash theme={null}
curl -fsSL https://openclaw.ai/install.sh | bash
```
Oppure installa tramite npm:
```bash theme={null}
npm install -g openclaw@latest
```
Quindi esegui una volta la procedura guidata di configurazione:
```bash theme={null}
openclaw onboard --install-daemon
```
Durante l'onboarding, scegli **Skip** nel passaggio Model/Auth se vuoi configurare CometAPI manualmente. Dopo l'onboarding, verifica che il gateway sia in esecuzione:
```bash theme={null}
openclaw gateway status
openclaw dashboard
```
## Configurazione
Scrivi la tua chiave in `~/.openclaw/.env` così sarà disponibile al daemon senza essere codificata direttamente nei file di configurazione:
```bash theme={null}
printf 'COMETAPI_KEY=%s\n' "$COMETAPI_KEY" >> ~/.openclaw/.env
chmod 600 ~/.openclaw/.env
```
Se inserisci già `COMETAPI_KEY` tramite la tua shell, il gestore di servizi o un workflow di secrets, salta questo passaggio — la configurazione seguente usa `$\{COMETAPI_KEY\}` indipendentemente da come viene impostata la variabile.
CometAPI supporta **quattro formati API**. Aggiungi uno o più blocchi provider a `~/.openclaw/openclaw.json`:
| Provider | Formato API | Endpoint chiamato | URL di base |
| --------------------------- | ---------------------- | --------------------------- | --------------------------------- |
| `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" }]
}
}
}
}
```
Puoi mantenere solo i provider di cui hai bisogno, oppure tenerli tutti e quattro per instradare tra i formati usando riferimenti `provider/model`.
Sostituisci ogni segnaposto `your-...-model-id` con un model ID attuale dalla [pagina Models di CometAPI](https://www.cometapi.com/models/) che corrisponda al blocco provider.
Usa `cometapi-openai-responses` (`api: "openai-responses"`) per i modelli che richiedono l'API OpenAI Responses. Usa `cometapi-openai` (`api: "openai-completions"`) per i modelli nel classico percorso Chat Completions. Entrambi condividono lo stesso `baseUrl` (`https://api.cometapi.com/v1`); l'unica differenza è quale endpoint downstream OpenClaw chiama.
Il file `auth-profiles.json` **non è richiesto** per questa configurazione. Le chiavi provider vengono risolte da `models.providers.*.apiKey` tramite la variabile d'ambiente `$\{COMETAPI_KEY\}`. `auth-profiles.json` è necessario solo se vuoi una rotazione delle credenziali per profilo tra più chiavi.
## Verifica
Riavvia il gateway dopo aver aggiunto `.env` o modificato la configurazione del provider:
```bash theme={null}
openclaw gateway restart
```
Poi esegui la diagnostica:
```bash theme={null}
openclaw models status
openclaw models list --provider cometapi-claude
openclaw doctor
```
Una configurazione riuscita appare così:
* `openclaw models status` risolve il modello principale in `cometapi-claude/your-claude-model-id` senza avvisi di autenticazione mancante per i provider CometAPI
* `openclaw models list --provider cometapi-claude` elenca i modelli che hai configurato
* `openclaw doctor` non segnala errori di configurazione o autenticazione per i provider CometAPI
## Cambiare modello
```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
```
## Risoluzione dei problemi
Se stai correggendo una configurazione precedente danneggiata, arresta il gateway, rimuovi `~/.openclaw`, quindi riesegui l'onboarding prima di applicare la configurazione di CometAPI:
```bash theme={null}
openclaw gateway stop
rm -rf ~/.openclaw
openclaw onboard --install-daemon
```
Questo rimuove tutta la configurazione locale, le sessioni, i log, lo stato di autenticazione e gli spazi di lavoro. Quindi segui di nuovo i passaggi 3–5.