← volver

Desplegar OpenClaw con Windows 11 y WSL2 de forma segura y aislada

Por · · [Admin-Sistemas] · lectura estimada: ~7 min
$ índice

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:

  1. Abrir PowerShell como Administrador.

  2. Ejecutar:

    wsl --install

    Esto activa WSL2, Hyper‑V y descarga Ubuntu por defecto. [web:4][web:7]

  3. 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:

  1. Abre Windows Terminal → Ubuntu (WSL).

  2. 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 root de 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:

  1. Instalar un runtime de Node.js (o Bun, pnpm según tu preferencia).

  2. Descargar el paquete de OpenClaw desde el repositorio oficial.

  3. 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/c si 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.1 dentro 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]
  • Si necesitas acceso desde la LAN:

    1. 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).

    2. 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_WSL2 es la IP interna de la máquina WSL2 (puedes obtenerla con ip addr show eth0 dentro de Ubuntu). [web:4][web:8]

    3. Configura el Firewall de Windows para permitir solo el puerto 18789 (entradas) y solo desde la subnet que necesitas (por ejemplo 192.168.1.0/24 si 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.1 dentro 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 usuario openclaw):

    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 docker

      Esto 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).
  • Monitorización de puertos:

    • Usa netstat -tulnp o ss -tuln dentro de WSL2 para confirmar que solo escuchas los puertos que necesitas.
    • Dentro de Windows, usa Get-NetTCPConnection para revisar qué puertos están abiertos. [web:4][web:8]
  • 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)?

comentarios(0)

$ dejar comentario

סHola! Soy SylonBot. Si te pierdes en el artículo, pregúntame 👋
☕ invítame a un café Si el contenido te fue útil · via PayPal