Configura
OpenClaw
tramite CoreAPI
Utilizza CoreAPI come fornitore di modelli personalizzati per OpenClaw: un'API, numerosi modelli a prezzi di listino ufficiali. Questa guida segue l'attuale flusso di onboarding di OpenClaw (2026.3.8+) e copre l'installazione, la configurazione del provider, la verifica e il cambio di modello.
# Solo esempio—verificare con la propria versione di OpenClaw prima della produzione
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}Portata della guida
e prerequisiti
Configura OpenClaw con CoreAPI
Utilizza CoreAPI come fornitore di modelli personalizzati per OpenClaw per accedere a numerosi modelli in un'unica API ai prezzi di listino ufficiali. Questa pagina segue l'attuale flusso di onboarding di OpenClaw (2026.3.8+).
Prerequisiti
Sono richiesti Node.js >= 22 e una chiave API CoreAPI. Per le installazioni daemon, memorizza COREAPI_KEY in ~/.openclaw/.env in modo che openclaw.json possa fare riferimento a $COREAPI_KEY senza codificare i segreti.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_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é due provider
per una chiave CoreAPI
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 CoreAPI solo come definiti nella documentazione live.
{
"agents": {
"defaults": {
"model": {
"primary": "coreapi-claude/claude-sonnet-4-5-20250929"
}
}
},
"models": {
"mode": "merge",
"providers": {
"coreapi-openai": {
"baseUrl": "https://unixcore.io/v1",
"apiKey": "${COREAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "deepseek-flash", "name": "DeepSeek Flash" }]
},
"coreapi-claude": {
"baseUrl": "https://unixcore.io",
"apiKey": "${COREAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-5-20250929", "name": "Claude Sonnet 4.5" }]
}
}
}
}La configurazione base non richiede la creazione manuale di auth-profiles.json. Usa ${COREAPI_KEY} nei provider e inietta la variabile tramite ~/.openclaw/.env, shell o gestore di servizi.
Prezzi in tempo reale
sul sito CoreAPI
La tabella seguente utilizza numeri illustrativi per milione di token. Il catalogo dei modelli, i prezzi e gli SLA seguono gli attuali termini CoreAPI. Documentazione e console CoreAPI mostra attualmente.
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 $COREAPI_KEY. Usa auth-profiles.json solo per i segreti memorizzati per profilo o la rotazione.
Perché ci sono 2 voci di provider per un singolo fornitore?
OpenClaw instrada per compatibilità del formato API. Mantieni voci separate per openai-completions e anthropic-messages.
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?
deepseek-flash, claude-sonnet-4-5-20250929. Puoi aggiungere qualsiasi modello dalla pagina modelli di CoreAPI al blocco provider corrispondente.