Communitygithub.com

AGLz/agl-hostman

QEMU/KVM AGL 虚拟机管理技能

agl-hostman 是什么?

该技能用于管理和操作基于 Proxmox 的 QEMU/KVM 虚拟机,特别针对 AGL 环境中的 OpenClaw 工作节点(如 AGLWK45,VMID 104)。它提供了完整的 VM 生命周期操作,包括启动、停止、快照、克隆、资源调整以及磁盘管理。通过集成 QEMU Guest Agent,用户可以在 Proxmox 宿主机上直接执行 VM 内部命令、查看网络状态或冻结文件系统,这在自动化运维和快速响应场景下尤为有用。该技能支持本地 LAN 和 Tailscale 远程访问,并包含详尽的故障排除指南。所有操作均通过 `qm` 命令实现,兼容 Proxmox VE 平台。

兼容平台~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

QEMU/KVM AGL 虚拟机

AGL QEMU 虚拟机

VMID宿主机名称角色Tailscale IP
104AGLSRV1aglwk45OpenClaw 工作节点(Windows)通过 192.168.0.245

访问

# AGLSRV1 (运行 QEMU/KVM 的 Proxmox 宿主机)
ssh AGLSRV1  # 192.168.0.245 (局域网) 或 100.107.113.33 (Tailscale)

QEMU 虚拟机操作(通过 qm)

列出所有虚拟机

ssh AGLSRV1 "qm list"

启动/停止虚拟机

# 启动
ssh AGLSRV1 "qm start 104"

# 停止(ACPI 关机)
ssh AGLSRV1 "qm shutdown 104"

# 强制停止
ssh AGLSRV1 "qm stop 104"

# 重启
ssh AGLSRV1 "qm reboot 104"

虚拟机状态

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

控制台访问

# VNC 控制台(获取 VNC 端口)
ssh AGLSRV1 "qm vncproxy 104"

# 串行控制台(如果已配置)
ssh AGLSRV1 "qm terminal 104"

快照

# 创建快照
ssh AGLSRV1 "qm snapshot 104 pre-update"

# 列出快照
ssh AGLSRV1 "qm listsnapshot 104"

# 回滚(虚拟机必须已停止)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"

# 删除快照
ssh AGLSRV1 "qm delsnapshot 104 pre-update"

克隆虚拟机

# 完整克隆
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name> --full"

# 链接克隆(更快,依赖源)
ssh AGLSRV1 "qm clone 104 <new-vmid> --name <new-name>"

资源配置

# 设置内存
ssh AGLSRV1 "qm set 104 --memory 8192"

# 设置 CPU 核心数
ssh AGLSRV1 "qm set 104 --cores 4"

# 设置网络桥接
ssh AGLSRV1 "qm set 104 --net0 virtio,bridge=vmbr0"

QEMU Guest Agent

安装(在虚拟机内部)

# Windows
# 从 VirtIO 驱动 ISO 安装 qemu-ga

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

在 Proxmox 中启用

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

使用 Guest Agent

# 通过 guest agent 获取虚拟机信息
ssh AGLSRV1 "qm guest exec 104 -- ip a"

# 获取网络接口
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq

# 在虚拟机内部执行命令
ssh AGLSRV1 "qm guest exec 104 -- systemctl status openclaw-gateway"

# 冻结文件系统(用于快照)
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-freeze"
ssh AGLSRV1 "qm guest cmd 104 fsfreeze-thaw"

磁盘管理

列出磁盘

ssh AGLSRV1 "qm config 104 | grep virtio"

调整磁盘大小

ssh AGLSRV1 "qm resize 104 virtio0 +10G"

移动磁盘

# 移动到不同存储
ssh AGLSRV1 "qm move-disk 104 virtio0 local-lvm"

AGLWK45(VM104)专有操作

AGLWK45 上的 OpenClaw

# 通过 guest exec 验证 OpenClaw 状态
ssh AGLSRV1 "qm guest exec 104 -- powershell -Command 'Get-Service openclaw'"

# 或通过虚拟机内部的 Tailscale
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"

验证脚本

# 从仓库运行验证脚本
./scripts/verify-aglwk45-fgsrv06.sh

独立 QEMU(非 Proxmox)

用于独立 QEMU 的使用:

# 启动 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

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

# 带 Tailscale(在虚拟机内部)
# 在虚拟机中安装 tailscale 以实现远程访问

故障排除

虚拟机无法启动

# 检查是否被锁定
ssh AGLSRV1 "qm status 104"

# 检查存储空间
ssh AGLSRV1 "pvesm status"

# 检查日志
ssh AGLSRV1 "qm start 104 2>&1"

Guest Agent 无响应

# 检查是否已启用
ssh AGLSRV1 "qm config 104 | grep agent"

# 在虚拟机内部检查
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"

网络问题

# 检查桥接
ssh AGLSRV1 "brctl show"

# 检查虚拟机网络配置
ssh AGLSRV1 "qm guest exec 104 -- ip a"

备注

  • AGLWK45(VM104)运行 OpenClaw 网关 — 避免在活跃会话期间重启
  • QEMU 虚拟机在 Proxmox 中使用 qm 命令(LXC 容器使用 pct)
  • Guest Agent 支持从 Proxmox 宿主机复制文件、执行命令和冻结文件系统
  • 在进行重大更改前务必创建快照

相关技能