Configurar
o OpenClaw
via CoreAPI
Use CoreAPI como provedor de modelo personalizado para OpenClaw: uma API, inúmeros modelos a preços de tabela oficiais. Este guia segue o fluxo de integração atual do OpenClaw (2026.3.8+) e aborda instalação, configuração do provedor, verificação e troca de modelo.
# Apenas exemplo—verificar com sua versão do OpenClaw antes da produção
{
"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" }]
}
}
}
}Escopo do guia
e pré-requisitos
Configure o OpenClaw com CoreAPI
Use CoreAPI como um provedor de modelo personalizado para OpenClaw para acessar inúmeros modelos em uma API a preços de tabela oficiais. Esta página segue o fluxo de integração atual do OpenClaw (2026.3.8+).
Pré-requisitos
Node.js >= 22 e uma chave API CoreAPI são necessários. Para instalações daemon, armazene COREAPI_KEY em ~/.openclaw/.env para que openclaw.json possa referenciar $COREAPI_KEY sem codificar segredos.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Após adicionar ~/.openclaw/.env ou editar a configuração do provedor, reinicie uma vez com openclaw gateway restart, depois execute diagnósticos. Use referências completas provider/model em todos os comandos e sessões. Para desvio de versão, re-verifique a Referência de configuração.
Por que dois provedores
para uma chave CoreAPI
Instalar, integrar, configurar,
verificar, trocar
O OpenClaw usa ~/.openclaw/openclaw.json como a configuração fonte que você edita. Provedores personalizados são materializados em arquivos models.json por agente sob ~/.openclaw/agents/<agentId>/. Re-verifique chaves e comportamento após atualizações usando os guias Referência de configuração e Variáveis de ambiente . Trate as URLs base do CoreAPI apenas conforme definido na documentação ao vivo.
{
"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" }]
}
}
}
}A configuração básica não requer criar manualmente auth-profiles.json. Use ${COREAPI_KEY} nos provedores e injete a variável através de ~/.openclaw/.env, shell ou gerenciador de serviços.
Preços ao vivo no
site do CoreAPI
A tabela abaixo usa números ilustrativos por milhão de tokens. Catálogo de modelos, preços e SLAs seguem os termos atuais da CoreAPI. Documentação e console do CoreAPI mostra agora.
Verifique isso
antes de integrar
Preciso de auth-profiles.json para esta configuração?
Não para a configuração básica. O OpenClaw pode resolver o apiKey do provedor de models.providers.*.apiKey via $COREAPI_KEY. Use auth-profiles.json apenas para secrets armazenados por perfil ou rotação.
Por que há 2 entradas de provedor para um único fornecedor?
O OpenClaw roteia por compatibilidade de formato de API. Mantenha entradas separadas para openai-completions e anthropic-messages.
Onde a configuração é realmente editada e materializada?
Edite ~/.openclaw/openclaw.json. Os provedores personalizados são materializados em models.json por agente sob ~/.openclaw/agents/<agentId>/ após sync/load.
Quais IDs de modelo são usados neste guia?
deepseek-flash, claude-sonnet-4-5-20250929. Você pode adicionar qualquer modelo da página de modelos do CoreAPI ao bloco de provedor correspondente.