Como configurar o OpenClaw com a OmniaKey: Provider e allowlist
Adicione a OmniaKey como Provider compatível com OpenAI no OpenClaw. Configure openclaw.json, a allowlist de modelos, o doctor e o erro model not allowed.
Quem pesquisa configurar OpenClaw API precisa separar duas etapas: definir o Provider e autorizar os modelos. O OpenClaw fornece o loop do agente e as ferramentas; o Provider fornece o modelo que responde.
Adicionar a OmniaKey como Provider
A configuração fica em ~/.openclaw/openclaw.json. Adicione a OmniaKey em 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 adiciona o Provider sem substituir a configuração existente. Use sua chave real, mas não a commite nem a compartilhe. Copie um ID exato do catálogo atual.
A etapa que muita gente esquece: allowlist do modelo
Definir o Provider não basta. O OpenClaw também exige que o modelo esteja na allowlist. No mesmo arquivo, adicione agents no mesmo nível de 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"
}
}
}
O corpo da requisição leva o model ID; provider/model-id é a referência interna do OpenClaw. As duas entradas são necessárias. Sem a allowlist, o erro pode ser model not allowed mesmo com a chave correta.
Verificar
openclaw doctor
openclaw models list
O doctor verifica arquivo, Provider, formato da chave, conexão ao vivo e acesso ao modelo. Depois você pode definir omniakey/gpt-5.5 em agents.defaults.
Não edite manualmente ~/.openclaw/agents/main/agent/models.json; ele é recriado a partir do openclaw.json.
Por que usar a OmniaKey
Uma chave e um saldo para Claude, GPT, Gemini e Grok, com cobrança por token. O ID autorizado é o que executa; não há troca silenciosa por um modelo “equivalente”.
O guia de agentes de programação cobre as outras ferramentas.