OpenClaw integración con Claude: 2 métodos de configuración – Modo compatible con OpenAI vs Formato nativo de Claude – Tutorial completo

Nota del autor: Guía paso a paso para configurar en OpenClaw los dos métodos de conexión: el modo compatible con OpenAI y el formato nativo de Claude. Incluye código de configuración JSON completo, lista de modelos aplicables y comparación de diferencias clave.

En OpenClaw (Open WebUI) hay dos formas de conectar Modelos de Lenguaje Grande: el modo compatible con OpenAI (openai-completions) y el formato nativo de Claude (anthropic-messages). Muchos usuarios no comprenden la diferencia, lo que lleva a usar el formato incorrecto para modelos Claude o a perderse funciones avanzadas como el Prompt Caching que ofrece el formato nativo.

Valor central: Al leer este artículo, dominarás los métodos completos de configuración para ambos modos en OpenClaw, sabrás qué formato usar para cada modelo y podrás copiar y usar directamente el código de configuración.

Comparación central de los dos métodos de conexión en OpenClaw

Resumen en una frase de los dos métodos en OpenClaw

Recuerda una regla simple: Usa anthropic-messages para la serie Claude, y openai-completions para todos los demás modelos. La diferencia más obvia es el baseUrl: el modo compatible con OpenAI termina en /v1, el formato nativo de Claude no.

Configuración del modo compatible con OpenAI en OpenClaw

Escenarios de uso del modo compatible con OpenAI

El modo compatible con OpenAI (openai-completions) es la forma más universal de integración en OpenClaw y es adecuado para todos los Modelos de Lenguaje Grande que no sean Claude. La mayoría de los servicios proxy de API utilizan este formato estandarizado de OpenAI.

Código de configuración completo para el modo compatible con OpenAI

A continuación se muestra la configuración completa para integrar GPT-5.4 a través de APIYI:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-tu-clave-API",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-tu-clave-API",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      }
    }
  }
}

Puntos clave de configuración del modo compatible con OpenAI

🎯 Recordatorio de configuración: No omitas /v1 al final de baseUrl, es la ruta estándar del protocolo compatible con OpenAI. Regístrate en APIYI apiyi.com para obtener tu clave API y crédito gratuito.

Configuración del formato nativo Claude en OpenClaw

Escenarios de uso del formato nativo Claude

El formato nativo Claude (anthropic-messages) es el método de integración exclusivo para la serie de modelos Claude. Usar el formato nativo te permite acceder a funciones avanzadas únicas de Claude, como Prompt Caching, Extended Thinking y procesamiento de PDF.

Código de configuración completo para el formato nativo Claude

A continuación se muestra la configuración completa para integrar modelos Claude a través de APIYI:

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-tu-clave-API",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

{
  "models": {
    "providers": {
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-tu-clave-API",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-haiku-4-5-20251001",
            "name": "Claude Haiku 4.5",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

Puntos clave de configuración del formato nativo Claude

🎯 Diferencia crucial: La baseUrl del formato nativo Claude no incluye /v1. Este es el error más común para principiantes. Si la integración de Claude falla, primero verifica si accidentalmente agregaste /v1 al final de la URL.

Configuración para usar ambos formatos de OpenClaw simultáneamente

En la práctica, es muy probable que necesites usar tanto modelos generales como modelos Claude. En ese caso, debes configurar dos proveedores en OpenClaw:

Código de configuración combinada para dos proveedores

Puedes escribir ambos formatos de proveedor en el mismo archivo de configuración, y así podrás cambiar libremente entre modelos en OpenClaw:

{
  "agents": {
    "defaults": {
      "model": { "primary": "apiyi/gpt-5.4" }
    }
  },
  "models": {
    "providers": {
      "apiyi": {
        "baseUrl": "https://api.apiyi.com/v1",
        "apiKey": "sk-tu-clave-API",
        "api": "openai-completions",
        "models": [
          { "id": "gpt-5.4", "name": "GPT-5.4" },
          { "id": "deepseek-v3.2", "name": "DeepSeek V3.2" },
          { "id": "gemini-3-flash-preview", "name": "Gemini 3 Flash" },
          { "id": "glm-5", "name": "GLM-5" },
          { "id": "kimi-k2.5", "name": "Kimi K2.5" },
          { "id": "grok-4", "name": "Grok 4" },
          { "id": "Minimax-M2.5", "name": "Minimax M2.5" }
        ]
      },
      "apiyi-claude": {
        "baseUrl": "https://api.apiyi.com",
        "apiKey": "sk-tu-clave-API",
        "api": "anthropic-messages",
        "headers": {
          "anthropic-version": "2023-06-01",
          "anthropic-beta": ""
        },
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-sonnet-4-6-thinking",
            "name": "Claude Sonnet 4.6 Thinking",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          },
          {
            "id": "claude-opus-4-6",
            "name": "Claude Opus 4.6",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 200000,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

🎯 Nota importante: Ambos proveedores pueden usar la misma clave API. La misma clave de APIYI (apiyi.com) es compatible tanto con el formato OpenAI como con el formato nativo de Claude, no necesitas solicitar múltiples claves.

Solución de problemas de errores comunes en los dos formatos de OpenClaw

El punto más propenso a errores durante la configuración es la incompatibilidad entre la baseUrl y el tipo de API. A continuación se presentan los errores comunes y sus soluciones:

🎯 Regla mnemotécnica rápida: El formato OpenAI lleva /v1, el formato Claude no lleva /v1. Recordar esto evita el 80% de los errores de configuración. Si encuentras otros problemas, puedes visitar el centro de documentación de APIYI en apiyi.com para ver la guía completa de integración.

Preguntas frecuentes

Resumen

Puntos clave de las dos formas de integrar OpenClaw:

1. Usar openai-completions para modelos generales: Para todos los modelos que no sean Claude, como GPT, Gemini, DeepSeek, GLM, Kimi, Grok, Minimax, etc. El baseUrl debe incluir /v1.
2. Usar anthropic-messages para la serie Claude: Para claude-sonnet-4-6, claude-opus-4-6, claude-haiku, etc. El baseUrl NO debe incluir /v1 y requiere el header anthropic-version.
3. La coexistencia de dos Proveedores es la mejor práctica: Configurar el mismo clave API en dos proveedores, permitiendo cambiar libremente entre todos los modelos dentro de OpenClaw.

Se recomienda obtener el clave API a través de APIYI apiyi.com. Una sola clave permite acceder a todos los modelos principales como GPT, Claude, Gemini, DeepSeek, etc., con soporte para los formatos compatible con OpenAI y nativo de Claude.

📚 Referencias

1. Centro de Ayuda de APIYI: Tutorial completo de configuración para integrar OpenClaw.

   • Enlace: help.apiyi.com
   • Descripción: Incluye documentación detallada de integración para cada sitio y la lista más reciente de modelos.

2. Documentación de la API de Anthropic: Especificaciones del formato de API nativo de Claude.

   • Enlace: platform.claude.com/docs/en/api/messages
   • Descripción: Parámetros completos y formato de respuesta de la API Messages.

3. Documentación de compatibilidad del SDK de OpenAI: Qué parámetros se ignoran en Claude.

   • Enlace: platform.claude.com/docs/en/api/openai-sdk
   • Descripción: Lista completa de parámetros soportados y no soportados.

4. Documentación de Open WebUI: Guía de configuración de múltiples Proveedores en OpenClaw.

   • Enlace: docs.openwebui.com
   • Descripción: Configuración de Proveedores, gestión de modelos y configuración de Agentes.

Autor: Equipo técnico de APIYI
Intercambio técnico: Bienvenidos a discutir en la sección de comentarios. Más recursos disponibles en el centro de documentación de APIYI docs.apiyi.com.