Communitygithub.com

AGLz/agl-hostman

Máquinas virtuales QEMU/KVM para Automotive Grade Linux (AGL).

¿Qué es agl-hostman?

Este skill proporciona un conjunto completo de comandos y documentación para gestionar máquinas virtuales QEMU/KVM en un entorno Proxmox, específicamente para la plataforma Automotive Grade Linux (AGL). Está diseñado para administradores de sistemas y desarrolladores que trabajan con VMs de AGL, como `aglwk45`, que ejecuta el gateway OpenClaw en Windows. El skill detalla operaciones básicas (iniciar, detener, reiniciar), gestión de snapshots, clones, configuración de recursos, y uso avanzado del QEMU Guest Agent para ejecutar comandos dentro de la VM desde el host sin SSH. También incluye secciones para la gestión de discos, verificación de servicios como OpenClaw, y troubleshooting de problemas comunes. Todo el control se realiza mediante el comando `qm` sobre SSH al host Proxmox `AGLSRV1`, ya sea por LAN o Tailscale. El skill es útil para automatizar tareas de mantenimiento, despliegue y monitoreo de VMs AGL de manera remota y segura.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Máquinas Virtuales QEMU/KVM AGL

VMs QEMU AGL

VMIDHostNombreRolIP Tailscale
104AGLSRV1aglwk45Trabajador 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 qm en Proxmox (a diferencia de pct para 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

Skills relacionados