OpenClaw + OmniaKey: um provedor, três famílias de modelos
Adicione a OmniaKey ao OpenClaw como um provedor compatível com OpenAI e rode Claude, GPT e Gemini por id de modelo — incluindo o passo de allowlist que todo mundo esquece.
O OpenClaw é um framework, não um assistente pronto: ele entrega o loop do agente, o uso de ferramentas e a edição de código, mas a inteligência vem do provedor que você conecta. Por isso a configuração do provedor é o arquivo mais importante que você vai editar — e a OmniaKey se encaixa nele como uma única entrada compatível com OpenAI que alcança Claude, GPT e Gemini de uma vez.
Adicione a OmniaKey como provedor
A configuração de provedores 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" }
]
}
}
}
}
"mode": "merge" diz ao OpenClaw para adicionar este provedor à sua config atual em vez de substituí-la inteira — mantenha essa linha se você já tem provedores definidos. Um provedor compatível com OpenAI cobre três famílias de modelos: a OmniaKey roteia por id de modelo, então claude-opus-4-8, gpt-5.5 e gemini-3.1-pro-preview passam todos pela mesma entrada.
O passo que todo mundo esquece: coloque o modelo no allowlist
Definir o provedor é só metade. O OpenClaw também exige o modelo no allowlist, ou você cai no clássico erro model not allowed mesmo com a chave certa. Isto vai no mesmo openclaw.json, ao lado do bloco models — models e agents são chaves de nível superior irmãs. Adicione o ref completo — provider/model-id — em agents.defaults:
{
"agents": {
"defaults": {
"models": ["omniakey/claude-opus-4-8", "omniakey/gpt-5.5", "omniakey/gemini-3.1-pro-preview"],
"model": "omniakey/claude-opus-4-8"
}
}
}
O corpo da requisição leva só o id do modelo; o ref provider/model-id é o nome interno do OpenClaw. Tanto a definição do provedor quanto a entrada no allowlist são necessárias — fazem trabalhos diferentes, e é justamente por isso que muita gente configura o provedor, esquece o allowlist e fica travada.
Verifique
openclaw doctor
O doctor checa o arquivo de config, o provedor, o formato da chave, uma conexão ao vivo e o acesso ao modelo. Depois openclaw models list deve mostrar seus modelos OmniaKey, e você pode definir o modelo ativo como omniakey/gpt-5.5 — ou qualquer id que tenha colocado no allowlist — em agents.defaults.
Não edite ~/.openclaw/agents/main/agent/models.json na mão — ele é regenerado a partir do openclaw.json. E se errar o JSON, é só pedir para o OpenClaw consertar o arquivo; ele é bom em achar a vírgula que faltou.
Por que passar o OpenClaw pela OmniaKey
Uma chave e um saldo para as três famílias, cobrança por token sem plano mensal — e nenhuma substituição silenciosa. A OmniaKey roda exatamente o id de modelo que você colocou no allowlist; se um upstream cair, você vê o erro em vez de um "equivalente" trocado em silêncio que, no meio da tarefa, entende a sua base de código de outro jeito.
O guia de agentes de código cobre as outras ferramentas.