Guía de integración de la API Claude de OpenClaw

Este tutorial describe en detalle las diversas maneras de configurar la API Claude en OpenClaw, ayudándote a comenzar rápidamente.

Introducción

OpenClaw es un potente marco para entidades de inteligencia artificial, que soporta la integración de varios modelos de lenguaje grandes. Claude es un modelo de IA de alto rendimiento desarrollado por Anthropic, destacándose en generación de código, análisis de inferencias, entre otros aspectos.

Preparativos

Antes de empezar, necesitas:

Instalar OpenClaw: npm install -g openclaw
Tener los permisos de acceso a la API correspondientes

Método 1: Usar Defapi (recomendado)

¡Si deseas ahorrar costos, se recomienda utilizar Defapi!

Defapi es una plataforma de agregación de modelos de IA, todos los modelos de Claude tienen un precio que es solo la mitad del oficial. Defapi soporta la interfaz v1/chat/completions, compatible con OpenAI, y su configuración es simple y conveniente.

Ventajas

Precio reducido: Claude Sonnet 4.5 solo cuesta $1.5/M por entrada, $7.5/M por salida
Gran compatibilidad: Perfectamente compatible con el formato de la interfaz de OpenAI
Estabilidad y fiabilidad: Acceso rápido desde el interior del país

Modelos de Claude soportados

Claude Opus 4.5 / 4.6
Claude Sonnet 4.5
Claude Haiku 4.5

Pasos de configuración

Visita Defapi para registrarte y obtener tu clave de API.
Configura en OpenClaw:

{
  env: {
    OPENAI_API_KEY: "tu clave de Defapi",
    OPENAI_BASE_URL: "https://api.defapi.org/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-sonnet-4.5" },
    },
  },
}

Verifica la configuración:

# Envía un mensaje de prueba (recomendado)
openclaw agent --message "Hello"

# O revisa el estado del modelo
openclaw models status

Una vez verificada con éxito, puedes conversar con Claude de las siguientes maneras:

# Envía un mensaje directamente
openclaw agent --message "你好"

# O utiliza la interfaz de terminal
openclaw tui

# O inicia el Gateway y conversa a través de otros canales
openclaw gateway

¡Ahora puedes disfrutar de las potentes capacidades de Claude a mitad de precio!

Método 2: API oficial de Anthropic

Este es el método más directo para la integración, adecuado para usuarios con clave de API o suscripción a Claude.

Opción 2.1: Autenticación con clave de API

Si tienes una clave de API de Anthropic (pago por uso), la configuración es muy sencilla:

openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"

O añade en el archivo de configuración:

{
  env: { ANTHROPIC_API_KEY: "sk-ant-..." },
  agents: { defaults: { model: { primary: "anthropic/claude-opus-4-6" } } },
}

Verificar:

openclaw agent --message "Hello"

Opción 2.2: Autenticación con token de instalación

Si tienes una suscripción a Claude Max/Pro, puedes usar un token de instalación:

# Genera en la CLI de Claude Code
claude setup-token

# Configura en OpenClaw
openclaw models auth setup-token --provider anthropic

Sugerencias para caché

La API de Anthropic soporta caché de sugerencias, lo que puede mejorar el rendimiento y reducir costos:

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": {
          params: { cacheRetention: "long" },
        },
      },
    },
  },
}

Método 3: OpenRouter

OpenRouter ofrece una interfaz de API unificada, accesible para varios modelos, incluida la serie Claude.

openclaw onboard --auth-choice apiKey --token-provider openrouter --token "$OPENROUTER_API_KEY"

Configuración:

{
  env: { OPENROUTER_API_KEY: "sk-or-..." },
  agents: {
    defaults: {
      model: { primary: "openrouter/anthropic/claude-sonnet-4-5" },
    },
  },
}

Verificación:

openclaw agent --message "Hello"

Método 4: Proxy de API de Claude Max

Si tienes una suscripción a Claude Max pero necesitas una interfaz en formato de OpenAI, puedes usar la herramienta comunitaria claude-max-api-proxy:

npm install -g claude-max-api-proxy
claude-max-api

Configura OpenClaw:

{
  env: {
    OPENAI_API_KEY: "no necesario",
    OPENAI_BASE_URL: "http://localhost:3456/v1",
  },
  agents: {
    defaults: {
      model: { primary: "openai/claude-opus-4" },
    },
  },
}

Verificación:

openclaw agent --message "Hello"

Método 5: API personalizada compatible

Para otras plataformas que ofrecen API compatibles, OpenClaw también soporta configuraciones personalizadas.

Formato v1/chat/completions

{
  env: {
    CUSTOM_API_KEY: "sk-...",
  },
  agents: {
    defaults: {
      model: { primary: "custom/claude-model" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_API_KEY}",
        api: "openai-completions",
        models: [
          { id: "claude-model", name: "Modelo Claude", contextWindow: 200000 },
        ],
      },
    },
  },
}

Formato v1/messages (compatible con Anthropic)

{
  env: {
    CUSTOM_API_KEY: "sk-...",
  },
  agents: {
    defaults: {
      model: { primary: "custom/claude-opus-4" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      "custom": {
        baseUrl: "https://api.example.com/v1",
        apiKey: "${CUSTOM_API_KEY}",
        api: "anthropic-messages",
        models: [
          { id: "claude-opus-4", name: "Claude Opus 4", contextWindow: 200000 },
        ],
      },
    },
  },
}

Referencias a modelos comunes

Modelo	Referencia de configuración
Claude Opus 4.6	`anthropic/claude-opus-4-6`
Claude Sonnet 4.6	`anthropic/claude-sonnet-4-6`
Claude Haiku 4.6	`anthropic/claude-haiku-4-6`

Solución de problemas

Problema: Error 401 / Token inválido

Reejecute claude setup-token y configure nuevamente.

Problema: "No se encontró clave de API para el proveedor anthropic"

La autenticación se aísla por agente; confirmación de que el agente objetivo ha configurado la autenticación.

Problema: Conexión fallida

Verifica la conexión a la red.
Confirma que la clave de API sea correcta.
Verifica que la configuración baseUrl sea correcta.