---

name: api-monitor description: > API 配额监控与手动切换技能。监控 OpenClaw 模型 API 使用量，配额不足时询问用户确认后再切换。 触发词：API配额、API监控、模型切换、检查API。

⚠️ 前置要求（使用前必读）

必需环境

1. Python 3.8+ - 脚本运行环境
2. OpenClaw 已配置 - Gateway 正常运行
3. jq 工具 - JSON 解析（大多数系统已预装）

权限要求

• 需要修改 OpenClaw 配置文件的权限
• 可能需要重启 Gateway（需要相应权限）

路径配置

• 默认路径：~/.openclaw/skills/api-monitor/
• 配置文件可移动到其他位置
• 脚本支持绝对路径和相对路径

风险提示

• 切换模型会重启 Gateway，短期内服务中断
• 自动重启 Gateway 需要足够权限
• 建议在非高峰期操作

---

API 使用量监控技能（询问确认模式）

概述

监控 OpenClaw 模型 API 使用量，配额不足时询问用户确认后再切换，确保用户知情。

功能

• ✅ 实时监控当前模型 API 状态
• ✅ 检测配额不足/错误
• ✅ 询问用户确认后再切换模型
• ✅ 支持多个模型优先级配置
• ✅ 手动指定切换到某个模型

使用方法

准备工作

# 确认Python环境
python3 --version

# 确认脚本存在（路径根据实际安装位置调整）
ls -la ~/.openclaw/skills/api-monitor/api_monitor.py

查看当前状态

# 替换为实际脚本路径
SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --check

询问是否切换（生成询问消息）

SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --ask

确认切换（用户确认后执行）

SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --confirm

指定切换到某个模型

# 替换为目标模型
TARGET_MODEL="mydamoxing/MiniMax-M2.5"
SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --model "$TARGET_MODEL"

列出所有可用模型

SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --list-models

可用模型列表

1. mydamoxing/MiniMax-M2.5-highspeed - MiniMax高速版
2. mydamoxing/MiniMax-M2.5 - MiniMax普通版
3. volcengine/ark-code-latest - 火山引擎
4. hajimi/claude-sonnet-4-20250511 - 免费模型

工作流程

1. 定时检查 → 运行 --check 查看状态
2. 发现问题 → 运行 --ask 生成询问消息
3. 用户确认 → 运行 --confirm 执行切换
4. 或者 → 用户指定 --model xxx 直接切换

示例对话

用户: 检查一下API状态
助手: (运行 --check)
当前模型: mydamoxing/MiniMax-M2.5-highspeed
状态: API配额可能不足，建议切换模型
错误次数: 3

用户: 那就切换吧
助手: (运行 --confirm)
确认切换: mydamoxing/MiniMax-M2.5-highspeed → mydamoxing/MiniMax-M2.5
切换成功!

定时任务配置（可选）

如需定时自动检查，可配置 cron：

# 编辑 crontab
crontab -e

# 添加定时任务（每30分钟检查一次）
# 替换为实际路径
*/30 * * * * cd $HOME/.openclaw/skills/api-monitor && python3 api_monitor.py --check >> /var/log/api-monitor.log 2>&1

注意事项

• 切换模型会中断当前会话
• 建议在非高峰期操作
• 始终需要用户确认才切换
• 定期检查日志 /var/log/api-monitor.log 了解运行状态