Guía Paso a Paso: Cómo Integrar la API Gratuita de GLM 5 con OpenClaw

¿Sabías que puedes acceder a la API de GLM 5 de forma totalmente gratuita hasta el 30 de abril a través de Model Research? Si te has preguntado cómo aprovechar este recurso utilizando OpenClaw, estás en el lugar correcto.

En esta guía te mostraré cómo configurar todo desde cero y sin complicaciones.

Requisitos Previos

Antes de comenzar, necesitas:

Una cuenta en Model Research
OpenClaw instalado en tu sistema
Acceso a terminal (CMD en Windows, Terminal en Linux/Mac)

Paso 1: Instalación de OpenClaw

El primer paso es instalar OpenClaw en tu sistema. Los comandos varían según tu sistema operativo:

Linux / Mac

# Sigue el procedimiento oficial de instalación para tu sistema

Windows

Recomiendo usar CMD en lugar de PowerShell para evitar problemas de compatibilidad.

# Pega el comando de instalación oficial y ejecútalo

Tip: Puedes encontrar los comandos actualizados en la documentación oficial de OpenClaw.

Paso 2: Ejecutar el Asistente de Configuración (Onboarding)

Una vez instalado, ejecuta el widget de onboarding:

Copia el comando de onboarding y pégalo en tu terminal
El sistema mostrará una advertencia de riesgo → escribe yes para continuar
Selecciona Quick Start (Inicio rápido)
Si ya tenías una configuración previa, elige Full Reset para una instalación limpia

Paso 3: Configuración del Proveedor y API

Aquí es donde conectamos OpenClaw con GLM 5:

3.1 Seleccionar Proveedor Personalizado

Cuando el sistema solicite seleccionar un modelo y proveedor:

Navega con las flechas del teclado hasta la última opción
Selecciona Custom Provider (proveedor personalizado)
Esto permite usar cualquier endpoint compatible con OpenAI

3.2 Configurar URL Base

Pega la URL base proporcionada por Model Research:

https://api.us-west-2.modal.direct/v1/

Importante: Asegúrate de copiarla hasta donde dice v1/

3.3 Generar y Configurar API Key

Ve a la página de Model Research
Busca Create Token en el menú izquierdo
Asígnale un nombre (ej: openclaw-testing)
Genera tu clave y cópiala
Pégala en la terminal cuando se solicite

3.4 Configurar el Modelo

Confirma que el endpoint es compatible con OpenAI y proporciona:

Model ID: zai-org/GLM-5-FP8
Alias: GLM5 (o el nombre que prefieras)

3.5 Opciones Adicionales

Puedes omitir por ahora:

Configuración de canales (Telegram, WhatsApp, etc.)
Skills personalizadas
Hooks

Paso 4: Solución de Errores Comunes

Error: Puerto del Navegador

Si el navegador no abre correctamente el servicio, reinicia el gateway:

openclaw gateway port 18789

Esto reiniciará el gateway en el puerto predeterminado y dejará la interfaz lista.

Error: “Context Window Too Small”

Al enviar tu primer mensaje, podrías recibir:

model context window too small

Causa: OpenClaw viene con 4,096 tokens por defecto, pero GLM 5 requiere mínimo 16,000.

Solución:

Abre el archivo de configuración de OpenClaw:
- Windows: C:\Users\TuUsuario\.openclaw\openclaw.json
- Linux/Mac: ~/.openclaw/openclaw.json
Localiza los valores de contextWindow y maxTokens
Cámbialos de 4096 a 32000 (o 16000)
Guarda el archivo

Ejemplo de configuración correcta:

{
  "models": {
    "providers": {
      "modal": {
        "models": [
          {
            "id": "zai-org/GLM-5-FP8",
            "contextWindow": 131072,
            "maxTokens": 16384
          }
        ]
      }
    }
  }
}

Paso 5: Prueba Final

Reinicia el gateway:
```
openclaw gateway port 18789
```
Abre tu navegador en http://localhost:18789
Refresca la página
Envía un mensaje de prueba: Hola
¡Listo! Deberías recibir una respuesta fluida del modelo

Verificación

Para confirmar que todo funciona correctamente:

Revisa los logs en la interfaz de OpenClaw
Verifica que la API recibe las peticiones correctamente
Comprueba que el modelo responde con el alias configurado

Notas Importantes

La API gratuita de GLM 5 está disponible hasta el 30 de abril
El modelo GLM-5-FP8 es una versión cuantizada optimizada
Recuerda guardar tu API Key de forma segura
Si experimentas lentitud, verifica tu conexión a internet

Conclusión

Has integrado exitosamente la API gratuita de GLM 5 con OpenClaw. Ahora puedes disfrutar de un asistente de IA potente y gratuito para tus proyectos.

¿Tienes dudas o encontraste algún problema? Déjame un comentario y te ayudo a resolverlo.

Referencia: Tutorial basado en el video del canal Codedigipt