Desplegar OpenClaw con Windows 11 y WSL2 de forma segura y aislada
Desplegar OpenClaw con Windows 11 y WSL2 de forma segura y aislada
En este artículo veremos cómo montar una instancia de OpenClaw en Windows 11 usando WSL2 (Windows Subsystem for Linux), con foco en seguridad, aislamiento y estabilidad. El objetivo es que el entorno de tu agente de IA quede lo más “blindado” posible, sin exponerlo innecesariamente a la red o a otros servicios del host.
Nota: OpenClaw (docs) está orientado a ejecutarse en Linux; WSL2 es hoy la forma más recomendada para usarlo en Windows manteniendo compatibilidad completa con Node.js/Bun/pnpm y el gestor de nodos y gateway. [web:4][web:7]
1. Requisitos y contexto técnico
Antes de entrar en el despliegue, conviene delimitar el escenario:
- Windows 10 (2004+) o Windows 11 con soporte para WSL2 y virtualización activa. [web:4][web:9]
- Una distribución Linux en WSL2 (Ubuntu es la más soportada y recomendada). [web:4][web:7]
- Conexión a Internet para descargar dependencias y modelos (si trabajas con LLMs en la nube o modelos locales).
- Acceso como Administrador en Windows para configurar WSL2, firewall y servicios. [web:4][web:9]
OpenClaw se compone de:
- CLI (
openclaw) para gestionar el agente, perfiles y nodos. [web:4] - Gateway (servicio HTTPS en un puerto, por ejemplo
18789) para comunicar el cliente, el web UI y posibles integraciones externas. [web:4][web:6]
El uso de WSL2 permite que todo esto se ejecute en un entorno Linux real, mientras que el host Windows queda como “capa de virtualización” y aislamiento lógico.
2. Preparar WSL2 y Ubuntu con seguridad
2.1. Activar WSL2 y Hyper‑V
En Windows 11, lo más rápido es:
-
Abrir PowerShell como Administrador.
-
Ejecutar:
wsl --installEsto activa WSL2, Hyper‑V y descarga Ubuntu por defecto. [web:4][web:7]
-
Reiniciar el equipo si el sistema lo indica.
Tras el reinicio, WSL2 queda en modo virtualizado, con su propia red NAT interna por defecto, lo que ya aporta un primer nivel de aislamiento frente al host.
2.2. Ajustar la red de WSL2 (opcional, pero recomendable)
WSL2 por defecto usa una red NAT privada. Si quieres que:
- OpenClaw sea accesible desde la LAN (por ejemplo, desde otro PC o móvil),
- O games con VPN / proxy no rompan el DNS dentro de WSL,
puedes usar el modo “mirrored” modificando el archivo global de WSL2 (%USERPROFILE%\.wslconfig):
[wsl2]
networkingMode=mirrored
dnsTunneling=true
autoProxy=true
firewall=true
[experimental]
autoMemoryReclaim=gradual
hostAddressLoopback=true
Este modo hace que WSL use la misma interfaz de red que Windows, lo que facilita el acceso desde la LAN, pero también implica que el tráfico de WSL2 puede ser inspeccionado por el firewall de Windows. Eso puede ser útil para auditar conexiones salientes de OpenClaw. [web:2][web:8]
3. Crear un entorno Linux aislado en Ubuntu (WSL2)
Una vez tienes Ubuntu instalado:
-
Abre Windows Terminal → Ubuntu (WSL).
-
Actualiza el sistema:
sudo apt update && sudo apt upgrade -y
3.1. Aislamiento por usuario y permisos
Para mayor seguridad:
-
Crea un usuario dedicado para OpenClaw:
sudo adduser openclaw sudo usermod -aG sudo openclaw su - openclaw -
Instala dependencias solo para este usuario (no uses
rootde forma habitual). -
Usa directorios de trabajo aislados:
mkdir -p ~/openclaw/{config,workspace,secrets} chmod 700 ~/openclaw/secrets
Esto limita el acceso a credenciales y archivos sensibles solo a ese usuario dentro de WSL2.
3.2. Activar systemd (obligatorio para el Gateway)
OpenClaw requiere que WSL2 pueda ejecutar servicios mediante systemd. [web:3][web:4]
En Ubuntu dentro de WSL2:
sudo tee /etc/wsl.conf >/dev/null <<'EOF'
[boot]
systemd=true
EOF
Luego, desde PowerShell como Administrador:
wsl --shutdown
Reinicia Ubuntu y verifica que systemd está activo:
ps -p 1 -o comm=
# Debe devolver `systemd`
Con systemd activo podrás gestionar el gateway como un servicio Linux, mejorando estabilidad y control. [web:4][web:7]
4. Instalar OpenClaw de forma segura
4.1. Usar el método oficial y evitar binarios no firmados
Sigue la guía oficial de instalación para WSL2 en Windows: [web:4][web:7]
Generalmente el flujo es:
-
Instalar un runtime de Node.js (o Bun, pnpm según tu preferencia).
-
Descargar el paquete de OpenClaw desde el repositorio oficial.
-
Crear un perfil de usuario seguro:
openclaw init profile --name personal openclaw init profile --name discord --sandboxed
Crucial: no uses perfiles sin sandbox para sesiones que vengan de fuentes externas (Discord, grupos, WebChat pública, etc.). [web:10]
4.2. Aislamiento de sesiones y nodos
OpenClaw permite definir perfiles aislados con distintos niveles de confianza:
- Perfil principal (
personal): herramientas completas, acceso a archivos locales de WSL2, e incluso montajes como/mnt/csi decides usarlos. - Perfil secundario (
discord,webchat): limitado, idealmente con sandbox por contenedor (por ejemplo Docker) para evitar que comandos maliciosos afecten al host o al resto de servicios. [web:6][web:10]
Ejemplo de buena práctica:
openclaw init profile --name discord --sandboxed --container
Esto fuerza que cualquier comando ejecutado desde Discord se lance dentro de un contenedor, no en el propio WSL2 host. [web:6][web:10]
5. Seguridad de red y firewall
5.1. Exponer el Gateway solo cuando sea necesario
El Gateway de OpenClaw suele escuchar en un puerto fijo (por ejemplo 18789). [web:4][web:8]
-
Si solo tú lo usas desde el PC:
- Enlázalo solo a
127.0.0.1dentro de WSL2:--host 127.0.0.1 --port 18789. - El acceso queda restringido al localhost, incluso dentro de la red virtual de WSL2. [web:4][web:6]
- Enlázalo solo a
-
Si necesitas acceso desde la LAN:
-
En Ubuntu (WSL2) haz que el servicio escuche en
0.0.0.0(por ejemplo a través de systemd o de un script de inicio). -
En Windows, crea una regla de portproxy para mapear el puerto de WSL2 al host:
netsh interface portproxy add v4tov4 listenport=18789 listenaddress=0.0.0.0 connectport=18789 connectaddress=<IP_WSL2>donde
IP_WSL2es la IP interna de la máquina WSL2 (puedes obtenerla conip addr show eth0dentro de Ubuntu). [web:4][web:8] -
Configura el Firewall de Windows para permitir solo el puerto
18789(entradas) y solo desde la subnet que necesitas (por ejemplo192.168.1.0/24si es tu LAN). [web:4][web:8]
-
Esto asegura que:
- El puerto no es accesible desde internet a menos que tengas un router mal configurado.
- Un posible atacante local tiene que conocer tu IP y puerto exacto.
5.2. Uso de VPN o túnel privado
Si quieres usar OpenClaw desde fuera de casa de forma segura:
- Usa una VPN propia (Tailscale, WireGuard) y expón el Gateway solo al túnel.
- O bien, emplea un proxy inverso TLS (Nginx, Caddy) en otro servidor con certificado Let’s Encrypt, y deja que el Gateway solo escuche en
127.0.0.1dentro de WSL2. [web:6][web:6]
Evita exponer el puerto 18789 directamente al mundo si no puedes controlar el firewall o el router. [web:6][web:10]
6. Protección de credenciales y secretos
OpenClaw necesita API keys de LLMs, servicios de almacenamiento, etc. [web:5][web:6]
6.1. Mantener secretos fuera de repos y logs
-
Guarda las claves en
~/openclaw/secrets/(acceso solo para el usuarioopenclaw):chmod 600 ~/openclaw/secrets/*.key -
No introduzcas credenciales en:
- Archivos de configuración de Git.
- Logs de comandos o scripts que puedan imprimirse por pantalla.
6.2. Usar un gestor de contraseñas o bóveda
Recomendaciones típicas:
- 1Password / Bitwarden / KeePassXC con una bóveda dedicada a “OpenClaw/LLMs”. [web:6]
- En entornos más avanzados, usa Vault (HashiCorp) o un equivalente si estás integrando OpenClaw en un entorno DevOps.
Esto evita que las claves de API queden en texto plano en el sistema de ficheros o en el historial de Bash. [web:6]
7. Aislamiento adicional: contenedores y sandbox
WSL2 + Docker permite un nivel extra de aislamiento. [web:6][web:10]
7.1. Ejecutar perfiles en contenedores Docker
Para sesiones menos confiables:
-
Instala Docker dentro de Ubuntu (WSL2) o usa Docker Desktop en Windows y monta el sock de Docker en WSL2. [web:6][web:10]
-
Configura OpenClaw para que:
-
El perfil principal ejecute comandos en el propio WSL2.
-
El perfil Discord/WebChat ejecuten cada comando en un contenedor efímero:
openclaw config set --profile discord executor dockerEsto encapsula cada invocación en un contenedor, limitando el alcance de comandos maliciosos. [web:6][web:10]
-
7.2. Limitar recursos dentro de WSL2
WSL2 permite limitar CPU, memoria y disco. [web:2][web:8]
Puedes añadir al fichero global de WSL2 (.wslconfig):
[wsl2]
memory=4GB
processors=4
swap=1GB
Esto previene que un runaway de OpenClaw o un modelo local consuma todo el host, y ayuda a mantener el resto del sistema estable. [web:2][web:8]
8. Monitorización básica y logs
Para un entorno seguro y “operable”, conviene:
-
Logs centralizados:
- Guarda los logs de OpenClaw en
~/openclaw/logs/con rotación diaria. - Ejemplo de script básico de rotación (logrotate o simple rotación por tamaño).
- Guarda los logs de OpenClaw en
-
Monitorización de puertos:
- Usa
netstat -tulnposs -tulndentro de WSL2 para confirmar que solo escuchas los puertos que necesitas. - Dentro de Windows, usa
Get-NetTCPConnectionpara revisar qué puertos están abiertos. [web:4][web:8]
- Usa
-
Alertas simples:
- Script que compruebe cada X minutos que el proceso de OpenClaw está vivo y reaccione con un toast o email en caso de fallo.
Todo esto es especialmente útil si dejas OpenClaw en modo “servicio” ejecutándose en segundo plano. [web:4][web:8]
9. Buenas prácticas de seguridad en tu despliegue
Para resumir, aquí tienes una checklist adaptada a tu entorno:
| Aspecto | Qué hacer |
|---|---|
| Entorno de ejecución | WSL2 + Ubuntu, perfiles aislados, systemd activo. [web:4][web:7] |
| Red | Escuchar en 127.0.0.1 cuando sea posible; portproxy + firewall estricto si expones a LAN. [web:4][web:8] |
| Credenciales | Secretos en directorio con permisos 600, fuera de Git. [web:6] |
| Sesiones externas (Discord) | Ejecutar en contenedores Docker sandboxeados. [web:6][web:10] |
| Acceso remoto seguro | Usar VPN privada o proxy inverso con TLS, no abrir 18789 al público. [web:6][web:10] |
| Recursos de máquina | Limitar CPU/memoria de WSL2 para evitar consumo excesivo. [web:2][web:8] |
10. Conclusión: Windows 11 + WSL2 como “sandbox blindado”
Usar OpenClaw sobre Windows 11 mediante WSL2 te permite aprovechar:
- Compatibilidad con Linux para CLI, Node.js/Bun y herramientas típicas. [web:4][web:7]
- Aislamiento de red y proceso que ofrece la capa de WSL2. [web:2][web:8]
- La posibilidad de combinar contenedores Docker para perfiles de baja confianza. [web:6][web:10]
Si además aplicas:
- Firewall de Windows bien ceñido,
- Gestión rigurosa de secretos,
- Uso de perfiles sandboxeados para sesiones externas,
obtienes un entorno bastante robusto para experimentar con OpenClaw sin poner en riesgo tu sistema principal ni exponer tu máquina innecesariamente.
Si quieres, en un artículo posterior puedes ampliar esto con:
- Cómo integrar Tailscale / WireGuard para acceso remoto seguro.
- Cómo montar un proxy inverso con Nginx/Caddy sobre el gateway.
- Patrones de uso en entornos de producción (por ejemplo, OpenClaw como “backend” de un bot de Discord o Telegram).
¿Quieres que te prepare también una versión más corta y orientada a “no‑sysadmin” para el mismo tema, o prefieres que profundice en uno de los bloques (por ejemplo, contenedores Docker + OpenClaw)?