Communitygithub.com

AGLz/agl-hostman

Verwaltung von QEMU/KVM AGL-VMs auf einem Proxmox-Host.

Was ist agl-hostman?

Diese Fähigkeit (Skill) ermöglicht die vollständige Verwaltung von AGL-VMs (Automotive Grade Linux), die als QEMU/KVM-Gäste auf einem Proxmox-Host betrieben werden. Sie bietet eine Sammlung von `qm`-Befehlen, die per SSH auf dem Host ausgeführt werden, um virtuelle Maschinen zu starten, zu stoppen, zu snapshotten, zu klonen und deren Ressourcen (CPU, RAM, Netzwerk) zu konfigurieren. Besonderer Fokus liegt auf der VM 104 (AGLWK45), die den OpenClaw-Gateway-Dienst hostet. Die Fähigkeit listet außerdem die Nutzung des QEMU-Gast-Agents auf, um Befehle innerhalb der VM auszuführen, Dateisysteme einzufrieren und den Status abzufragen. Sie ist speziell für Entwickler und Administratoren konzipiert, die eine zuverlässige Remote-Verwaltung ihrer AGL-Test- und Produktionsumgebungen benötigen, und unterstützt Fehlerbehebung bei Startproblemen, Netzwerkausfällen und nicht reagierenden Gast-Agents.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

QEMU/KVM AGL VMs

AGL-QEMU-VMs

VMIDHostNameRolleTailscale-IP
104AGLSRV1aglwk45OpenClaw-Worker (Windows)Via 192.168.0.245

Zugriff

# AGLSRV1 (Proxmox-Host mit QEMU/KVM)
ssh AGLSRV1  # 192.168.0.245 (LAN) oder 100.107.113.33 (Tailscale)

QEMU-VM-Operationen (über qm)

Alle VMs auflisten

ssh AGLSRV1 "qm list"

VM starten/stoppen

# Start
ssh AGLSRV1 "qm start 104"

# Stopp (ACPI herunterfahren)
ssh AGLSRV1 "qm shutdown 104"

# Erzwungener Stopp
ssh AGLSRV1 "qm stop 104"

# Neustart
ssh AGLSRV1 "qm reboot 104"

VM-Status

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

Konsolenzugriff

# VNC-Konsole (VNC-Port abrufen)
ssh AGLSRV1 "qm vncproxy 104"

# Serielle Konsole (falls konfiguriert)
ssh AGLSRV1 "qm terminal 104"

Snapshots

# Snapshot erstellen
ssh AGLSRV1 "qm snapshot 104 pre-update"

# Snapshots auflisten
ssh AGLSRV1 "qm listsnapshot 104"

# Wiederherstellen (VM muss gestoppt sein)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"

# Snapshot löschen
ssh AGLSRV1 "qm delsnapshot 104 pre-update"

VM klonen

# Vollständiger Klon
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name> --full"

# Verknüpfter Klon (schneller, abhängig von Quelle)
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name>"

Ressourcenkonfiguration

# Speicher setzen
ssh AGLSRV1 "qm set 104 --memory 8192"

# CPU-Kerne setzen
ssh AGLSRV1 "qm set 104 --cores 4"

# Netzwerkbrücke setzen
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"

QEMU-Gast-Agent

Installation (innerhalb der VM)

# Windows
# qemu-ga von VirtIO-Treiber-ISO installieren

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

In Proxmox aktivieren

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

Gast-Agent verwenden

# VM-Info über Gast-Agent abrufen
ssh AGLSRV1 "qm guest exec 104 -- ip a"

# Netzwerkschnittstellen abrufen
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq

# Befehl innerhalb der VM ausführen
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"

# Dateisystem einfrieren (für Snapshots)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"

Datenträgerverwaltung

Datenträger auflisten

ssh AGLSRV1 "qm config 104 | grep virtio"

Datenträger vergrößern

ssh AGLSRV1 "qm resize 104 virtio0 +10G"

Datenträger verschieben

# In anderen Speicher verschieben
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"

AGLWK45 (VM104) Spezifisch

OpenClaw auf AGLWK45

# OpenClaw-Status über Gast-Exec prüfen
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"

# Oder über Tailscale von innerhalb der VM
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"

Verifizierungsskript

# Das Verifizierungsskript aus dem Repository ausführen
./scripts/verify-aglwk45-fgsrv06.sh

Direkte QEMU-Nutzung (ohne Proxmox)

Für eigenständige QEMU-Nutzung:

# QEMU-VM starten
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

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

# Mit Tailscale (innerhalb der VM)
# Tailscale in VM für Fernzugriff installieren

Fehlerbehebung

VM startet nicht

# Prüfen, ob gesperrt
ssh AGLSRV1 "qm status 104"

# Speicherplatz prüfen
ssh AGLSRV1 "pvesm status"

# Logs prüfen
ssh AGLSRV1 "qm start 104 2>&1"

Gast-Agent antwortet nicht

# Prüfen, ob aktiviert
ssh AGLSRV1 "qm config 104 | grep agent"

# In der VM prüfen
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"

Netzwerkprobleme

# Brücke prüfen
ssh AGLSRV1 "brctl show"

# VM-Netzwerkkonfiguration prüfen
ssh AGLSRV1 "qm guest exec 104 -- ip a"

Hinweise

  • AGLWK45 (VM104) betreibt das OpenClaw-Gateway – Neustart während aktiver Sitzungen vermeiden
  • QEMU-VMs verwenden qm-Befehle in Proxmox (im Gegensatz zu pct für LXC-Container)
  • Der Gast-Agent ermöglicht Dateikopie, Befehlsausführung und Dateisystemeinfrieren vom Proxmox-Host aus
  • Vor größeren Änderungen immer einen Snapshot erstellen

Verwandte Skills