Instalar OpenClaw en Proxmox VE

Qué cubre este artículo sobre OpenClaw en Proxmox VE

Qué es OpenClaw y para qué sirve.
Cómo ejecutar OpenClaw en Proxmox VE dentro de una VM o un contenedor LXC.
Qué recursos requiere el gateway.
Cómo asegurar la red, el firewall y Tailscale.
Cómo configurar modelos, canales y herramientas.
Consejos para backups, snapshots y trampas comunes.

Introducción: OpenClaw en Proxmox VE

OpenClaw es un gateway de código abierto para agentes de IA. Conecta canales de voz y chat como Discord, Telegram, Slack, WhatsApp, Matrix, Signal y otros con modelos locales u hospedados. El gateway funciona como un servicio independiente y puede ejecutar herramientas, skills y plugins. Ejecutar OpenClaw en Proxmox VE ofrece aislamiento, snapshots, backups y gestión simple de recursos.

Proxmox VE es especialmente adecuado para OpenClaw porque puedes separar el asistente en su propio contenedor o VM del resto de los sistemas. Esto es importante, ya que OpenClaw puede ejecutar comandos de shell, acceder al sistema de archivos y realizar otras acciones. Un entorno aislado protege el resto de la red si algo sale mal.

¿Qué es OpenClaw?

OpenClaw es un gateway de asistente de IA autohospedado. Ofrece:

Multi-Canal: Un único gateway sirve varios servicios de mensajería simultáneamente.
Uso de Herramientas: Los agentes pueden ejecutar comandos locales y herramientas.
Proveedores de Modelos: Integración con modelos locales vía Ollama o APIs hospedadas.
Sesiones y Memoria: Las conversaciones y el contexto se mantienen a lo largo de múltiples mensajes.
Skills y Plugins: Capacidades extensibles para tareas específicas.
Sandboxing: Los comandos se pueden ejecutar en entornos aislados.

OpenClaw está dirigido a desarrolladores, power users y autohospedadores que quieren ejecutar su propio asistente de IA siempre activo. El aprendizaje inicial es más pronunciado que con chatbots simples.

¿Por qué Proxmox VE?

Ventajas de Proxmox para OpenClaw:

Aislamiento: Una VM o LXC separa OpenClaw del resto de la red.
Snapshots: Guardar un estado antes de actualizaciones o experimentos.
Backups: Copias de seguridad regulares de la VM o el contenedor.
Gestión de Recursos: Ajustar CPU, RAM y disco fácilmente.
GPU Passthrough: Los modelos locales opcionales pueden ejecutarse en GPU.
Firewall: El firewall integrado controla el acceso.

¿LXC o VM?

LXC

Ventajas: Bajo overhead, arranque rápido, snapshots simples.
Desventajas: Comparte el kernel con el host, aislamiento algo más débil.
Recomendado para: Asistentes personales o de pequeños equipos, uso puro de gateway.

VM

Ventajas: Kernel propio, mejor aislamiento, GPU passthrough más sencillo.
Desventajas: Más overhead, arranque más lento.
Recomendado para: Entornos empresariales, cargas de GPU, requisitos de seguridad más altos.

Para la mayoría de escenarios homelab, un LXC sin privilegios es suficiente. Si necesitas GPU passthrough o aislamiento máximo, elige una VM.

Requisitos de Hardware

El hardware depende de si OpenClaw solo actúa como gateway u hospeda modelos localmente.

Solo Gateway

CPU: 2 a 4 vCPUs.
RAM: 4 a 8 GB.
Disco: 20 a 40 GB.
Red: Acceso a internet para proveedores de API y actualizaciones de canales.

Gateway con Modelo Local

CPU: 4 a 8 vCPUs, según el modelo.
RAM: 8 a 32 GB, según el tamaño del modelo.
Disco: 80 a 200 GB, según el número de modelos.
GPU: Opcional, pero muy recomendada para modelos grandes.

Para empezar, 4 vCPUs, 8 GB de RAM y 40 GB de disco son suficientes. Los modelos locales de 7B u 8B funcionarán lentamente pero de manera funcional.

Ejemplo de Hardware: Mac Pro Trashcan

La siguiente prueba práctica se realizó en un Mac Pro Trashcan:

root@pve:~# lspci | grep -Ei 'vga|3d|display'
02:00.0 VGA compatible controller: Advanced Micro Devices, Inc. [AMD/ATI] Tahiti LE [Radeon HD 7870 XT]
06:00.0 VGA compatible controller: Advanced Micro Devices, Inc. [AMD/ATI] Tahiti LE [Radeon HD 7870 XT]

Estas dos AMD Radeon HD 7870 XT se basan en la antigua arquitectura GCN-1.0 (Tahiti LE). No son compatibles con ROCm. Esto significa que Ollama y otras cargas de trabajo de IA local se ejecutan actualmente en la CPU en este host. El GPU passthrough en Proxmox es teóricamente posible, pero no proporciona aceleración para ejecutar LLMs. Si necesitas inferencia local acelerada, requiere GPUs AMD más nuevas con soporte ROCm o una GPU NVIDIA.

El LXC para OpenClaw se creó con 31 GB de RAM y varios vCPUs, lo que es suficiente para un gateway puro más un pequeño modelo basado en CPU.

Instalación de LXC en Proxmox

1. Descargar la plantilla de Ubuntu

Asegúrate de que una plantilla LXC de Ubuntu 24.04 esté disponible:

pveam update
pveam available | grep ubuntu-24.04
pveam download local ubuntu-24.04-standard_24.04-1_amd64.tar.zst

2. Crear el LXC

Crea un contenedor sin privilegios con los recursos apropiados:

pct create 300 /var/lib/vz/template/cache/ubuntu-24.04-standard_24.04-1_amd64.tar.zst \
  --hostname openclaw \
  --storage local-zfs \
  --rootfs 40 \
  --memory 8192 \
  --cores 4 \
  --net0 name=eth0,bridge=vmbr0,ip=dhcp

3. Iniciar el contenedor

pct start 300
pct exec 300 -- bash

4. Instalar paquetes básicos

apt update && apt upgrade -y
apt install -y curl wget git build-essential

5. Instalar Node.js

OpenClaw requiere Node.js 22.22.3 o más reciente. Por ahora, instala Node.js 26:

curl -fsSL https://deb.nodesource.com/setup_26.x | bash -
apt install -y nodejs

6. Instalar OpenClaw

Sigue las instrucciones de instalación oficiales. La forma más rápida es usar el instalador oficial:

bash -c "$(curl -fsSL https://openclaw.ai/install.sh)"

Si prefieres un instalador automático de la comunidad, también hay un script de instalación para Proxmox:

bash -c "$(wget -qLO - https://raw.githubusercontent.com/Ninso112/proxmox-openclaw-installer/master/install_openclaw.sh)"

7. Iniciar el gateway

Después de la instalación, puedes iniciar el gateway:

openclaw-gateway

La configuración inicial ocurre a través de la interfaz web o la línea de comandos.

Ejemplo Práctico: Instalación en un LXC de Proxmox

El siguiente flujo muestra una instalación real en un LXC sin privilegios bajo Proxmox VE 7.0.2. El contenedor está configurado con 31 GB de RAM.

Información del Sistema

root@Agents:~# uname -a
Linux Agents 7.0.2-6-pve #1 SMP PREEMPT_DYNAMIC PMX 7.0.2-6 (2026-05-20T08:55Z) x86_64 GNU/Linux

root@Agents:~# free -h
               total        used        free      shared  buff/cache   available
Mem:            31Gi        21Mi        30Gi        76Ki       418Mi        31Gi
Swap:          2.0Gi          0B       2.0Gi

Actualizar Paquetes

root@Agents:~# apt update && apt full-upgrade -y
Hit:1 http://security.debian.org trixie-security InRelease
Hit:2 http://deb.debian.org/debian trixie InRelease
Hit:3 http://deb.debian.org/debian trixie-updates InRelease
All packages are up to date.
Summary:
  Upgrading: 0, Installing: 0, Removing: 0, Not Upgrading: 0

Instalar OpenClaw

root@Agents:~# curl -fsSL --proto '=https' --tlsv1.2 https://openclaw.ai/install.sh | bash

Extracto de la salida:

Preparing installer interface...

OpenClaw Installer
Ah, the fruit tree company!

Detected: linux

Install plan
OS: linux
Install method: npm
Requested version: latest

[1/3] Preparing environment
 Node.js not found, installing it now
 Installing Linux build tools (make/g++/cmake/python3)
 Updating package index
 Installing build tools
 Build tools installed
 Installing Node.js via NodeSource
 Downloading NodeSource setup script
 Configuring NodeSource repository
 Installing Node.js
 Node.js v24.20.0 installed
 Active Node.js: v24.20.0 (/usr/bin/node)
 Active npm: 11.19.0 (/usr/bin/npm)

[2/3] Installing OpenClaw
 Git already installed
 Installing OpenClaw v2026.9.2
 Installing OpenClaw package
 OpenClaw npm package installed
 Published openclaw bin link at /usr/bin/openclaw
 OpenClaw installed

[3/3] Finalizing setup

OpenClaw installed successfully (2026.9.2)!
Installation complete. Your productivity is about to get weird.

Starting setup

OpenClaw 2026.9.2 (3928bad)
It's not "failing," it's "discovering new ways to configure the same thing wrong."

Asistente de configuración

El asistente interactivo solicita información sobre avisos de seguridad, nombre del agente y proveedor. En este ejemplo se omitió el proveedor para configurarlo manualmente después:

Setup choices
  For the full step-by-step wizard, run `openclaw onboard --classic`.

Security disclaimer
  OpenClaw runs an AI agent with real access to this machine.
  https://docs.openclaw.ai/gateway/security

How would you like to start?
  Custom setup

I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
  Yes

Help make OpenClaw better?
  No thanks

What should we call your first agent?
  AgentSmith

How should I set things up?
  Full access: find everything automatically

AI detection complete.

AI found
  No existing AI access was detected on this machine.

Recommended installs
  Ollama: Run open models locally
  LM Studio: Local model desktop app
  Claude Code: Anthropic's coding agent CLI
  Codex CLI: OpenAI's coding agent CLI

Model/auth provider
  OpenRouter

OpenRouter auth method
  Back

Model/auth provider
  Skip for now

Next steps
  Workspace: /root/.openclaw/workspace
  Add AI later: re-run `openclaw onboard`
  After AI connects, add a channel: `openclaw channels add`
  Open the dashboard: `openclaw dashboard`

Arquitectura destino

Después de la instalación inicial, el LXC debe configurarse de la siguiente manera:

                 Proxmox
                    |
              Agents (LXC)
                    |
          +---------+---------+
          |                   |
      OpenClaw              Ollama
          |                   |
          |             lokales LLM
          |
          +-- Claude API
          |
          +-- lokales Modell

Los siguientes pasos serían:

Crear un usuario dedicado para agentes.
Trasladar el workspace de OpenClaw desde /root al directorio del usuario.
Configurar la clave de la API de Claude.
Instalar Ollama.
Probar un modelo local.
Usar OpenClaw entre Claude y Ollama.
Crear un segundo LXC para OpenHands.

Instalación de máquina virtual en Proxmox

1. Cargar ISO de Ubuntu

Carga un ISO de Ubuntu Server 24.04 LTS en Proxmox y crea una nueva máquina virtual.

2. Configuración de la máquina virtual

Configuración recomendada:

Machine: q35
CPU type: host
Disk bus: VirtIO SCSI
NIC model: VirtIO
QEMU Guest Agent: Activar
CPU: 4 vCPUs
RAM: 8 GB
Disk: 40 GB

3. Instalar Ubuntu

Inicia la máquina virtual e instala Ubuntu Server. Habilita OpenSSH.

4. Paquetes básicos y Node.js

Ejecuta los pasos 4 a 6 de la sección sobre LXC.

Red y acceso

Vinculación predeterminada

OpenClaw vincula el gateway a 127.0.0.1 o 0.0.0.0 de forma predeterminada, dependiendo de la versión. Para mayor seguridad, limita el gateway a acceso local o exclusivamente a través de Tailscale.

Tailscale recomendado

Tailscale es la forma más sencilla de acceder a OpenClaw de forma segura desde fuera de la LAN:

Instala Tailscale en el LXC o la máquina virtual:

curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up

Realiza la autenticación.
Conéctate mediante la dirección IP de Tailscale.

Tailscale evita exponer puertos públicamente.

Túnel SSH

Alternativa sin Tailscale:

ssh -L 8080:localhost:8080 user@openclaw-host

Luego accede al gateway a través de http://localhost:8080 en tu máquina local.

Firewall y seguridad

OpenClaw puede ejecutar herramientas poderosas, por lo que el aislamiento es fundamental.

Firewall de Proxmox

Habilita el firewall a nivel de datacenter y establece reglas en la máquina virtual o LXC:

Activa el firewall en el datacenter.
Restringe las conexiones entrantes en el contenedor o máquina virtual.
Permite solo los puertos necesarios, como SSH, Tailscale y el puerto del gateway de OpenClaw.

Reglas de firewall recomendadas

Para el LXC o máquina virtual de OpenClaw:

IN ACCEPT -p tcp -dport 22 -s 10.0.0.0/24
IN ACCEPT -p udp -dport 41641
IN DROP

La sintaxis exacta depende de la versión del firewall de Proxmox.

Habilitar sandbox

OpenClaw admite sandbox. Los comandos deben ejecutarse en Docker, Podman o una shell aislada:

export OPENCLAW_SANDBOX=1

Sin puertos públicos

El gateway no debe ser accesible directamente desde Internet. Utiliza Tailscale, una VPN o un túnel SSH.

Configurar proveedores de modelos

OpenClaw funciona con modelos alojados o locales.

APIs alojadas

Agrega un proveedor como OpenAI, Anthropic o un servicio compatible con OpenAI en el gateway o en la configuración:

openclaw provider add openai --api-key DEIN_KEY

Modelos locales con Ollama

Instala Ollama en el mismo LXC, máquina virtual o un contenedor separado:

curl -fsSL https://ollama.com/install.sh | sh
ollama pull llama3.1:8b

Configura OpenClaw para que acceda a Ollama a través de la red interna, por ejemplo http://ollama.lan:11434.

Selección de modelos

Para pruebas iniciales, un modelo de 7B u 8B es adecuado. Para mejores resultados en tareas complejas, utiliza modelos de 14B en adelante si tienes suficiente VRAM.

Conectar canales

OpenClaw puede servir múltiples servicios de mensajería simultáneamente. Cada canal se configura como un plugin.

Canales típicos:

Discord
Telegram
Slack
WhatsApp
Matrix
Signal
iMessage
Google Chat
Microsoft Teams
WebChat

La configuración se realiza a través de la Control UI, el TUI o archivos de configuración. Cada canal generalmente requiere un token o una credencial de API.

Copias de seguridad y snapshots

Snapshots

Crea un snapshot antes de actualizaciones o cambios importantes:

pct snapshot 300 vor-update

Para una máquina virtual:

qm snapshot 300 vor-update

Copias de seguridad

Las copias de seguridad regulares a través del sistema de backup de Proxmox protegen el estado del LXC o máquina virtual. Los datos importantes de OpenClaw se encuentran en el directorio de trabajo del gateway, generalmente bajo ~/.openclaw o en la ruta del workspace configurada.

Qué debe respaldarse

Archivos de configuración
Workspace y State
Session-Logs
Plugins y Skills instalados
Channel-Tokens

GPU-Passthrough para modelos locales

Si OpenClaw necesita ejecutar modelos localmente, puedes pasar una GPU a la VM. En LXC también es posible el GPU-Passthrough, pero resulta más complejo y depende del controlador del host.

VM con GPU

Reenviar el dispositivo PCIe en Proxmox a la VM.
Instalar el controlador NVIDIA o AMD en la VM.
Iniciar Ollama con soporte GPU.
Apuntar OpenClaw a Ollama en el mismo guest o a través de la red.

Para un funcionamiento como gateway puro sin modelos locales, no necesitas GPU.

Nota sobre AMD-GPUs antiguas

Algunas tarjetas AMD antiguas como la Radeon HD 7870 XT (Tahiti LE, GCN 1.0) no tienen soporte en ROCm. En el Mac Pro Trashcan probado, Proxmox reconoce ambas GPUs, pero para Ollama o PyTorch el GPU-Passthrough no proporciona aceleración. Los modelos se ejecutan entonces en la CPU. Para modelos locales con aceleración GPU, necesitas AMD-GPUs más recientes con soporte ROCm o tarjetas NVIDIA.

Términos importantes

Gateway: Proceso central de OpenClaw.
Channel Plugin: Conexión a un servicio de mensajería.
Model Provider: Fuente del modelo de lenguaje.
Sandbox: Entorno de ejecución aislado para herramientas.
Skill: Capacidad preconfigurada.
Workspace: Directorio de trabajo del gateway.
Control UI: Interfaz web para configuración.
TUI: Interfaz de terminal.

Casos de uso

Asistente personal

OpenClaw se ejecuta en Proxmox, es accesible a través de Telegram o Discord y ejecuta automatizaciones simples.

Agente de equipo

Múltiples miembros del equipo acceden a un gateway compartido. Los permisos y canales se gestionan centralmente.

Asistente de desarrollo

OpenClaw se conecta al repositorio de código local, puede ejecutar comandos de compilación y enviar mensajes de estado a través de Slack o Discord.

Problemas comunes

Versión incorrecta de Node.js: OpenClaw requiere Node.js 22.22.3 o superior.
Firewall bloquea Tailscale: El puerto UDP 41641 debe estar permitido.
Sin aislamiento: Ejecutar OpenClaw en la máquina principal es arriesgado.
Permisos faltantes en LXC: Los contenedores sin privilegios a veces necesitan derechos adicionales para red o dispositivos.
Modelos no accesibles: URL de Ollama o API-Key incorrectos.
Tokens en respaldos: Guardar claves secretas sin cifrar.
Snapshots olvidados: No crear snapshot antes de actualizaciones.

Enlaces e información adicional

FAQ: OpenClaw en Proxmox

¿Necesito una GPU? No, si solo usas APIs alojadas. Para modelos locales más grandes se recomienda una GPU.

¿Puedo ejecutar OpenClaw en Docker en Proxmox? Sí, Docker funciona tanto en LXC como en VM. En LXC a veces es necesario configurar derechos adicionales.

¿Es un LXC lo suficientemente seguro? Para homelab y uso personal, generalmente sí. Para requisitos de seguridad más altos o GPU-Passthrough, es mejor una VM.

¿Qué canales funcionan con OpenClaw? Discord, Telegram, Slack, WhatsApp, Matrix, Signal, iMessage, Google Chat, Microsoft Teams y WebChat.

¿Puedo combinar OpenClaw con Ollama? Sí, Ollama puede ejecutarse en el mismo guest o en un contenedor separado.

¿Cómo accedo desde fuera? Lo mejor es a través de Tailscale, SSH-Tunnel o VPN.

Fuentes y lecturas adicionales

OpenClaw Docs: https://docs.openclaw.ai/
OpenClaw GitHub: https://github.com/openclaw/openclaw
Proxmox VE Dokumentation: https://pve.proxmox.com/wiki/Main_Page
Tailscale: https://tailscale.com/

Resumen: OpenClaw en Proxmox VE

OpenClaw es un gateway versátil para agentes de IA autohospedados. En Proxmox VE se puede ejecutar de forma aislada en una VM o en un LXC. Este artículo muestra, basándose en una instalación real en Proxmox VE 7.0.2 dentro de un LXC con 31 GB de RAM, cómo instalar Node.js, configurar OpenClaw y ejecutar el asistente de configuración. También se aborda el ejemplo de hardware Mac Pro Trashcan con dos AMD Radeon HD 7870 XT: estas tarjetas no tienen soporte en ROCm, por lo que los modelos locales se ejecutan en la CPU. Son importantes tener recursos suficientes, la versión correcta de Node.js, protección de red mediante firewall y Tailscale, sandbox para herramientas y copias de seguridad regulares. Si combinas OpenClaw con Ollama, obtienes un asistente local y extensible para mensajería, automatización y desarrollo.

Täglicher Artikel