Primeros pasos con OpenClaw

Esta guía te ayudara a instalar, configurar y poner en marcha OpenClaw, el asistente de IA de código abierto que corre en tu propia infraestructura, en un Cloud Server de Donweb. OpenClaw se integra con los canales de mensajería que ya utilizas —WhatsApp, Telegram, Slack, Discord, Signal y más— brindandote un asistente IA siempre disponible y con tus datos bajo tu control.

1. Instalación de OpenClaw

Opción 1: Imagen Click&Go (Recomendada)

Para una instalación rápida y sin complicaciones, utiliza nuestra imagen Click&Go de OpenClaw:

1. Accede a tu Cloud Server sin software instalado.
2. Selecciona la imagen de OpenClaw desde el catálogo de imágenes.
3. Presiona el botón Instalar y sigue las instrucciones en pantalla.

La imagen despliega los siguientes componentes:

Una vez instalado, los archivos de configuración se encuentran en /root/app de tu Cloud Server:

• docker-compose.yml — Orquesta el despliegue de los contenedores.
• .env — Define las variables de configuración de OpenClaw.
• app-nginx.conf — Configuración de Nginx.

docker compose up -d

Opción 2: Instalación manual

Si prefieres tener control total sobre la instalación:

1. Inicia con una imagen Ubuntu mínima en tu Cloud Server.
2. Instala Docker siguiendo esta guía de instalación de Docker.
3. Sigue las instrucciones detalladas en la documentación oficial de OpenClaw.
4. Configura manualmente las dependencias y variables de entorno.

2. Configuración de dominio y certificado SSL

Nuestra imagen Click&Go incluye una herramienta integrada para configurar automáticamente un dominio y certificado SSL, preparando la instancia para un entorno productivo y seguro.

1. Navega a la configuración: ingresa a tu Cloud Server desde MiCuenta, selecciona Software y Accesos en el menú lateral → pestaña OpenClaw → botón Configurar Dominio y SSL.
2. Configura tu dominio: ingresa el dominio o subdominio deseado (por ejemplo, ai.tudominio.com) y verifica que esté apuntando a la IP de tu servidor. Puedes verificarlo usando esta herramienta.
3. Espera la configuración: en unos minutos recibirás confirmación y podrás acceder a OpenClaw usando tu dominio personalizado por HTTPS.

3. Primer acceso y configuración inicial

1. Accede a tu instancia: ingresa desde el navegador a tu dominio o subdominio recién configurado.
2. Completa el formulario de configuración inicial:
   • Nombre del agente (puedes personalizar cómo se llama el asistente)
   • Nombre de usuario administrador
   • Contraseña segura (mínimo 8 caracteres)
   • Email válido para recuperación
3. Confirma la creación del usuario administrador.

¡Listo! Ya puedes comenzar a configurar tus integraciones con canales de mensajería y a usar tu asistente IA.

4. Integraciones con canales de mensajería

OpenClaw se destaca por su capacidad de conectarse a múltiples plataformas de mensajería. Una vez dentro del panel, puedes integrar tu agente con:

• Telegram — Crea un bot con BotFather y pega el token en la configuración.
• WhatsApp — Escanea el código QR desde la interfaz de OpenClaw.
• Discord — Configura un bot en el portal de desarrolladores de Discord.
• Slack — Usa la integración de Slack Apps para conectar tu workspace.
• Signal — Enlaza tu número de Signal a través del flujo de vinculación.

Sigue las instrucciones del asistente de configuración dentro de la interfaz de OpenClaw para cada canal.

5. Configuración avanzada con variables de entorno

El archivo de configuración de OpenClaw se encuentra en /root/app/.env. Solo deberías acceder a este archivo si necesitas configuraciones avanzadas. Para la mayoría de los casos, la configuración desde la interfaz web es suficiente.

cp /root/app/.env /root/app/.env.backup

Configuración de SMTP (correo electrónico)

Si quieres que OpenClaw pueda enviar notificaciones por email, configura un servidor SMTP en el archivo .env. Puedes utilizar cualquier servicio SMTP, como EnvíaloSimple.

# Configuración de emails
SMTP_HOST=tu-servidor-smtp.com
SMTP_PORT=587
SMTP_USER=tu-email@tudominio.com
SMTP_PASS=tu-contraseña-smtp
SMTP_SECURE=false

cd /root/app && docker compose down && docker compose up -d

Comandos útiles para administración

# Ver estado de los contenedores
cd /root/app
docker compose ps
 
# Ver logs en tiempo real
docker compose logs -f
 
# Reiniciar todos los servicios
docker compose restart
 
# Detener servicios
docker compose down
 
# Iniciar servicios
docker compose up -d
 
# Actualizar a la última versión
docker compose pull
docker compose up -d

6. Actualizar OpenClaw

Para actualizar OpenClaw a la última versión disponible:

1. Ingresa por SSH a tu servidor.
2. Ejecuta cd /root/app para ir al directorio de la aplicación.

3. Realiza un pull del contenedor actualizado y reinicialo: 

   docker compose pull
   docker compose up -d

4. ¡Listo! Tu instancia de OpenClaw se encuentra actualizada.

7. Consideraciones de seguridad

Te recomendamos aplicar estas medidas básicas para mantener tu instancia segura:

• Configuración inicial inmediata: completa el formulario de primer acceso en cuanto tu dominio esté activo.
• Contraseña robusta: utiliza una contraseña de al menos 12 caracteres con letras, números y símbolos.
• Acceso autenticado: OpenClaw en Cloud Server configura por defecto la autenticación de mensajes directos (DM pairing), que impide que personas no autorizadas interactúen con tu agente.
• Aislamiento Docker: la instalación Click&Go ejecuta OpenClaw dentro de contenedores Docker, lo que agrega una capa adicional de aislamiento.
• Firewall del Cloud Server: asegurate de que el firewall de tu Cloud Server solo tenga abiertos los puertos necesarios (80 y 443 para HTTP/HTTPS).