Configure
o OpenClaw
via CometAPI
Use o CometAPI como provedor de modelos personalizado para o OpenClaw: uma API, 500+ modelos, até 20% de desconto. Este guia está alinhado com o fluxo de integração atual do OpenClaw (2026.3.8+) e cobre instalação, configuração de provedores, verificação e troca de modelos.
# Apenas exemplo—verificar com sua versão do OpenClaw antes da produção
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/claude-sonnet-4-6"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
}
}
}
}Escopo do guia
e pré-requisitos
Configure o OpenClaw com CometAPI
Use o CometAPI como provedor de modelos personalizado para o OpenClaw e acesse 500+ modelos em uma única API, com até 20% de desconto em rotas suportadas. Esta página segue o fluxo de integração atual do OpenClaw (2026.3.8+).
Pré-requisitos
Node.js >= 22 e uma chave API CometAPI são necessários. Para instalações daemon, armazene COMETAPI_KEY em ~/.openclaw/.env para que openclaw.json possa referenciar ${COMETAPI_KEY} sem codificar segredos.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COMETAPI_KEY=%s\n' 'your_cometapi_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 três provedores
para uma chave CometAPI
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 CometAPI apenas conforme definido na documentação ao vivo.
{
"agents": {
"defaults": {
"model": {
"primary": "cometapi-claude/claude-sonnet-4-6"
}
}
},
"models": {
"mode": "merge",
"providers": {
"cometapi-openai": {
"baseUrl": "https://api.cometapi.com/v1",
"apiKey": "${COMETAPI_KEY}",
"api": "openai-completions",
"models": [{ "id": "gpt-5.4", "name": "GPT-5.4" }]
},
"cometapi-claude": {
"baseUrl": "https://api.cometapi.com",
"apiKey": "${COMETAPI_KEY}",
"api": "anthropic-messages",
"models": [{ "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }]
},
"cometapi-google": {
"baseUrl": "https://api.cometapi.com/v1beta",
"apiKey": "${COMETAPI_KEY}",
"api": "google-generative-ai",
"models": [{ "id": "gemini-3.1-pro-preview", "name": "Gemini 3.1 Pro" }]
}
}
}
}A configuração básica não requer criar manualmente auth-profiles.json. Use ${COMETAPI_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 CometAPI
A tabela abaixo usa preços ilustrativos por milhão de tokens. O catálogo de modelos, descontos e SLAs correspondem ao que Documentação e console do CometAPI mostra agora.
| Modelo (amostra) | Entrada / 1M tokens | Saída / 1M tokens | Nota |
|---|---|---|---|
| Claude Opus 4.6 | $4.00 | $20.00 | De dados de referência |
| MiniMax-M2.7 | $0.24 | $0.96 | De dados de referência |
| GLM 5 Turbo | $0.96 | $3.26 | De dados de referência |
| GPT-5.4 pro | $24.00 | $144 | De dados de referência |
| Gemini 3.1 Pro | $1.60 | $9.60 | De dados de referência |
| qwen3.5-plus | $0.32 | $1.92 | De dados de referência |
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 ${COMETAPI_KEY}. Use auth-profiles.json apenas para secrets armazenados por perfil ou rotação.
Por que há 3 entradas de provedor para um único fornecedor?
O OpenClaw roteia por compatibilidade de formato de API. Mantenha entradas separadas para openai-completions, anthropic-messages e google-generative-ai se precisar de todas as três famílias de API.
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?
gpt-5.4, claude-sonnet-4-6 e gemini-3.1-pro-preview. Você pode adicionar qualquer modelo da página de modelos do CometAPI ao bloco de provedor correspondente.