Saltar al contenido principal
Use una DGrid Model API Key para las solicitudes a los modelos. Una Management API Key es una credencial administrativa y no sirve para este tutorial. Compruebe que la clave tenga saldo disponible y acceso al modelo seleccionado.
OpenClaw Gateway es un servicio local que conecta el panel de OpenClaw en su equipo. DGrid AI Gateway es la API remota que recibe las solicitudes a los modelos. Sus credenciales de acceso son distintas.
Conecte OpenClaw con DGrid añadiendo un Custom Provider con su clave, la URL base y un modelo. Esta guía cubre la instalación en macOS, la configuración y el primer mensaje en el panel web. El ejemplo usa openai/gpt-6-sol.

​
Antes de empezar

  • Un equipo macOS con Terminal y conexión a Internet.
  • Una cuenta de DGrid con saldo y acceso al modelo que desea usar.
Los menús y las capturas corresponden a OpenClaw 2026.10.5. Los modelos disponibles dependen de su cuenta de DGrid. Puede elegir otro modelo accesible compatible con Chat Completions; introduzca su ID completo de DGrid.

​
Paso 1: crear una clave API de DGrid

  1. Inicie sesión en DGrid y abra API Keys.
  2. Haga clic en Create New Key, asigne un nombre como OpenClaw y cree la clave.
  3. Copie la clave para pegarla en el asistente de OpenClaw en el paso 4. No muestre la clave completa en capturas ni documentos compartidos.

​
Paso 2: instalar OpenClaw

Abra Terminal y ejecute:
El instalador oficial coloca OpenClaw y un entorno Node.js compatible en ~/.openclaw. Espere a que confirme la instalación y vuelva el indicador del terminal. Inicie el asistente con un comando separado:
Esta guía usa la ruta completa del comando para que pueda ejecutar OpenClaw inmediatamente después de instalarlo así.

​
Paso 3: elegir la configuración manual del proveedor

Si el menú ofrece Quick start y Custom setup, elija Custom setup. Lea el aviso de seguridad y seleccione Yes si lo acepta. Elija su preferencia de estadísticas de uso; No thanks también permite continuar. Use las flechas e Intro para estas selecciones: En Model/auth provider, elija More… para abrir la lista completa de proveedores.
Selección manual y apertura de More en el menú de proveedores

Selección manual y apertura de More en el menú de proveedores

Busque custom, seleccione Custom Provider y pulse Intro.

​
Paso 4: introducir los datos de conexión de DGrid

Rellene los campos en este orden. Pulse Intro tras cada campo y use las flechas e Intro en los menús. La URL base termina en /v1; no añada /chat/completions. Introduzca la clave de DGrid aunque la indicación genérica permita dejarla vacía cuando no sea necesaria. Use openai/gpt-6-sol como Model ID, incluido el prefijo openai/. El Endpoint ID dgrid es el nombre local del proveedor en OpenClaw. Juntos forman la referencia dgrid/openai/gpt-6-sol.
URL base de DGrid, clave oculta e ID del modelo y del endpoint

URL base de DGrid, clave oculta e ID del modelo y del endpoint

Después del alias, OpenClaw comprueba la conexión al modelo. Espere a que termine. Si falla, revise la URL, la clave, el saldo y el ID completo antes de reintentar.

​
Paso 5: terminar la configuración e iniciar el Gateway

El asistente resume el modelo, el espacio de trabajo y el Gateway local. Cuando indique Say yes and I’ll set all of that up now, introduzca:
Pulse Intro y espere a que termine de aplicar la configuración.
Revisión del resumen y entrada de yes para aplicar la configuración

Revisión del resumen y entrada de yes para aplicar la configuración

En una segunda ventana de terminal, instale el servicio Gateway en segundo plano:
Compruebe que el Gateway esté activo y accesible:
Si el asistente indica Gateway is not reachable yet, complete estos pasos antes de abrir el panel. Si sigue mostrando Runtime: stopped, consulte la solución de problemas siguiente. Abra el panel web:
Use el enlace abierto por el comando para conectarse al Gateway local.

​
Paso 6: conversar con el modelo de DGrid

  1. En el panel, abra Home y la sesión main.
  2. Compruebe que el selector bajo el cuadro de entrada muestre openai/gpt-6-sol (Custom Provider). Si usó otro modelo, selecciónelo.
  3. En Message main, introduzca:
  1. Haga clic en el botón Send con forma de flecha hacia arriba y espere la respuesta.
Envío de un mensaje y recepción de respuesta en OpenClaw

Envío de un mensaje y recepción de respuesta en OpenClaw

Ya puede seguir conversando con el modelo de DGrid. Busque el modelo y la hora en el historial de DGrid. Una solicitud completada muestra Success.
Solicitud correcta al modelo de DGrid

Solicitud correcta al modelo de DGrid

Para volver a abrir el panel más adelante, ejecute:

​
Solución de problemas

El instalador indica que se necesita un TTY interactivo Tras la instalación, ejecute el asistente directamente desde Terminal:
Falla la prueba de conexión al modelo Compruebe la URL https://api.dgrid.ai/v1, el saldo y los permisos de la clave, y el ID completo. Para esta configuración Chat Completions, Endpoint compatibility debe ser OpenAI-compatible. El Gateway sigue detenido después de actualizar Si el registro de inicio indica específicamente Legacy device identity exists, detenga el servicio y ejecute la migración y reparación integradas:
Siga las indicaciones de reparación. Doctor puede reiniciar y comprobar el Gateway automáticamente. Vuelva a ejecutar "$HOME/.openclaw/bin/openclaw" gateway status; si sigue detenido, ejecute:
El navegador no se conecta al Gateway Compruebe el servicio con "$HOME/.openclaw/bin/openclaw" gateway status y vuelva a abrir el panel con el comando del paso 5. El token Gateway del panel es distinto de la clave API de DGrid. Consulte la guía de instalación de OpenClaw, la documentación del asistente y la referencia de Gateway CLI.

​
Recursos relacionados

A continuación se conserva un vídeo anterior. Su interfaz puede diferir de la versión de esta guía.