Cómo configurar Z.AI en OpenClaw

Configurar una nueva API suele quitarte tiempo que podrías usar para programar. Entre entender cómo funciona la autenticación y encontrar los nombres exactos de los modelos, el proceso se vuelve lento y molesto. Si quieres usar modelos GLM sin complicaciones, Z.AI es la opción que te recomiendo.

Requisitos previos

• API key de Z.AI (generada en la consola de Z.AI).
• OpenClaw instalado en tu sistema.

Inicio rápido

Para tener todo listo en menos de 5 minutos, usa la CLI de OpenClaw. Tienes dos formas de configurar el provider zai:

Usa el modo interactivo para seleccionar la opción:

openclaw onboard --auth-choice zai-api-key

O utiliza el comando directo si ya tienes tu variable de entorno lista:

openclaw onboard --zai-api-key "$ZAI_API_KEY"

Después, verifica que tu archivo de configuración incluya el modelo correcto. Este snippet usa zai/glm-4.7 como modelo principal:

{
  env: { ZAI_API_KEY: "sk-..." },
  agents: { defaults: { model: { primary: "zai/glm-4.7" } } },
}

Solución de problemas

• Error de autenticación: Z.AI utiliza Bearer auth con tu API key. Si recibes errores de permisos, asegúrate de que la key en tu archivo de configuración coincida exactamente con la de la consola.
• Formato de modelo incorrecto: Los modelos GLM solo funcionan si incluyes el prefijo del provider. Usa siempre el formato zai/<model>, como por ejemplo zai/glm-4.7.

¿Necesitas ayuda con otro paso? Prueba el AI Setup Assistant.

Próximos pasos

• Model family overview