OpenClaw

Collega OpenClaw a CometAPI: installa tramite curl o npm, salva la tua chiave in ~/.openclaw/.env, configura i provider OpenAI/Anthropic/Google ed esegui oltre 500 modelli.

Usa CometAPI come provider di modelli per OpenClaw — oltre 500 modelli in un’unica API. Questa guida copre l’attuale flusso di onboarding (2026.3.8+).

​

Prerequisiti

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

1. Ottieni la tua chiave API di CometAPI

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

   

   
2. 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 setup:

   openclaw onboard --install-daemon
   

   Durante l’onboarding, scegli Skip nel passaggio Model/Auth se vuoi configurare CometAPI manualmente. Dopo l’onboarding, conferma che il gateway sia in esecuzione:

   openclaw gateway status
   openclaw dashboard
   
3. Salva la tua chiave CometAPI

   Scrivi la tua chiave in ~/.openclaw/.env in modo che sia disponibile al daemon senza essere codificata direttamente nei file di configurazione:

   printf 'COMETAPI_KEY=%s\n' 'your-sk-xxxxx-key' >> ~/.openclaw/.env
   chmod 600 ~/.openclaw/.env
   

   Se stai già iniettando COMETAPI_KEY tramite la tua shell, il service manager o un workflow di gestione dei secret, salta questo passaggio — la configurazione qui sotto usa $\{COMETAPI_KEY\} indipendentemente da come viene impostata la variabile.

4. Configura i provider CometAPI

   CometAPI supporta quattro formati API. Aggiungi uno o più blocchi provider a ~/.openclaw/openclaw.json:

   Provider	Formato API	Endpoint chiamato	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

   {
     "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 ID modello 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 percorso classico 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 del provider vengono risolte da models.providers.*.apiKey tramite la variabile env $\{COMETAPI_KEY\}. auth-profiles.json è necessario solo se vuoi una rotazione delle credenziali per profilo su più chiavi.

5. Riavvia e verifica

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

   openclaw gateway restart
   

   Quindi 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 primario 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 configurati
   • openclaw doctor non segnala errori di configurazione o autenticazione per i provider CometAPI

   
6. Cambia 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
   

Reinstallazione pulita (opzionale)

Se stai correggendo una vecchia configurazione non funzionante, arresta il gateway, rimuovi ~/.openclaw, quindi riesegui l’onboarding prima di applicare la configurazione 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 workspace. Poi segui di nuovo i passaggi 3–5.