Communitygithub.com

AGLz/agl-hostman

描述:qemu-agl

agl-hostman 是什麼?

這個 AI 助手技能專注於管理基於 QEMU/KVM 的 AGL 虛擬機器,特別是在 Proxmox VE 主機上運作的環境。它提供了一套完整的命令,用於管理以 AGLWK45(VMID 104)為代表的 Windows 工作節點,該節點執行 OpenClaw 閘道器。技能涵蓋了 VM 生命週期操作(啟動、停止、快照、複製)、資源配置(記憶體、CPU、網路)、透過 QEMU Guest Agent 進行內部命令執行、磁碟管理以及疑難排解。支援的平台包括 Proxmox VE(使用 `qm` 命令)和獨立 QEMU 環境。此技能對需要在 Tailscale 網路中,對 AGL 基礎設施進行日常維護與故障排除的開發者與系統管理員非常實用。

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

在你喜歡的 AI 中提問

開啟一個已預先載入此 Agent Skill 的新對話。

說明文件

QEMU/KVM AGL 虛擬機器

AGL QEMU VM

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 VM 操作 (透過 qm)

列出所有 VM

ssh AGLSRV1 "qm list"

啟動/停止 VM

# 啟動
ssh AGLSRV1 "qm start 104"

# 停止 (ACPI 關機)
ssh AGLSRV1 "qm shutdown 104"

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

# 重新啟動
ssh AGLSRV1 "qm reboot 104"

VM 狀態

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"

# 回滾 (VM 必須先停止)
ssh AGLSRV1 "qm stop 104 && qm rollback 104 pre-update && qm start 104"

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

複製 VM

# 完整複製
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

安裝 (在 VM 內部)

# 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 取得 VM 資訊
ssh AGLSRV1 "qm guest exec 104 -- ip a"

# 取得網路介面
ssh AGLSRV1 "qm guest exec 104 -- ip -j addr show" | jq

# 在 VM 內部執行命令
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'"

# 或從 VM 內部透過 Tailscale
ssh AGLSRV1 "qm guest exec 104 -- tailscale status"

驗證腳本

# 從儲存庫執行驗證腳本
./scripts/verify-aglwk45-fgsrv06.sh

直接使用 QEMU (非 Proxmox)

用於獨立 QEMU 的用法:

# 啟動 QEMU VM
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 (在 VM 內部)
# 在 VM 中安裝 tailscale 以進行遠端存取

疑難排解

VM 無法啟動

# 檢查是否被鎖定
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"

# 檢查 VM 內部
ssh AGLSRV1 "qm guest exec 104 -- systemctl status qemu-guest-agent"

網路問題

# 檢查橋接
ssh AGLSRV1 "brctl show"

# 檢查 VM 網路設定
ssh AGLSRV1 "qm guest exec 104 -- ip a"

備註

  • AGLWK45 (VM104) 執行 OpenClaw 閘道器 — 避免在活躍工作階段期間重新啟動
  • QEMU VM 在 Proxmox 中使用 qm 命令 (與 LXC 容器的 pct 相對)
  • Guest Agent 可從 Proxmox 主機啟用檔案複製、命令執行和 fsfreeze
  • 在進行重大變更前務必建立快照

相關技能