OpenClaw + OmniaKey: un proveedor, tres familias de modelos
Añade OmniaKey a OpenClaw como un proveedor compatible con OpenAI y ejecuta Claude, GPT y Gemini por id de modelo — incluido el paso de allowlist que todo el mundo se salta.
OpenClaw es un framework, no un asistente cerrado: te da el bucle del agente, el uso de herramientas y la edición de código, pero la inteligencia viene del proveedor que conectes. Por eso la configuración del proveedor es el archivo más importante que vas a editar — y OmniaKey encaja en él como una única entrada compatible con OpenAI que alcanza Claude, GPT y Gemini de una vez.
Añade OmniaKey como proveedor
La configuración de proveedores está en ~/.openclaw/openclaw.json. Añade OmniaKey en 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" le dice a OpenClaw que añada este proveedor a tu config actual en vez de reemplazarla entera — déjala si ya tienes proveedores definidos. Un proveedor compatible con OpenAI cubre tres familias de modelos: OmniaKey enruta por id de modelo, así que claude-opus-4-8, gpt-5.5 y gemini-3.1-pro-preview pasan todos por la misma entrada.
El paso que todo el mundo se salta: añade el modelo al allowlist
Definir el proveedor es solo la mitad. OpenClaw también exige el modelo en el allowlist, o te topas con el clásico error model not allowed aunque la clave esté bien. Esto va en el mismo openclaw.json, junto al bloque models — models y agents son claves de nivel superior hermanas. Añade el ref completo — provider/model-id — en 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"
}
}
}
El cuerpo de la petición solo lleva el id del modelo; el ref provider/model-id es el nombre interno de OpenClaw. Hacen falta tanto la definición del proveedor como la entrada en el allowlist — hacen trabajos distintos, y es justo por eso que mucha gente configura el proveedor, se olvida del allowlist y se queda atascada.
Verifica
openclaw doctor
doctor revisa el archivo de configuración, el proveedor, el formato de la clave, una conexión en vivo y el acceso al modelo. Luego openclaw models list debería mostrar tus modelos de OmniaKey, y puedes fijar el modelo activo como omniakey/gpt-5.5 — o cualquier id que hayas puesto en el allowlist — en agents.defaults.
No edites ~/.openclaw/agents/main/agent/models.json a mano — se regenera a partir del openclaw.json. Y si te equivocas en el JSON, basta con pedirle a OpenClaw que arregle el archivo; se le da bien encontrar la coma que falta.
Por qué pasar OpenClaw por OmniaKey
Una clave y un saldo para las tres familias, facturación por token sin plan mensual — y ninguna sustitución silenciosa. OmniaKey ejecuta exactamente el id de modelo que pusiste en el allowlist; si un upstream se cae, ves el error en vez de un "equivalente" cambiado en silencio que, a mitad de tarea, entiende tu base de código de otra forma.
La guía de agentes de programación cubre las demás herramientas.