El propósito de este artículo
Si buscas información sobre OpenClaw en internet, casi todo lo que encuentras son artículos introductorios del tipo “¿Qué es OpenClaw?”. Resúmenes, casos de uso y traducciones de ejemplos generales. Todo eso está muy bien.
Sin embargo, en el momento en que intentas alojarlo y ejecutarlo en tu propio servidor, la información práctica que necesitas no aparece por ningún lado.
Este artículo es una nota de implementación práctica basada en mi experiencia real ejecutando OpenClaw en una configuración de múltiples hosts (cross-host) en una red LAN e integrándolo con un Bot de Discord. Lo escribí como el “siguiente paso” para aquellos que leyeron un artículo introductorio y pensaron: “Bien, vamos a poner esto en marcha”.
La brecha entre las introducciones y la realidad
Lo que te dicen los artículos introductorios
- OpenClaw es una plataforma de agentes de IA de código abierto.
- Puedes acceder a múltiples agentes a través del Gateway.
- Se integra con plataformas como Discord, Telegram, Slack, etc.
- Puedes interactuar mediante una CLI (TUI).
Todo esto es totalmente cierto.
Lo que no te dicen los artículos introductorios
| Problema en el mundo real | ¿Se menciona en los tutoriales? |
|---|---|
El Gateway solo hace bind a 127.0.0.1 por defecto. | ❌ |
| Conectarse desde otra máquina requiere cambiar la configuración de bind y abrir el firewall. | ❌ |
| Las conexiones remotas requieren autenticación por token. | ❌ |
| Los dispositivos nuevos no pueden conectarse a menos que reciban “aprobación de emparejamiento” (pairing approval). | ❌ |
| Si te equivocas en el momento de aprobar el emparejamiento, el sistema se bloquea. | ❌ |
Configurar un bind custom rompe la TUI en la máquina local. | ❌ |
| La integración con Discord requiere operaciones de CLI en el servidor, no solo “Autorizar la aplicación” en Discord. | ❌ |
Ninguno de estos son bugs (errores); son así por diseño (especificaciones). Sin embargo, la documentación aún no es lo suficientemente completa, obligándote a resolver estos problemas por tu cuenta.
Por qué necesitas esta información
Si solo vas a usar OpenClaw en una sola máquina local con la configuración por defecto, casi nunca te encontrarás con estos problemas. Simplemente ejecutas openclaw tui y funciona.
El problema sale a la luz en el momento en que intentas cualquiera de las siguientes cosas:
- Quieres separar la máquina con la GPU de la máquina que aloja el Bot.
- Quieres conectarte desde un host diferente en tu red LAN.
- Quieres ejecutar un Bot de Discord como un proceso independiente.
- Quieres gestionarlo como un servicio de
systemdque se inicie automáticamente en producción.
En resumen, en el momento en que intentas usarlo en un entorno de producción real, pisarás todas y cada una de estas minas.
Visión general de la arquitectura real
Esta es la configuración real que se está ejecutando en este repositorio:
Host A (Linux) Host B (Linux)
┌──────────────────────┐ ┌──────────────────────────┐
│ python src/main.py │── WebSocket ──>│ OpenClaw Gateway │
│ (Bot de Discord) │ LAN │ ws://192.168.0.108:18789│
│ 192.168.0.15 │ │ ↓ │
└──────────────────────┘ │ Agent: main │
↑ └──────────────────────────┘
API de Discord
↑
Usuario (Discord)
