OpenClaw

OpenClaw es una IA personal autoalojada que se ejecuta en tu máquina y responde a través de los canales que ya usas (WhatsApp, Telegram, Slack, Discord, iMessage y muchos más). Admite varios proveedores de modelos - agrega Synthorai como uno de ellos y cualquier modelo de chat de tu espacio de trabajo será accesible a través de la configuración de agente de OpenClaw.

Antes de empezar

Necesitará (1) una instalación de OpenClaw ejecutándose localmente y (2) una clave API de Synthorai desde Consola → Claves API.

Paso 1 - Editar ~/.openclaw/openclaw.json

Agrega Synthorai bajo providers. Existentes openai/anthropic las entradas pueden permanecer - OpenClaw usará la que esté referenciada por agent.model.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai/gpt-5.4-mini"
  }
}

ℹ

type: openai indica a OpenClaw que hable el protocolo OpenAI Chat Completions. Synthorai es totalmente compatible con OpenAI en /v1/chat/completions, por lo que funciona con cualquier modelo de chat en tu espacio de trabajo - no solo los alojados por OpenAI.

Paso 2 - (Opcional) agregar también un proveedor nativo de Claude

Si quieres específicamente el formato de mensaje nativo de Anthropic (solo modelos de la familia Claude), agrega un segundo proveedor dirigido al protocolo Anthropic. Ten en cuenta el base_url no incluye /v1.

{
  "providers": {
    "synthorai": {
      "type": "openai",
      "base_url": "https://synthorai.io/v1",
      "api_key": "sk-..."
    },
    "synthorai-claude": {
      "type": "anthropic",
      "base_url": "https://synthorai.io",
      "api_key": "sk-..."
    }
  },
  "agent": {
    "model": "synthorai-claude/claude-sonnet-4-6"
  }
}

Paso 3 - Reiniciar OpenClaw

OpenClaw vuelve a leer openclaw.json al iniciar. Tras reiniciar, envía tu primer mensaje desde cualquier canal al que OpenClaw esté vinculado (p. ej. Slack, Telegram) - el agente responderá usando el modelo Synthorai que configuraste.

Modelos recomendados

Para un asistente conversacional, el punto óptimo de costo-calidad suele ser un modelo de gama media rápido:

Parámetro	Tipo	Descripción
`gpt-5.4-mini`	`fast`	OpenAI; rápido y económico. Buena opción predeterminada.
`qwen3.5-flash`	`fast`	Alibaba Qwen; precio competitivo para chino + código + multilingüe.
`claude-sonnet-4-6`	`balanced`	Anthropic; ideal para conversaciones de contexto más largo. Requiere el formato de proveedor claude anterior.
`gemini-2.5-flash`	`fast`	Google; ventana de contexto larga para flujos de trabajo con muchos archivos.

Resolución de problemas

Discrepancias de nombres de campos entre versiones de OpenClaw - los campos mostrados arriba (type / base_url / api_key) son el patrón habitual. Si una versión específica de OpenClaw los renombra (e.g. provider_type / baseUrl), consulta la referencia de configuración oficial e introduce los mismos valores.

401 / 403 - clave API incorrecta, desactivada o sin cuota. Comprueba /console/keys y /console/billing.

"Modelo desconocido" - el slug del modelo debe coincidir con la columna id en /console/pricing. Si lo referencias mediante agent.model = "synthorai/MODEL_ID" asegúrate de que MODEL_ID sea enrutable por la clave que proporcionaste.

Despliegues privados / aislados de la red - el mismo formato JSON funciona; solo reemplaza la URL pública https://synthorai.io por el nombre de host de tu pasarela interna.

Para ver cuánto cuesta cada opción para un asistente siempre activo, pasa tu volumen previsto por la LLM API cost calculator.