---
title: "Conexión de OpenClaw a la API de Claude"
description: "Tutorial para configurar en OpenClaw la dirección, la clave y el modelo del retransmisor de API de Claude de 1折AI, incluyendo la selección de protocolo, ejemplos de configuración, pasos de verificación y errores comunes."
headingIds: {"Verificación de la conexión y solución de problemas":"section-1","Costes y otras formas de conexión":"section-2"}
---

<aside className="docs-publication" data-pagefind-ignore>

Documentación mantenida por [1ZheAI](https://1zheai.com/en/editorial/#publisher). [Fuentes y correcciones](https://1zheai.com/en/editorial/).

¿Encontraste un error? [Contacta con soporte](mailto:support@1zheai.com) indicando la dirección de la página y una descripción. No envíes claves de API ni credenciales de cuenta.

</aside>
Usa la función de proveedor personalizado de OpenClaw para conectarte a 1折AI. Primero [crea una clave API](/es/docs/api-keys/) y confirma los [modelos disponibles actualmente](/es/docs/models/); los ID de modelo de este documento son ejemplos, ajústalos según los permisos de tu clave.

<Note>
Fecha de verificación de la configuración oficial: 2026-10-15. La siguiente configuración se basa en la documentación oficial; la verificación de extremo a extremo en este sitio aún no se ha completado; completa primero una breve pregunta-respuesta y la verificación de llamadas a herramientas antes de usarla en tareas largas. Los modelos OpenAI / GPT ya están disponibles; consulta la [descripción de modelos](/es/docs/models/) para la lista de modelos y los precios.
</Note>

Según [proveedores personalizados](https://docs.openclaw.ai/gateway/config-tools/custom-providers) y [ejemplos de configuración](https://docs.openclaw.ai/gateway/configuration-examples), combina en `~/.openclaw/openclaw.json`:

```json
{
  "agents": {
    "defaults": {
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
    }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "onezhe": {
        "baseUrl": "https://1zheai.com",
        "apiKey": "${ONEZHE_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
        ]
      }
    }
  }
}
```

Asegúrate de que el proceso que ejecuta realmente el Gateway pueda leer `ONEZHE_API_KEY`; las variables de entorno de la terminal no siempre se pasan a un servicio en segundo plano ya existente. La [documentación oficial de Synthetic](https://docs.openclaw.ai/providers/synthetic) indica que el cliente de Anthropic añade automáticamente `/v1`, por lo que aquí no se incluye `/v1` ni se rellena el `/v1/messages` completo.

Al cambiar a Chat Completions, sustitúyelos por pareja por `baseUrl: "https://1zheai.com/v1"` y `api: "openai-completions"`. Aunque el nombre contiene completions, este adaptador corresponde a `/v1/chat/completions`; no selecciones por error `openai-responses`. Si ya existe una lista blanca de modelos, conserva las demás entradas y añade el nuevo modelo. El ejemplo no inventa parámetros de coste ni de contexto; si la versión instalada actual requiere metadatos adicionales para la validación, verifica primero las capacidades reales del modelo antes de añadirlos.

## Verificación de la conexión y solución de problemas

1. Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es `onezhe` o el modelo personalizado que añadiste.
2. Envía una pregunta breve para confirmar que se puede obtener respuesta; después intenta una tarea pequeña y reversible, confirmando por separado las llamadas a herramientas y las conversaciones de múltiples turnos.
3. Abre el [registro de llamadas](/es/docs/usage-logs/) y comprueba la hora de la solicitud, el modelo, el estado y el uso. Que una respuesta de texto tenga éxito no significa que todas las capacidades de los Agentes sean compatibles.
4. Si aparece un 404, comprueba que la dirección y el protocolo de este documento sean compatibles; si aparece un 401, comprueba el origen de la clave y si el proceso leyó las variables de entorno; si aparece un 429, revisa la información de limitación de tasa antes de reintentar. Para más casos, consulta [códigos de error y solución de problemas](/es/docs/troubleshooting/).

Las claves solo se guardan en el entorno local o en el almacén de credenciales de la herramienta; no las envíes a repositorios de código, capturas de pantalla ni registros públicos. Los servicios en segundo plano pueden no heredar las variables de entorno de la terminal; los modelos auxiliares, la búsqueda y otras herramientas también pueden tener configuraciones de proveedor independientes que deben comprobarse por separado.

## Costes y otras formas de conexión

Consulta los [precios en tiempo real de la API de Claude](https://1zheai.com/en/pricing/) y las [reglas de facturación](/es/docs/pricing-explained/). Si necesitas otros clientes, vuelve al [directorio de integración de herramientas](/es/docs/integrations/); si escribes tu propio programa, puedes usar la [guía de SDK y desarrollo](/es/docs/guides/).