Api Monitor

---
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 状态
- ✅ 检测配额不足/错误
- ✅ 询问用户确认后再切换模型
- ✅ 支持多个模型优先级配置
- ✅ 手动指定切换到某个模型

## 使用方法

### 准备工作
```bash
# 确认Python环境
python3 --version

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

### 查看当前状态
```bash
# 替换为实际脚本路径
SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --check
```

### 询问是否切换（生成询问消息）
```bash
SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --ask
```

### 确认切换（用户确认后执行）
```bash
SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --confirm
```

### 指定切换到某个模型
```bash
# 替换为目标模型
TARGET_MODEL="mydamoxing/MiniMax-M2.5"
SCRIPT_PATH="$HOME/.openclaw/skills/api-monitor/api_monitor.py"
python3 "$SCRIPT_PATH" --model "$TARGET_MODEL"
```

### 列出所有可用模型
```bash
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：
```bash
# 编辑 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` 了解运行状态