Skip to Content
DocumentaciónIntegracionesOpenClaw 🦞

OpenClaw

OpenClaw  es un asistente de IA local de código abierto que interactúa con usted a través de WhatsApp, Telegram, Slack y otras aplicaciones de mensajería, capaz de ejecutar acciones reales — gestionar correos, calendarios, check-in de vuelos, navegación web y más. Se ejecuta completamente de forma local, los datos no abandonan su dispositivo.

¿Por qué combinarlo con OfoxAI?

  • Acceso unificado a más de 100 modelos — Una sola API Key para acceder a Claude, GPT, Gemini, Qwen, Doubao y todos los modelos principales
  • Estrategia flexible de Agent — Asigne diferentes modelos a diferentes Agents: Sonnet para tareas principales, Opus para razonamiento, Haiku para tareas ligeras
  • 99.9% SLA — Redundancia multi-nodo, conmutación automática por fallos
  • Costos controlados — Panel de facturación unificado, monitoreo en tiempo real del consumo de tokens

OpenClaw como asistente de IA agéntico consume una cantidad considerable de tokens por tarea (normalmente 10K-100K+ tokens). Se recomienda elegir el modelo según la complejidad de la tarea para evitar costos innecesarios. Este artículo ofrece tres opciones de configuración.

Instalación

macOS / Linux
curl -sSL https://openclaw.ai/install.sh | bash
Windows (PowerShell)
& ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1)))

Inicio rápido

1. Obtener API Key

Vaya a la consola de OfoxAI  para crear una API Key.

2. Ejecutar el asistente de configuración

OpenClaw ofrece un asistente interactivo, ejecute el siguiente comando para completar la configuración rápidamente:

openclaw onboard

En el asistente, seleccione Custom Provider e ingrese la siguiente información:

CampoValor
Provider Typeanthropic-messages
Base URLhttps://api.ofox.ai/anthropic
API KeySu API Key de OfoxAI
Modelanthropic/claude-sonnet-4.5

3. Verificar el inicio

openclaw start

Envíe un mensaje a OpenClaw para probar la conectividad. Si recibe una respuesta normal, la configuración es correcta.

El asistente genera automáticamente el archivo de configuración openclaw.json. Si necesita un control más granular, consulte la configuración completa a continuación.

Configuración completa

OpenClaw gestiona toda la configuración a través de ~/.openclaw/openclaw.json (soporta formato JSON5, permite comentarios).

Configuración de Provider

Los Providers se definen en models.providers, cada Provider necesita especificar el tipo de protocolo API, la dirección y la clave:

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": []
      },
      "ofoxai-openai": {
        "baseUrl": "https://api.ofox.ai/v1",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "openai-responses",
        "models": []
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.ai/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": []
      }
    }
  }
}

apiKey soporta la sintaxis ${ENV_VAR} para referenciar variables de entorno, evitando escribir claves en texto plano en el archivo de configuración. Tres protocolos para distintas familias de modelos: Claude usa ofoxai-anthropic (anthropic-messages), OpenAI usa ofoxai-openai (openai-responses), Gemini usa ofoxai-gemini (google-generative-ai). Los demás modelos pueden conectarse a través de ofoxai-openai.

Configuración de Models

Los modelos se definen en el array models del Provider correspondiente. Ofrecemos tres esquemas según sus necesidades:

Lineup completo de Claude — Busca la máxima capacidad, ideal para escenarios de alta exigencia.

openclaw.json — models.providers
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-4.5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      }
    }
  }
}
ModeloRolCasos de uso
anthropic/claude-sonnet-4.5Modelo principalConversación diaria, ejecución de tareas, generación de código
anthropic/claude-opus-4.6Razonamiento profundoAnálisis complejo, razonamiento en cadena, tareas de investigación
anthropic/claude-haiku-4.5Respuesta rápidaConsultas simples, respuestas rápidas, tareas ligeras

Configuración de Agents

OpenClaw usa agents.defaults para configurar valores predeterminados globales y agents.list para definir diferentes Agents, cada uno puede sobrescribir la configuración predeterminada:

openclaw.json — sección agents
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}
AgentModeloUso
mainclaude-sonnet-4.5 (hereda de defaults)Agent predeterminado, todas las tareas diarias
researchclaude-opus-4.6Investigación profunda, razonamiento complejo, análisis de textos largos
quickclaude-haiku-4.5Preguntas simples, respuestas rápidas, bajo costo

El formato de referencia del modelo es nombre-provider/model-id (p. ej., ofoxai-anthropic/anthropic/claude-sonnet-4.5). El campo models en defaults define alias de modelos, permitiendo cambiar rápidamente en la conversación con /model opus. Los Agents en list heredan toda la configuración de defaults, solo necesita sobrescribir los campos que desea cambiar.

Ejemplo de configuración completa

A continuación se muestra un openclaw.json completo que integra la configuración de Provider, Models y Agents (esquema de configuración máxima):

~/.openclaw/openclaw.json
{
  "models": {
    "providers": {
      "ofoxai-anthropic": {
        "baseUrl": "https://api.ofox.ai/anthropic",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "anthropic/claude-sonnet-4.5",
            "name": "Claude Sonnet 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          },
          {
            "id": "anthropic/claude-opus-4.6",
            "name": "Claude Opus 4.6",
            "reasoning": true,
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 128000
          },
          {
            "id": "anthropic/claude-haiku-4.5",
            "name": "Claude Haiku 4.5",
            "input": ["text", "image", "file"],
            "contextWindow": 200000,
            "maxTokens": 64000
          }
        ]
      },
      "ofoxai-gemini": {
        "baseUrl": "https://api.ofox.ai/gemini",
        "apiKey": "${OFOXAI_API_KEY}",
        "api": "google-generative-ai",
        "models": [
          {
            "id": "models/google/gemini-2.5-flash",
            "name": "Gemini 2.5 Flash",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          },
          {
            "id": "models/google/gemini-2.5-pro",
            "name": "Gemini 2.5 Pro",
            "reasoning": true,
            "input": ["text", "image"],
            "contextWindow": 1000000,
            "maxTokens": 64000
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "ofoxai-anthropic/anthropic/claude-sonnet-4.5",
        "fallbacks": ["ofoxai-anthropic/anthropic/claude-haiku-4.5"]
      },
      "models": {
        "ofoxai-anthropic/anthropic/claude-opus-4.6": { "alias": "opus" },
        "ofoxai-anthropic/anthropic/claude-sonnet-4.5": { "alias": "sonnet" },
        "ofoxai-anthropic/anthropic/claude-haiku-4.5": { "alias": "haiku" }
      },
      "thinkingDefault": "low",
      "timeoutSeconds": 600,
      "maxConcurrent": 3
    },
    "list": [
      {
        "id": "main",
        "default": true
      },
      {
        "id": "research",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-opus-4.6"
        }
      },
      {
        "id": "quick",
        "model": {
          "primary": "ofoxai-anthropic/anthropic/claude-haiku-4.5"
        }
      }
    ]
  }
}

Casos de uso

Una vez configurado, envíe instrucciones a OpenClaw a través de aplicaciones de mensajería:

  • Gestión de correos — “Organiza mis correos no leídos de hoy por prioridad”
  • Agenda — “Programa una reunión de equipo mañana a las 3 PM”
  • Búsqueda de información — “Busca artículos técnicos recientes sobre AI Agents y resume los puntos clave”
  • Asistencia de código — “Revisa este código Python y verifica problemas de seguridad”
  • Automatización de flujos — “Envía el informe diario del equipo al canal #general de Slack cada mañana a las 9 AM”

Solución de problemas

No se puede conectar a OfoxAI

Confirme que baseUrl está correctamente configurado:

  • Protocolo Anthropic: https://api.ofox.ai/anthropic
  • Protocolo OpenAI-Response: https://api.ofox.ai/v1
  • Protocolo Gemini: https://api.ofox.ai/gemini

El modelo no existe

Confirme que el formato del ID del modelo sea correcto. Al definir modelos en models.providers, el id usa el ID completo devuelto por OfoxAI (p. ej., anthropic/claude-sonnet-4.5). Al referenciar modelos en agents, necesita agregar el prefijo del nombre del Provider: ofoxai-anthropic/anthropic/claude-sonnet-4.5.

Consumo excesivo de tokens

OpenClaw consume una cantidad considerable por tarea, se recomienda:

  1. Usar claude-haiku-4.5 o modelos de buena relación calidad-precio para tareas diarias
  2. Solo cambiar al Agent research (usando claude-opus-4.6) para tareas complejas
  3. Monitorear el consumo en la consola de OfoxAI 

Cómo cambiar de modelo rápidamente

En la conversación use alias para cambiar: /model opus, /model sonnet, /model haiku (necesita configurar alias en agents.defaults.models).

Last updated on
ClineCherry Studio