Configura
OpenClaw
via CometAPI
Usa CometAPI come provider di modelli personalizzato per OpenClaw: un'API, 500+ modelli, fino al 20% di sconto. Questa guida è allineata con l'attuale flusso di onboarding di OpenClaw (2026.3.8+) e copre installazione, configurazione del provider, verifica e cambio di modello.
# Solo esempio—verificare con la propria versione di OpenClaw prima della produzione
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/claude-sonnet-4-6"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
}
}
}
}Portata della guida
e prerequisiti
Configura OpenClaw con CometAPI
Usa CometAPI come provider di modelli personalizzato per OpenClaw per accedere a 500+ modelli in un'unica API, con fino al 20% di sconto sulle rotte supportate. Questa pagina segue l'attuale flusso di onboarding di OpenClaw (2026.3.8+).
Prerequisiti
Sono richiesti Node.js >= 22 e una chiave API CometAPI. Per le installazioni daemon, memorizza COMETAPI_KEY in ~/.openclaw/.env in modo che openclaw.json possa fare riferimento a ${COMETAPI_KEY} senza codificare i segreti.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COMETAPI_KEY=%s\n' 'your_cometapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Dopo aver aggiunto ~/.openclaw/.env o modificato la configurazione del provider, riavvia una volta con openclaw gateway restart, poi esegui la diagnostica. Usa riferimenti completi provider/model in tutti i comandi e le sessioni. Per la deriva di versione, ricontrolla il Riferimento alla configurazione.
Perché tre provider
per una chiave CometAPI
Installare, integrare, configurare,
verificare, cambiare
OpenClaw usa ~/.openclaw/openclaw.json come configurazione sorgente che modifichi. I provider personalizzati vengono materializzati in file models.json per agente sotto ~/.openclaw/agents/<agentId>/. Ricontrolla chiavi e comportamento dopo gli aggiornamenti usando le guide Riferimento alla configurazione e Variabili d'ambiente . Tratta gli URL base di CometAPI solo come definiti nella documentazione live.
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/claude-sonnet-4-6"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
}
}
}
}La configurazione base non richiede la creazione manuale di auth-profiles.json. Usa ${COMETAPI_KEY} nei provider e inietta la variabile tramite ~/.openclaw/.env, shell o gestore di servizi.
Prezzi in tempo reale
sul sito CometAPI
La tabella seguente usa prezzi illustrativi per milione di token. Il catalogo modelli, gli sconti e gli SLA corrispondono a ciò che Documentazione e console CometAPI mostra attualmente.
| Modello (esempio) | Input / 1M token | Output / 1M token | Nota |
|---|---|---|---|
| Claude Opus 4.6 | $4.00 | $20.00 | Da dati di riferimento |
| MiniMax-M2.7 | $0.24 | $0.96 | Da dati di riferimento |
| GLM 5 Turbo | $0.96 | $3.26 | Da dati di riferimento |
| GPT-5.4 pro | $24.00 | $144 | Da dati di riferimento |
| Gemini 3.1 Pro | $1.60 | $9.60 | Da dati di riferimento |
| qwen3.5-plus | $0.32 | $1.92 | Da dati di riferimento |
Controlla questo
prima di integrare
Ho bisogno di auth-profiles.json per questa configurazione?
No per la configurazione base. OpenClaw può risolvere l'apiKey del provider da models.providers.*.apiKey via ${COMETAPI_KEY}. Usa auth-profiles.json solo per i segreti memorizzati per profilo o la rotazione.
Perché ci sono 3 voci di provider per un singolo fornitore?
OpenClaw instrada per compatibilità del formato API. Mantieni voci separate per openai-completions, anthropic-messages e google-generative-ai se hai bisogno di tutte e tre le famiglie API.
Dove viene effettivamente modificata e materializzata la configurazione?
Modifica ~/.openclaw/openclaw.json. I provider personalizzati vengono materializzati in models.json per agente sotto ~/.openclaw/agents/<agentId>/ dopo sync/load.
Quali ID modello vengono usati in questa guida?
gpt-5.4, claude-sonnet-4-6 e gemini-3.1-pro-preview. Puoi aggiungere qualsiasi modello dalla pagina modelli di CometAPI al blocco provider corrispondente.