Proxmox 完整技能集

全面的 Proxmox VE 管理能力，整合以下功能：

• 电源控制：启动、停止、重启、关机虚拟机（VM）/容器（LXC）
• 快照管理：创建、列出、删除、回滚快照（支持可选的内存状态保存）
• 备份管理：列出与创建备份
• 存储管理：查看存储池及其内容
• 任务追踪：监控异步操作及日志
• 集群概览：节点状态、资源使用情况、健康状况

配置方式

选项 1：OpenClaw 凭据（推荐）

创建文件 ~/.openclaw/credentials/proxmox.json：

{
  "host": "your-proxmox-ip",
  "token_id": "clawd@pve!tokenname",
  "token_secret": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
  "verify_ssl": false
}

选项 2：环境变量

export PVE_HOST="your-proxmox-ip"
export PVE_TOKEN_ID="clawd@pve!tokenname"
export PVE_TOKEN_SECRET="xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
export PVE_VERIFY_SSL="false"

选项 3：凭据文件

cat > ~/.proxmox-credentials << 'EOF'
PROXMOX_HOST=https://your-proxmox-ip:8006
PROXMOX_TOKEN_ID=clawd@pve!tokenname
PROXMOX_TOKEN_SECRET=your-token-secret
EOF
chmod 600 ~/.proxmox-credentials

创建 API Token

1. 登录 Proxmox Web UI
2. 数据中心 → 权限 → API Tokens → 添加
3. 选择用户，输入 Token ID；如需，可取消勾选“Privilege Separation”
4. 复制 Secret（仅显示一次！）

工具命令

集群与节点

# 集群概览
python3 scripts/proxmox.py nodes

# 节点健康状态（CPU、内存、运行时间）
python3 scripts/proxmox.py node_health pve

# Bash 替代方案
bash scripts/pve.sh status

资源列表

# 全局所有 VM（集群范围）
python3 scripts/proxmox.py vms

# 指定节点上的所有 VM
bash scripts/pve.sh vms pve

# 指定节点上的 LXC 容器
bash scripts/pve.sh lxc pve

# 集群全部资源（含各类类型）
bash scripts/pve.sh resources

VM / 容器状态

# Python 方式（详细信息）
python3 scripts/proxmox.py status pve qemu 115

# Bash 方式（快速查询）
bash scripts/pve.sh info pve 115

电源控制（需用户批准）

# 启动 VM
python3 scripts/proxmox.py start pve qemu 115

# 停止 VM（强制停止）
python3 scripts/proxmox.py stop pve qemu 115

# 关机 VM（优雅关机）
python3 scripts/proxmox.py shutdown pve qemu 115

# 重启 VM
python3 scripts/proxmox.py reboot pve qemu 115

# Bash 替代方案
bash scripts/pve.sh start 115 pve
bash scripts/pve.sh stop 115 pve
bash scripts/pve.sh shutdown 115 pve

快照管理

# 列出快照
python3 scripts/proxmox.py list_snapshots pve qemu 115

# 创建快照（vmstate=0：不包含内存；vmstate=1：包含内存）
python3 scripts/proxmox.py snapshot pve qemu 115 pre-update 0

# 删除快照（需用户批准）
python3 scripts/proxmox.py delete_snapshot pve qemu 115 pre-update

# 回滚至快照（Bash 方式）
bash scripts/pve.sh rollback pve 115 pre-update

备份管理

# 列出备份
bash scripts/pve.sh backups pve local

# 执行备份
bash scripts/pve.sh backup pve 115 local

存储管理

# 列出存储池
bash scripts/pve.sh storage pve

# 查看存储内容
bash scripts/pve.sh content pve local

任务与日志

# 最近任务
bash scripts/pve.sh tasks pve

# 查看指定任务日志
bash scripts/pve.sh log pve UPID:pve:00001234:...

需人工批准的操作

以下操作需用户显式批准：

• 电源控制：start、stop、shutdown、reboot
• 快照操作：snapshot、delete_snapshot
• 备份操作：backup
• 回滚操作：rollback

只读操作（无需批准）：

• nodes、vms、status、list_snapshots
• backups（仅限列出）、storage、tasks、log

响应格式

所有命令均返回 JSON 格式，便于程序解析：

{
  "ok": true,
  "data": { ... }
}

错误响应示例：

{
  "ok": false,
  "error": "Missing env var: PVE_HOST"
}

注意事项

• 将 pve 替换为实际的节点名称
• 将 115 替换为实际的 VMID
• qemu 表示虚拟机，lxc 表示容器
• API Token 不需要 CSRF Token
• 若使用自签名证书，请设置 verify_ssl: false 或在 CLI 中添加 -k 参数

致谢

本项目整合自以下开源实现：

• robnew/proxmox-skill —— 基于 Python 的工具化方案，内置操作审批机制
• weird-aftertaste/proxmox —— 功能完备的 Bash 辅助脚本，覆盖广泛的 Proxmox API

许可证

MIT