Máquinas Virtuales QEMU/KVM AGL
VMs QEMU AGL
| VMID | Host | Nombre | Rol | IP Tailscale |
|---|---|---|---|---|
| 104 | AGLSRV1 | aglwk45 | Trabajador OpenClaw (Windows) | Via 192.168.0.245 |
Acceso
# AGLSRV1 (Host Proxmox con QEMU/KVM)
ssh AGLSRV1 # 192.168.0.245 (LAN) o 100.107.113.33 (Tailscale)
Operaciones con VMs QEMU (mediante qm)
Listar todas las VMs
ssh AGLSRV1 "qm list"
Iniciar/Detener VM
# Iniciar
ssh AGLSRV1 "qm start 104"
# Detener (apagado ACPI)
ssh AGLSRV1 "qm shutdown 104"
# Forzar detención
ssh AGLSRV1 "qm stop 104"
# Reiniciar
ssh AGLSRV1 "qm reboot 104"
Estado de la VM
ssh AGLSRV1 "qm status 104"
ssh AGLSRV1 "qm list | grep 104"
Acceso a Consola
# Consola VNC (obtener puerto VNC)
ssh AGLSRV1 "qm vncproxy 104"
# Consola serie (si está configurada)
ssh AGLSRV1 "qm terminal 104"
Instantáneas
# Crear instantánea
ssh AGLSRV1 "qm snapshot 104 pre-update"
# Listar instantáneas
ssh AGLSRV1 "qm listsnapshot 104"
# Revertir (la VM debe estar detenida)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"
# Eliminar instantánea
ssh AGLSRV1 "qm delsnapshot 104 pre-update"
Clonar VM
# Clonación completa
ssh AGLSRV1 "qm clone 104 <nuevo-vmid> --name <nuevo-nombre> --full"
# Clonación vinculada (más rápida, depende del origen)
ssh AGLSRV1 "qm clone 104 <nuevo-vmid> --name <nuevo-nombre>"
Configuración de Recursos
# Establecer memoria
ssh AGLSRV1 "qm set 104 --memory 8192"
# Establecer núcleos de CPU
ssh AGLSRV1 "qm set 104 --cores 4"
# Establecer bridge de red
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"
Agente Invitado QEMU
Instalar (dentro de la VM)
# Windows
# Instalar qemu-ga desde el ISO de controladores VirtIO
# Linux
apt install qemu-guest-agent # Debian/Ubuntu
systemctl enable qemu-guest-agent
systemctl start qemu-guest-agent
Habilitar en Proxmox
ssh AGLSRV1 "qm set 104 --agent enabled=1"
Usar el agente invitado
# Obtener información de la VM mediante el agente invitado
ssh AGLSRV1 "qm guest exec 104 -- ip a"
# Obtener interfaces de red
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq
# Ejecutar comando dentro de la VM
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"
# Congelar sistema de archivos (para instantáneas)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"
Gestión de Discos
Listar discos
ssh AGLSRV1 "qm config 104 | grep virtio"
Redimensionar disco
ssh AGLSRV1 "qm resize 104 virtio0 +10G"
Mover disco
# Mover a almacenamiento diferente
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"
Específico de AGLWK45 (VM104)
OpenClaw en AGLWK45
# Verificar estado de OpenClaw mediante guest exec
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"
# O mediante Tailscale desde dentro de la VM
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"
Script de Verificación
# Ejecutar el script de verificación desde el repositorio
./scripts/verify-aglwk45-fgsrv06.sh
QEMU Directo (sin Proxmox)
Para uso independiente de QEMU:
# Iniciar VM QEMU
qemu-system-x86_64 \
-enable-kvm \
-m 4096 \
-smp 4 \
-drive file=disk.qcow2,format=qcow2 \
-netdev user,id=net0 -device virtio-net-pci,netdev=net0 \
-serial mon:stdio \
-nographic
# Con VNC
qemu-system-x86_64 -enable-kvm -m 4096 -vnc :0 disk.qcow2
# Con Tailscale (dentro de la VM)
# Instalar tailscale en la VM para acceso remoto
Solución de Problemas
La VM no arranca
# Verificar si está bloqueada
ssh AGLSRV1 "qm status 104"
# Verificar espacio en almacenamiento
ssh AGLSRV1 "pvesm status"
# Verificar registros
ssh AGLSRV1 "qm start 104 2>&1"
El agente invitado no responde
# Verificar si está habilitado
ssh AGLSRV1 "qm config 104 | grep agent"
# Verificar dentro de la VM
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"
Problemas de red
# Verificar bridge
ssh AGLSRV1 "brctl show"
# Verificar configuración de red de la VM
ssh AGLSRV1 "qm guest exec 104 -- ip a"
Notas
- AGLWK45 (VM104) ejecuta el gateway OpenClaw — evitar reiniciar durante sesiones activas
- Las VMs QEMU usan comandos
qmen Proxmox (a diferencia depctpara contenedores LXC) - El agente invitado permite copia de archivos, ejecución de comandos y fsfreeze desde el host Proxmox
- Siempre crear una instantánea antes de cambios importantes