Conexión de OpenClaw a la API de Claude

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.

Usa la función de proveedor personalizado de OpenClaw para conectarte a 1折AI. Primero crea una clave API y confirma los modelos disponibles actualmente; los ID de modelo de este documento son ejemplos, ajústalos según los permisos de tu clave.

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 para la lista de modelos y los precios.

Según proveedores personalizados y ejemplos de configuración, combina en ~/.openclaw/openclaw.json:

1
{
2
  "agents": {
3
    "defaults": {
4
      "model": { "primary": "onezhe/claude-sonnet-4-6" },
5
      "models": { "onezhe/claude-sonnet-4-6": { "alias": "1折AI Claude" } }
6
    }
7
  },
8
  "models": {
9
    "mode": "merge",
10
    "providers": {
11
      "onezhe": {
12
        "baseUrl": "https://1zheai.com",
13
        "apiKey": "${ONEZHE_API_KEY}",
14
        "api": "anthropic-messages",
15
        "models": [
16
          { "id": "claude-sonnet-4-6", "name": "Claude Sonnet 4.6" }
17
        ]
18
      }
19
    }
20
  }
21
}

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 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

Guarda y recarga la configuración; confirma que el proveedor seleccionado actualmente es onezhe o el modelo personalizado que añadiste.
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.
Abre el registro de llamadas 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.
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.

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 y las reglas de facturación. Si necesitas otros clientes, vuelve al directorio de integración de herramientas; si escribes tu propio programa, puedes usar la guía de SDK y desarrollo.