Come configurare OpenClaw con OmniaKey: Provider e allowlist dei modelli
Aggiungi OmniaKey come Provider OpenAI-compatible in OpenClaw. Configura openclaw.json, allowlist dei modelli, doctor e l'errore model not allowed.
Chi cerca configurare OpenClaw API deve distinguere due passaggi: definire il Provider e autorizzare i modelli. OpenClaw fornisce il loop dell'agente e gli strumenti; il Provider fornisce il modello che risponde.
Aggiungere OmniaKey come Provider
La configurazione si trova in ~/.openclaw/openclaw.json. Aggiungi OmniaKey sotto models.providers:
{
"models": {
"mode": "merge",
"providers": {
"omniakey": {
"baseUrl": "https://api.omniakey.com/v1",
"apiKey": "your-omniakey-api-key",
"api": "openai-completions",
"models": [
{ "id": "claude-opus-4-8" },
{ "id": "gpt-5.5" },
{ "id": "gemini-3.1-pro-preview" },
{ "id": "grok-4.5" }
]
}
}
}
}
mode: merge aggiunge il Provider senza sostituire la configurazione esistente. Usa la tua chiave reale, ma non committarla né condividerla. Copia un ID esatto dal catalogo corrente.
Il passaggio spesso dimenticato: allowlist
Definire il Provider non basta. OpenClaw richiede che il modello sia anche nella allowlist. Nello stesso file aggiungi agents allo stesso livello di models:
{
"agents": {
"defaults": {
"models": [
"omniakey/claude-opus-4-8",
"omniakey/gpt-5.5",
"omniakey/gemini-3.1-pro-preview",
"omniakey/grok-4.5"
],
"model": "omniakey/claude-opus-4-8"
}
}
}
Il request body usa il model ID; provider/model-id è il riferimento interno di OpenClaw. Servono entrambe le voci. Senza allowlist puoi ricevere model not allowed anche con una chiave corretta.
Verificare
openclaw doctor
openclaw models list
doctor controlla file, Provider, formato della chiave, connessione live e accesso al modello. Poi puoi impostare omniakey/gpt-5.5 in agents.defaults.
Non modificare manualmente ~/.openclaw/agents/main/agent/models.json: viene rigenerato da openclaw.json.
Perché usare OmniaKey
Una chiave e un saldo per Claude, GPT, Gemini e Grok, con tariffazione a token. L'ID autorizzato è quello che viene eseguito, senza sostituzioni silenziose.
La guida agli agenti di coding copre gli altri strumenti.