Configura
OpenClaw
via CometAPI
Usa CometAPI como proveedor de modelos personalizado para OpenClaw: una API, 500+ modelos, hasta un 20% de descuento. Esta guía está alineada con el flujo de incorporación actual de OpenClaw (2026.3.8+) y cubre la instalación, configuración de proveedores, verificación y cambio de modelos.
# Solo de muestra—verificar con tu versión de OpenClaw antes de producción
{
"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" }]
}
}
}
}Alcance de la guía
y requisitos previos
Configura OpenClaw con CometAPI
Usa CometAPI como proveedor de modelos personalizado para OpenClaw y accede a 500+ modelos en una sola API, con hasta un 20% de descuento en rutas soportadas. Esta página sigue el flujo de incorporación actual de OpenClaw (2026.3.8+).
Requisitos previos
Se requieren Node.js >= 22 y una clave API de CometAPI. Para instalaciones daemon, almacena COMETAPI_KEY en ~/.openclaw/.env para que openclaw.json pueda hacer referencia a ${COMETAPI_KEY} sin codificar secretos.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COMETAPI_KEY=%s\n' 'your_cometapi_key' >> ~/.openclaw/.env chmod 600 ~/.openclaw/.env
Después de agregar ~/.openclaw/.env o editar la configuración del proveedor, reinicia una vez con openclaw gateway restart, luego ejecuta diagnósticos. Usa referencias completas provider/model en todos los comandos y sesiones. Para deriva de versión, re-verifica la Referencia de configuración.
Por qué tres proveedores
para una clave CometAPI
Instalar, incorporar, configurar,
verificar, cambiar
OpenClaw usa ~/.openclaw/openclaw.json como la configuración fuente que editas. Los proveedores personalizados se materializan en archivos models.json por agente bajo ~/.openclaw/agents/<agentId>/. Re-verifica claves y comportamiento después de actualizaciones usando las guías Referencia de configuración y Variables de entorno . Trata las URL base de CometAPI solo como están definidas en la documentación en 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" }]
}
}
}
}La configuración básica no requiere crear manualmente auth-profiles.json. Usa ${COMETAPI_KEY} en los proveedores e inyecta la variable a través de ~/.openclaw/.env, shell o gestor de servicios.
Los precios en vivo
en el sitio de CometAPI
La tabla a continuación usa precios ilustrativos por millón de tokens. El catálogo de modelos, descuentos y SLA corresponden a lo que Documentación y consola de CometAPI muestra ahora mismo.
| Modelo (muestra) | Entrada / 1M tokens | Salida / 1M tokens | Nota |
|---|---|---|---|
| Claude Opus 4.6 | $4.00 | $20.00 | De datos de referencia |
| MiniMax-M2.7 | $0.24 | $0.96 | De datos de referencia |
| GLM 5 Turbo | $0.96 | $3.26 | De datos de referencia |
| GPT-5.4 pro | $24.00 | $144 | De datos de referencia |
| Gemini 3.1 Pro | $1.60 | $9.60 | De datos de referencia |
| qwen3.5-plus | $0.32 | $1.92 | De datos de referencia |
Verifica esto
antes de integrar
¿Necesito auth-profiles.json para esta configuración?
No para la configuración básica. OpenClaw puede resolver el apiKey del proveedor desde models.providers.*.apiKey via ${COMETAPI_KEY}. Usa auth-profiles.json solo para secrets almacenados por perfil o rotación.
¿Por qué hay 3 entradas de proveedor para un proveedor?
OpenClaw enruta por compatibilidad de formato API. Mantén entradas separadas para openai-completions, anthropic-messages y google-generative-ai si necesitas las tres familias de API.
¿Dónde se edita y materializa realmente la configuración?
Edita ~/.openclaw/openclaw.json. Los proveedores personalizados se materializan en models.json por agente bajo ~/.openclaw/agents/<agentId>/ después de sync/load.
¿Qué IDs de modelos se usan en esta guía?
gpt-5.4, claude-sonnet-4-6 y gemini-3.1-pro-preview. Puedes agregar cualquier modelo de la página de modelos de CometAPI al bloque de proveedor correspondiente.