Usa OpenClaw con CometAPI

Usa CometAPI come provider di modelli per OpenClaw — oltre 500 modelli in un’unica API.

Prerequisiti

Node.js ≥ 22 — consigliato tramite nvm
Un account CometAPI con una chiave API attiva — ottienila qui

Installazione

Ottieni la tua chiave API CometAPI

Accedi alla console CometAPI. Fai clic su Add API Key e copia la tua chiave API CometAPI.

Dashboard CometAPI che mostra il pulsante Add API Key

Dettagli della chiave API CometAPI con base URL

Installa o aggiorna OpenClaw

Consigliato — usa l’installer ufficiale:

curl -fsSL https://openclaw.ai/install.sh | bash

Oppure installa tramite npm:

npm install -g openclaw@latest

Quindi esegui una volta la procedura guidata di configurazione:

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:

openclaw gateway status
openclaw dashboard

Configurazione

Memorizza la tua chiave CometAPI

Scrivi la tua chiave in ~/.openclaw/.env così sarà disponibile al daemon senza essere codificata direttamente nei file di configurazione:

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.

Configura i provider CometAPI

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`

{
  "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 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 e verifica

Riavvia il gateway dopo aver aggiunto .env o modificato la configurazione del provider:

openclaw gateway restart

Poi esegui la diagnostica:

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

OpenClaw models status che mostra i provider CometAPI autenticati

Cambiare modello

# 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

Reinstallazione pulita (opzionale)

Se stai correggendo una configurazione precedente danneggiata, arresta il gateway, rimuovi ~/.openclaw, quindi riesegui l’onboarding prima di applicare la configurazione di CometAPI:

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.

Panoramica

Agenti AI per la programmazione

Agenti AI

Client di chat AI

Traduzione e linguaggio

Piattaforme di automazione

Osservabilità e valutazione

Framework AI

Prerequisiti

Installazione

Configurazione

Verifica

Cambiare modello

Risoluzione dei problemi

​Prerequisiti

​Installazione

​Configurazione

​Verifica

​Cambiare modello

​Risoluzione dei problemi

Prerequisiti

Installazione

Configurazione

Verifica

Cambiare modello

Risoluzione dei problemi