Communitygithub.com

QEMU/KVM AGL 仮想マシン (agl-hostman)

Proxmox ホスト上で動作する QEMU/KVM AGL 仮想マシンを管理するためのスキルです。

KVM AGL 仮想マシン (agl-hostman) とは?

このスキルは、Proxmox ホスト (AGLSRV1) 上で動作する QEMU/KVM AGL 仮想マシンを管理するための包括的なガイドを提供します。主に AGLWK45 (VM104) を対象とし、OpenClaw ワーカーを実行する Windows VM を管理します。スキルでは、qm コマンドを使用した VM の起動/停止、スナップショットの作成/ロールバック、クローン作成、リソース設定などの基本操作から、QEMU ゲストエージェントのインストール、有効化、VM 内でのコマンド実行やファイルシステムのフリーズまでをカバーします。また、ディスクの管理、トラブルシューティング手順、Tailscale を介したネットワークアクセス、ノンプロクスモックスなスタンドアロン QEMU 使用方法も含まれます。このスキルは Proxmox 環境に依存しており、qm コマンドラインインターフェースを介して VM 操作を自動化・効率化するために設計されています。

対応~Claude Code~Codex CLI~Cursor
npx skills add AGLz/agl-hostman

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

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 (LAN) または 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"

# リンククローン (高速、元の VM に依存)
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 ゲストエージェント

インストール (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"

ゲストエージェントの使用

# ゲストエージェント経由で 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"

ゲストエージェントが応答しない

# 有効化されているか確認
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 とは異なります)。
  • ゲストエージェントを使用すると、Proxmox ホストからファイルコピー、コマンド実行、fsfreeze が可能になります。
  • 大きな変更を行う前には必ずスナップショットを作成してください。

関連スキル