Cómo configurar Synthetic en OpenClaw

Seguro te ha pasado: quieres probar un modelo nuevo y pierdes más tiempo configurando la conexión que programando. Me pasó hace poco intentando integrar endpoints compatibles con Anthropic; las configuraciones eran un desastre hasta que probé Synthetic.

Es la solución ideal si buscas una integración directa con la Anthropic Messages API sin complicaciones. OpenClaw ya lo reconoce como un provider nativo, así que configurarlo te llevará menos de lo que tarda en enfriarse tu café.

Requisitos previos

• Una cuenta en Synthetic para obtener tu API Key.
• OpenClaw instalado en tu entorno local.
• Node.js configurado correctamente.
• Acceso a terminal o consola.

Inicio rápido

Configurar Synthetic es pan comido. Sigue estos pasos para estar listo en 5 minutos:

1. Define tu variable de entorno SYNTHETIC_API_KEY.
2. Ejecuta el comando de onboarding:

openclaw onboard --auth-choice synthetic-api-key

Por defecto, el sistema utilizará el modelo synthetic/hf:MiniMaxAI/MiniMax-M2.1.

Ejemplo de Config

Aquí tienes un archivo de configuración listo para copiar y usar:

{
  env: { SYNTHETIC_API_KEY: "sk-..." },
  agents: {
    defaults: {
      model: { primary: "synthetic/hf:MiniMaxAI/MiniMax-M2.1" },
      models: { "synthetic/hf:MiniMaxAI/MiniMax-M2.1": { alias: "MiniMax M2.1" } },
    },
  },
  models: {
    mode: "merge",
    providers: {
      synthetic: {
        baseUrl: "https://api.synthetic.new/anthropic",
        apiKey: "${SYNTHETIC_API_KEY}",
        api: "anthropic-messages",
        models: [
          {
            id: "hf:MiniMaxAI/MiniMax-M2.1",
            name: "MiniMax M2.1",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 192000,
            maxTokens: 65536,
          },
        ],
      },
    },
  },
}

Nota importante: El cliente de Anthropic en OpenClaw añade automáticamente /v1 al final de la URL. Usa https://api.synthetic.new/anthropic y no incluyas el /v1 manualmente. Si Synthetic cambia su Gateway, simplemente actualiza el campo baseUrl.

Model catalog

Todos estos modelos tienen un coste de 0 (input/output/cache).

Model ID	Context window	Max tokens	Reasoning	Input
hf:MiniMaxAI/MiniMax-M2.1	192000	65536	false	text
hf:moonshotai/Kimi-K2-Thinking	256000	8192	true	text
hf:zai-org/GLM-4.7	198000	128000	false	text
hf:deepseek-ai/DeepSeek-R1-0528	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3-0324	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3.1	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3.1-Terminus	128000	8192	false	text
hf:deepseek-ai/DeepSeek-V3.2	159000	8192	false	text
hf:meta-llama/Llama-3.3-70B-Instruct	128000	8192	false	text
hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8	524000	8192	false	text
hf:moonshotai/Kimi-K2-Instruct-0905	256000	8192	false	text
hf:openai/gpt-oss-120b	128000	8192	false	text
hf:Qwen/Qwen3-235B-A22B-Instruct-2507	256000	8192	false	text
hf:Qwen/Qwen3-Coder-480B-A35B-Instruct	256000	8192	false	text
hf:Qwen/Qwen3-VL-235B-A22B-Instruct	250000	8192	false	text + image
hf:zai-org/GLM-4.5	128000	128000	false	text
hf:zai-org/GLM-4.6	198000	128000	false	text
hf:deepseek-ai/DeepSeek-V3	128000	8192	false	text
hf:Qwen/Qwen3-235B-A22B-Thinking-2507	256000	8192	true	text

Solución de problemas

• Error de conexión 404: Revisa la baseUrl. No debe terminar en /v1 porque OpenClaw lo añade solo.
• Modelo no disponible: Si activaste una allowlist en agents.defaults.models, tienes que añadir cada modelo que quieras usar.
• Error de prefijo: Recuerda que las referencias a modelos deben usar siempre el formato synthetic/<modelId>.
• Fallo de API Key: Asegúrate de que la variable SYNTHETIC_API_KEY esté cargada correctamente en tu entorno de Node.js.

Si tienes dudas con la configuración, el AI Setup Assistant te puede ayudar en tiempo real.

Próximos pasos

• Model providers