OpenClaw en tu homelab: agente de IA con Telegram

Servidores en rack representando un homelab donde desplegar agentes de IA de forma controlada

¿Qué es OpenClaw y por qué instalarlo en tu homelab?

OpenClaw es una plataforma self-hosted para conectar tus canales habituales —por ejemplo Telegram, WhatsApp, Slack, Discord o una interfaz web— con agentes de IA capaces de ejecutar tareas.

Dicho de forma sencilla: no es solo “otro chat con IA”. Es una capa que hace de puente entre tú, tus canales de comunicación y un agente que puede usar herramientas, trabajar con archivos, consultar información y ayudarte a automatizar tareas.

Y precisamente por eso me interesa para un homelab.

Porque un homelab no es solo un sitio donde montas contenedores. Es un laboratorio donde puedes probar qué pasa cuando conectas IA con infraestructura real: logs, scripts, servicios, alertas, documentación, backups, automatizaciones y canales como Telegram.

Ahora bien, conviene empezar con una advertencia clara: un agente de IA con acceso a herramientas no es un juguete.

Si le das permisos para leer archivos, ejecutar comandos o actuar sobre servicios, estás poniendo una pieza bastante potente dentro de tu red. Puede ser tremendamente útil, pero también puede equivocarse, interpretar mal una orden o actuar sobre información incompleta.

Por eso este artículo no va de “instala OpenClaw y dale acceso a todo”. Va de instalarlo con cabeza, empezar con permisos controlados y usarlo como laboratorio seguro.

Si todavía no tienes claro qué son los agentes de IA, te recomiendo leer antes el artículo sobre qué son los agentes de IA y cómo usarlos.

Qué vamos a montar

El objetivo es instalar OpenClaw en un servidor Linux de tu homelab y conectarlo con Telegram.

El flujo final será este:

Tú escribes al bot desde Telegram.
Telegram entrega el mensaje a OpenClaw.
OpenClaw lo pasa al agente y al modelo de IA configurado.
El agente responde o propone acciones.
Tú mantienes el control de qué permisos tiene y qué puede tocar.

Lo montaremos usando el asistente de configuración interactivo, que es la forma más cómoda para empezar porque evita escribir a mano toda la configuración desde cero.

La idea es dejarlo así:

Gateway local escuchando solo en loopback.
Control UI accesible localmente o por túnel/VPN.
Telegram como canal principal.
Allowlist para que solo tú puedas hablar con el bot.
Workspace aislado para que el agente no trabaje en cualquier carpeta del sistema.
Modelo de IA local con Ollama o vía API externa, según tu caso.

Mi recomendación inicial: primero que observe y responda; luego, si todo funciona, ya le das capacidades más delicadas.

Requisitos previos

Servidor Linux. Ubuntu 22.04 o 24.04 son buenas opciones.
Acceso sudo al servidor.
Conexión a Internet.
Una cuenta de Telegram.
Un modelo de IA: API externa o modelo local con Ollama.
Node.js 24 recomendado o Node.js 22.19+ si lo instalas manualmente.
Entre 10 y 20 minutos para completar el asistente.

El instalador oficial puede encargarse de detectar e instalar Node si hace falta, así que no me obsesionaría con prepararlo todo a mano salvo que quieras controlar tú cada paquete.

Si vas a usar modelos locales, te recomiendo tener antes Ollama funcionando. Si vas a usar OpenAI, Anthropic, Google Gemini, DeepSeek, OpenRouter u otro proveedor, necesitarás la API key correspondiente.

Paso 1: preparar el servidor

Antes de instalar nada, actualiza el sistema:

sudo apt update
sudo apt upgrade -y
sudo apt install curl ufw -y

Ahora configura un firewall básico:

sudo ufw default deny incoming
sudo ufw default allow outgoing
sudo ufw allow ssh
sudo ufw enable

En el borrador inicial abríamos el puerto 18789 para la red local. Yo lo matizaría.

Si configuras OpenClaw en modo loopback, el Gateway queda escuchando en 127.0.0.1:18789. En ese caso, no necesitas abrir el puerto 18789 en el firewall. Para acceder al Control UI desde otro equipo, prefiero usar una de estas opciones:

SSH tunnel desde tu portátil.
WireGuard si ya tienes VPN en el homelab.
Tailscale si quieres algo cómodo sin abrir puertos.

Ejemplo con túnel SSH:

ssh -L 18789:127.0.0.1:18789 usuario@IP-DE-TU-SERVIDOR

Y luego abres en tu navegador:

http://127.0.0.1:18789

¿Puedes permitir el puerto 18789 solo desde tu LAN? Sí, pero no lo haría de entrada si el modo loopback ya cubre el caso. Cuanto menos expongas, mejor.

Paso 2: crear el bot de Telegram

Antes de instalar OpenClaw, crea el bot de Telegram porque necesitarás el token durante la configuración.

Abre Telegram.
Busca @BotFather.
Ejecuta /newbot.
Ponle un nombre, por ejemplo Mi Asistente Homelab.
Elige un username que termine en bot, por ejemplo mi_asistente_homelab_bot.
BotFather te dará un token.

Ese token es una contraseña. Trátalo como tal.

El token del bot de Telegram es una contraseña. No lo pegues en capturas, no lo subas a GitHub y no lo guardes en documentación pública. Si se filtra, revócalo desde BotFather y genera uno nuevo.

No lo pegues en capturas. No lo subas a GitHub. No lo pongas en artículos. No lo compartas por chats. Si se filtra, revócalo desde BotFather y genera uno nuevo.

Telegram permite revocar el token desde BotFather, así que si tienes dudas, mejor rotarlo que quedarte con un token expuesto.

Paso 3: instalar OpenClaw

La vía rápida es usar el instalador oficial:

curl -fsSL https://openclaw.ai/install.sh | bash

Este instalador detecta el sistema, prepara dependencias, instala OpenClaw y lanza el asistente de configuración.

Como siempre que usamos un patrón tipo curl | bash, conviene decirlo claro: es cómodo, pero implica confiar en el instalador remoto.

Si eres más conservador, revisa primero el script:

curl -fsSL https://openclaw.ai/install.sh -o install-openclaw.sh
less install-openclaw.sh
bash install-openclaw.sh

En un homelab personal puedo aceptar el instalador oficial, pero no lo ejecutaría a ciegas en un entorno corporativo sin revisar qué hace.

Paso 4: asistente de configuración

Después de instalar, OpenClaw lanza el asistente de onboarding. Si no se abre automáticamente, puedes ejecutarlo con:

openclaw onboard

El asistente te guiará por los pasos principales.

Configuración existente

Si es la primera instalación, normalmente seguirá adelante sin mucha historia.

Si ya existe configuración, puede preguntarte si quieres mantenerla, modificarla o empezar de cero.

Keep: conservar configuración actual.
Modify: cambiar partes concretas.
Reset: reiniciar configuración.

Si estás siguiendo este tutorial por primera vez, lo normal es ir con configuración limpia.

Modo de configuración

El asistente puede ofrecerte un modo rápido y otro manual/avanzado.

QuickStart: menos preguntas, valores razonables para empezar.
Manual/Advanced: más control sobre puerto, bind, autenticación, canales y opciones.

Para una primera instalación en homelab, usaría QuickStart siempre que puedas confirmar que deja el Gateway en loopback y con autenticación.

Si quieres control total desde el principio, usa modo manual. Pero no lo haría solo por “sentirme avanzado”. Lo haría si realmente necesitas tocar bind, puerto, acceso remoto o configuración de canales.

Paso 5: elegir proveedor de IA

Esta es una de las pantallas más importantes.

OpenClaw necesita un modelo de IA detrás. Puede ser local o remoto. La decisión depende de tu prioridad: calidad, coste, privacidad o rendimiento.

Proveedor	Ventaja	Cuándo lo usaría
Anthropic	Muy buena calidad en tareas de razonamiento y uso de herramientas	Si quieres máxima calidad y aceptas coste/API externa
OpenAI	Muy buena compatibilidad y ecosistema	Si ya usas OpenAI y quieres resultados sólidos
Google Gemini	Buen ecosistema y opciones multimodales	Si ya trabajas con Google o quieres probar alternativas
DeepSeek	Buena relación coste/rendimiento según modelo	Si quieres experimentar con modelos económicos y potentes
Ollama local	Privacidad y control local	Si tienes hardware y quieres que los prompts no salgan de casa
Custom Provider	Flexibilidad	Si usas OpenRouter, LM Studio, endpoint compatible u otro proveedor

Mi recomendación para homelab:

Para probar con privacidad: Ollama local.
Para tareas serias con mejor calidad: OpenAI o Anthropic.
Para experimentar con coste contenido: DeepSeek, OpenRouter u otro proveedor compatible.

Eso sí: no diría “Ollama = privacidad total” sin matices. Ollama local evita enviar prompts al proveedor cloud, pero la privacidad real depende de qué herramientas conectes, qué logs guardes, qué permisos tenga el agente y qué datos le des.

Con agentes, la privacidad no depende solo del modelo. Depende de todo el flujo.

Paso 6: workspace del agente

El workspace es la carpeta donde el agente puede trabajar con archivos.

La ruta por defecto suele ser:

~/.openclaw/workspace

Para empezar, la dejaría así.

No apuntes el workspace a tu home completo. No lo apuntes a la raíz del sistema. No lo apuntes directamente a carpetas sensibles como backups, claves SSH, documentos privados o configuración de servicios críticos.

La idea es que el agente tenga una zona de trabajo controlada.

Si luego quieres darle acceso a documentación del homelab, copia ahí una versión controlada o monta solo lo necesario. El principio es el mismo que en seguridad clásica: mínimo privilegio.

Paso 7: Gateway y Control UI

El Gateway es el componente central. Es el puente entre canales, modelo, herramientas y sesiones.

En una instalación doméstica, yo lo configuraría así:

Puerto: 18789.
Bind: 127.0.0.1.
Autenticación: token.
Acceso remoto: vía SSH tunnel, WireGuard o Tailscale.

No lo expondría directamente a Internet.

Si necesitas acceso desde otro equipo de casa y no quieres túnel SSH, podrías hacer bind a la IP LAN y limitar con firewall. Pero eso ya es un paso más. Para empezar, loopback es más seguro.

Para abrir el dashboard:

openclaw dashboard

o desde navegador en el propio servidor:

http://127.0.0.1:18789

Si estás accediendo desde otro equipo con túnel SSH, esa misma URL funcionará en tu ordenador local.

Paso 8: canal de Telegram

En el asistente, selecciona Telegram como canal.

Te pedirá el token del bot que creaste con BotFather.

Después, configura la política de acceso. Aquí no hay debate: usa allowlist.

La idea es que solo usuarios autorizados puedan hablar con el bot. Si el agente puede hacer cosas en tu servidor, no quieres que cualquier persona que encuentre el bot pueda enviarle instrucciones.

También revisaría estos puntos en BotFather:

Desactivar o limitar lo que no necesites.
No meter el bot en grupos públicos.
Si lo usas en grupos, exigir mención explícita al bot.
No compartir el username del bot como si fuera un canal público.

Para mi uso personal, lo dejaría en mensajes directos y allowlist. Ya habrá tiempo de meterlo en grupos si de verdad aporta algo.

Paso 9: daemon como servicio

El asistente puede ofrecer instalar OpenClaw como servicio en segundo plano.

En Linux, lo normal es que use systemd, muchas veces como servicio de usuario.

Yo diría que sí.

Esto permite que el Gateway arranque al iniciar el servidor y siga funcionando aunque cierres sesión.

Después de instalarlo, revisa el estado:

openclaw status

Y mira logs:

openclaw logs

Si usa systemd de usuario, puede que necesite habilitar linger para que el servicio siga activo sin sesión abierta. El asistente normalmente se encarga o te pide permisos cuando hace falta.

Paso 10: primer arranque y prueba

Cuando termine el asistente, debería ejecutar un health check.

Lo normal es ver algo parecido a:

Gateway started
Health check passed
Telegram channel connected

No te quedes solo con el “passed”. Prueba tú el flujo real.

Abre Telegram, busca tu bot y mándale:

Hola

Si el sistema usa pairing, te pedirá aprobar la vinculación. Puedes listar solicitudes con:

openclaw pairing list telegram

Y aprobar una solicitud:

openclaw pairing approve telegram CODIGO

Una vez vinculado, empieza con preguntas inocentes:

¿Qué hora es?
Resume qué puedes hacer ahora mismo.
Qué permisos tienes disponibles.
Qué workspace estás usando.

No empieces pidiéndole que ejecute comandos delicados. Primero entiende qué puede hacer, qué contexto tiene y dónde escribe.

Comandos útiles del día a día

Comando	Para qué sirve
`openclaw status`	Ver estado del Gateway y del agente
`openclaw logs`	Ver logs
`openclaw configure`	Reabrir configuración
`openclaw onboard`	Volver a ejecutar el asistente
`openclaw dashboard`	Abrir el Control UI
`openclaw pairing list telegram`	Listar solicitudes de vinculación de Telegram
`openclaw pairing approve telegram CODIGO`	Aprobar una vinculación concreta

La CLI puede cambiar entre versiones, así que si un comando no responde como esperas, usa:

openclaw --help

o revisa la documentación de tu versión instalada.

Seguridad adicional

Esta sección es la más importante del artículo.

OpenClaw puede ser muy útil, pero un agente con herramientas dentro de tu homelab debe tratarse como una pieza sensible.

No expongas el Control UI a Internet. Usa SSH tunnel, WireGuard o Tailscale.
Usa allowlist en Telegram. Nada de bots abiertos.
No uses tu usuario principal para todo. Crea un usuario dedicado si vas a experimentar en serio.
Limita el workspace. No le des acceso a todo tu home ni a carpetas críticas.
Protege la configuración. Los tokens y API keys deben tener permisos restrictivos.
No le des permisos sudo. Salvo laboratorio muy controlado, un agente no debería poder elevar privilegios.
Revisa skills antes de instalarlas. No instales habilidades de terceros sin entender qué hacen.
Haz backups. Especialmente del workspace y configuración, pero sin exponer secretos.
Mira logs. Un agente que actúa sin observabilidad es mala idea.

Permisos básicos recomendados:

Mi criterio con un agente conectado a un servidor es claro: primero lectura, luego propuesta, después confirmación humana y solo al final ejecución. Dar permisos de administrador a una IA sin límites ni logs es una mala idea, incluso en un homelab.

chmod 700 ~/.openclaw
chmod 700 ~/.openclaw/workspace
chmod 600 ~/.openclaw/openclaw.json 2>/dev/null || true

Si tu instalación usa otra ruta de configuración, adapta los comandos. No copies permisos sin comprobar dónde guarda realmente OpenClaw tus secretos.

Si quieres una base sólida, revisa también la guía de hardening básico de servidores Linux y la estrategia 3-2-1 de backups.

Skills y capacidades: poco a poco

OpenClaw puede ampliarse con skills o integraciones.

Eso es lo que lo hace interesante, pero también lo que aumenta el riesgo.

Para empezar, yo no instalaría diez skills de golpe. Haría esto:

Primero Telegram funcionando.
Después modelo estable.
Luego workspace controlado.
Después una skill concreta.
Y solo cuando entiendas qué hace, añades otra.

Skills que pueden tener sentido en un homelab:

Web search: para consultas externas, si configuras proveedor de búsqueda.
Memory: para mantener contexto útil, con cuidado con qué guardas.
Files: para trabajar dentro del workspace.
Shell/commands: solo si tienes muy claro el riesgo y límites.
Home Assistant: interesante, pero con permisos muy restringidos.

Mi regla: si una skill puede borrar, modificar o ejecutar, primero la pruebo en entorno aislado.

¿Y ahora qué?

Una vez tienes OpenClaw funcionando con Telegram, las posibilidades son enormes. Pero no empezaría por automatizarlo todo.

Empezaría con casos de uso de bajo riesgo:

Preguntar por documentación del homelab.
Resumir logs copiados manualmente.
Generar comandos, pero revisarlos tú antes de ejecutarlos.
Crear notas o borradores.
Consultar estado de servicios si lo conectas de forma segura.
Preparar checklist de mantenimiento.

Después podrías avanzar a casos más potentes:

Revisión programada de alertas.
Resumen diario de logs.
Consulta de estado de contenedores.
Integración con Home Assistant.
Gestión de documentación del homelab.
Subagentes para tareas concretas.

Pero siempre con la misma lógica:

Observar → Recomendar → Confirmar → Ejecutar

Ese orden importa. Mucho.

Resumen

OpenClaw es una pieza muy interesante para llevar agentes de IA a tu homelab, especialmente si quieres interactuar con ellos desde Telegram o desde una interfaz local.

Pero no lo trataría como un simple chatbot. Es más potente que eso. Y por tanto exige más cuidado.

Mi instalación recomendada sería:

Gateway en 127.0.0.1.
Acceso remoto solo por SSH tunnel, WireGuard o Tailscale.
Telegram con allowlist.
Workspace aislado.
Modelo local o API según necesidad.
Skills instaladas poco a poco.
Sin permisos sudo.
Logs revisables.
Backups claros.

Para mí, OpenClaw encaja muy bien como laboratorio de agentes personales. Te permite probar hasta dónde puedes llegar con IA conectada a tus herramientas reales, pero sin olvidar lo más importante: un agente autónomo dentro de tu red debe tener límites claros.

La IA local y los agentes tienen muchísimo potencial. Pero el criterio sigue siendo el mismo que en cualquier homelab serio: primero entender, luego automatizar.

¿Ya tienes OpenClaw funcionando? ¿Lo usas con Telegram, WhatsApp, Slack o solo desde el dashboard? Cuéntalo en los comentarios — las configuraciones reales enseñan más que cualquier demo perfecta.

Instala OpenClaw en tu homelab: agente de IA con Telegram