Configura
OpenClaw
con CoreAPI
Utilice CoreAPI como proveedor de modelos personalizados para OpenClaw: una API, numerosos modelos a precios de lista oficiales. Esta guía sigue el flujo de incorporación actual de OpenClaw (2026.3.8+) y cubre la instalación, la configuración del proveedor, la verificación y el cambio de modelo.
# Solo de muestra—verificar con tu versión de OpenClaw antes de producción
{
"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" }]
}
}
}
}Alcance de la guía
y requisitos previos
Configura OpenClaw con CoreAPI
Utilice CoreAPI como proveedor de modelos personalizados para OpenClaw para acceder a numerosos modelos en una API a precios de lista oficiales. 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 CoreAPI. Para instalaciones daemon, almacena COREAPI_KEY en ~/.openclaw/.env para que openclaw.json pueda hacer referencia a $COREAPI_KEY sin codificar secretos.
openclaw onboard --install-daemon openclaw gateway status openclaw dashboard printf 'COREAPI_KEY=%s\n' 'your_coreapi_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é dos proveedores
para una clave CoreAPI
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 CoreAPI solo como están definidas en la documentación en 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" }]
}
}
}
}La configuración básica no requiere crear manualmente auth-profiles.json. Usa ${COREAPI_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 CoreAPI
La siguiente tabla utiliza números ilustrativos por millón de tokens. El catálogo de modelos, los precios y los SLA siguen los términos actuales de CoreAPI. Documentación y consola de CoreAPI muestra ahora mismo.
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 $COREAPI_KEY. Usa auth-profiles.json solo para secrets almacenados por perfil o rotación.
¿Por qué hay 2 entradas de proveedor para un proveedor?
OpenClaw enruta por compatibilidad de formato API. Mantén entradas separadas para openai-completions y anthropic-messages.
¿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?
deepseek-flash, claude-sonnet-4-5-20250929. Puedes agregar cualquier modelo de la página de modelos de CoreAPI al bloque de proveedor correspondiente.