OpenClaw + OmniaKey: un proveedor, cuatro familias de modelos

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, Gemini y Grok 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" },
          { "id": "grok-4.5" }
        ]
      }
    }
  }
}

"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 cuatro familias de modelos: OmniaKey enruta por id de modelo, así que claude-opus-4-8, gpt-5.5, gemini-3.1-pro-preview y grok-4.5 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", "omniakey/grok-4.5"],
      "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.

Por qué pasar OpenClaw por OmniaKey

Una clave y un saldo para las cuatro 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.