Communitygithub.com

AGLz/agl-hostman

Gerenciamento de máquinas virtuais QEMU/KVM para AGL (Automotive Grade Linux).

O que é agl-hostman?

Este skill fornece um guia completo para gerenciar máquinas virtuais QEMU/KVM especificamente para o ambiente AGL (Automotive Grade Linux), com foco no host Proxmox AGLSRV1. Ele documenta operações essenciais como listar, iniciar, parar e reiniciar VMs usando comandos `qm`, além de gerenciamento de snapshots, clonagem e configuração de recursos (memória, CPU, rede). Também cobre a instalação e uso do QEMU Guest Agent para execução de comandos internos, congelamento de sistema de arquivos e coleta de informações da VM. O skill inclui procedimentos específicos para a VM AGLWK45 (VM104), que executa o gateway OpenClaw em um ambiente Windows, com scripts de verificação e integração com Tailscale. Além do Proxmox, oferece exemplos de uso direto do QEMU para casos fora do Proxmox, e uma seção de solução de problemas para lidar com falhas de inicialização, problemas de rede e falhas do guest agent. É útil para desenvolvedores e administradores que precisam gerenciar VMs AGL de forma eficiente, garantindo operações seguras com recomendações de snapshots antes de alterações importantes.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Máquinas Virtuais QEMU/KVM AGL

VMs AGL QEMU

VMIDHostNomeFunçãoIP Tailscale
104AGLSRV1aglwk45Worker OpenClaw (Windows)Via 192.168.0.245

Acesso

# AGLSRV1 (host Proxmox com QEMU/KVM)
ssh AGLSRV1  # 192.168.0.245 (LAN) ou 100.107.113.33 (Tailscale)

Operações de VM QEMU (via qm)

Listar todas as VMs

ssh AGLSRV1 "qm list"

Iniciar/Parar VM

# Iniciar
ssh AGLSRV1 "qm start 104"

# Parar (desligamento ACPI)
ssh AGLSRV1 "qm shutdown 104"

# Parar forçadamente
ssh AGLSRV1 "qm stop 104"

# Reiniciar
ssh AGLSRV1 "qm reboot 104"

Status da VM

ssh AGLSRV1 "qm status 104"
ssh AGLSRV1 "qm list | grep 104"

Acesso ao Console

# Console VNC (obter porta VNC)
ssh AGLSRV1 "qm vncproxy 104"

# Console serial (se configurado)
ssh AGLSRV1 "qm terminal 104"

Snapshots

# Criar snapshot
ssh AGLSRV1 "qm snapshot 104 pre-update"

# Listar snapshots
ssh AGLSRV1 "qm listsnapshot 104"

# Reverter (VM deve estar parada)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"

# Excluir snapshot
ssh AGLSRV1 "qm delsnapshot 104 pre-update"

Clonar VM

# Clone completo
ssh AGLSRV1 "qm clone 104 <novo-vmid> --name <novo-nome> --full"

# Clone vinculado (mais rápido, depende da origem)
ssh AGLSRV1 "qm clone 104 <novo-vmid> --name <novo-nome>"

Configuração de Recursos

# Definir memória
ssh AGLSRV1 "qm set 104 --memory 8192"

# Definir núcleos de CPU
ssh AGLSRV1 "qm set 104 --cores 4"

# Definir bridge de rede
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"

QEMU Guest Agent

Instalar (dentro da VM)

# Windows
# Instalar qemu-ga a partir da ISO de drivers VirtIO

# Linux
apt install qemu-guest-agent  # Debian/Ubuntu
systemctl enable qemu-guest-agent
systemctl start qemu-guest-agent

Habilitar no Proxmox

ssh AGLSRV1 "qm set 104 --agent enabled=1"

Usar guest agent

# Obter informações da VM via guest agent
ssh AGLSRV1 "qm guest exec 104 -- ip a"

# Obter interfaces de rede
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq

# Executar comando dentro da VM
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"

# Congelar sistema de arquivos (para snapshots)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"

Gerenciamento de Discos

Listar discos

ssh AGLSRV1 "qm config 104 | grep virtio"

Redimensionar disco

ssh AGLSRV1 "qm resize 104 virtio0 +10G"

Mover disco

# Mover para armazenamento diferente
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"

Específico do AGLWK45 (VM104)

OpenClaw no AGLWK45

# Verificar status do OpenClaw via guest exec
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"

# Ou via Tailscale de dentro da VM
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"

Script de Verificação

# Executar o script de verificação do repositório
./scripts/verify-aglwk45-fgsrv06.sh

QEMU Direto (não-Proxmox)

Para uso standalone do 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

# Com VNC
qemu-system-x86_64 -enable-kvm -m 4096 -vnc :0 disk.qcow2

# Com Tailscale (dentro da VM)
# Instalar tailscale na VM para acesso remoto

Solução de Problemas

VM não inicia

# Verificar se está bloqueada
ssh AGLSRV1 "qm status 104"

# Verificar espaço em armazenamento
ssh AGLSRV1 "pvesm status"

# Verificar logs
ssh AGLSRV1 "qm start 104 2>&1"

Guest agent não responde

# Verificar se está habilitado
ssh AGLSRV1 "qm config 104 | grep agent"

# Verificar dentro da VM
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"

Problemas de rede

# Verificar bridge
ssh AGLSRV1 "brctl show"

# Verificar configuração de rede da VM
ssh AGLSRV1 "qm guest exec 104 -- ip a"

Notas

  • AGLWK45 (VM104) executa o gateway OpenClaw — evite reiniciar durante sessões ativas
  • VMs QEMU usam comandos qm no Proxmox (diferente de pct para contêineres LXC)
  • O guest agent permite cópia de arquivos, execução de comandos e congelamento de sistema de arquivos a partir do host Proxmox
  • Sempre faça snapshot antes de alterações importantes

Habilidades Relacionadas