Kimi 使用监控器

通过 Kimi 控制台监控 Kimi K2.5 的用量配额，以支持任务优先级排序与资源分配的科学决策。

适用场景

• 执行高强度操作前：启动多步骤研究或编码任务前，检查当前配额使用情况
• 自主规划：根据剩余用量百分比自动调整任务优先级
• 速率限制感知：掌握配额重置时间，以便将高优先级工作安排在重置后执行
• 用量追踪：记录历史用量模式，支撑长期容量规划

快速开始

前提条件：已安装 OpenClaw 扩展的 Chrome 浏览器

1. 打开 Chrome → https://www.kimi.com/code/console?from=membership
2. 点击 OpenClaw 扩展图标（徽章应显示为 ON）
3. 确保您已登录 Kimi

# 检查当前用量（Linux/macOS/WSL）
./check_usage.sh

# Windows 原生环境
check_usage.bat           # CMD
.check_usage.ps1         # PowerShell

# JSON 格式输出（适用于自动化脚本，全平台支持）
python3 scripts/fetch_usage.py --json

平台支持： Linux ✅ | macOS ✅ | Windows (WSL) ✅ | Windows (Native) ✅

可用用量数据

Kimi 控制台显示以下指标：

自主决策指南

在自主运行模式下，请参考以下启发式规则：

🟢 高容量（剩余 >50%）

• 以全部能力正常执行
• 可接受多步骤研究类任务
• 按需生成子代理（subagent）
• 启用详细推理（verbose reasoning）

🟡 中等容量（剩余 25–50%）

• 批量执行同类操作
• 优先返回简洁输出
• 谨慎使用子代理
• 禁用非必要推理环节

🔴 低容量（剩余 <25%）

• 仅执行关键任务
• 限定为单步操作
• 避免生成子代理
• 优先响应用户指令任务，暂缓主动发起的任务

高强度操作前的预检流程

在生成子代理或启动多步骤任务前，请先检查当前容量状态：

# 检查是否允许执行该操作
python3 scripts/preflight_check.py [light|standard|intensive]

# light：单次查询、简单任务（需占用 10% 配额）
# standard：常规子代理调用、研究任务（需占用 25% 配额）
# intensive：多子代理协同、深度研究（需占用 50% 配额）

若检查通过则返回退出码 0，否则返回 1。可在脚本中直接调用：

if python3 scripts/preflight_check.py intensive; then
    # 执行高强度操作
    sessions_spawn "Complex research task..."
fi

子代理防护机制

在生成子代理前，请单独执行此检查：

python3 scripts/subagent_guard.py

返回包含 can_spawn 布尔字段的 JSON 结果：

{
  "can_spawn": true,
  "usage_percent": 45,
  "remaining_percent": 55,
  "resets_hours": 36
}

集成思路

每小时监控定时任务（cron）：

# 添加至 crontab 或 OpenClaw 定时任务中
0 * * * * cd /path/to/kimi-usage-monitor && python3 scripts/usage_logger.py

任务执行前校验：

import subprocess
result = subprocess.run(
    ["python3", "scripts/preflight_check.py", "intensive"],
    capture_output=True
)
if result.returncode == 0:
    # 执行任务
    pass

脚本参考

注意： 提供基于 Playwright 的备用采集脚本（fetch_kimi_usage.py），适用于无 OpenClaw 环境（需安装系统依赖）。

故障排查

“浏览器不可用”

• 确认 Chrome 扩展已正确附加（徽章显示为 ON）
• 确认 Kimi 控制台标签页已打开

“无法检测用量”

• 确认您已登录 Kimi
• 确认控制台页面已完全加载完成

认证错误

• 请前往 https://www.kimi.com/code/console 重新完成身份验证
• 该浏览器工具复用您当前 Chrome 会话中的登录状态

输出格式

人类可读格式（默认）

📊 Kimi 使用监控器
========================================

🗓️  周用量
   已用：45%
   剩余：55%
   距重置：36 小时
   状态：🟡 中等 — 请合理规划

⚡ 速率限制
   已用：2%
   距重置：3 小时

JSON 格式（使用 --json 参数）

{
  "weekly_usage_percent": 45,
  "weekly_resets_hours": 36,
  "rate_limit_percent": 2,
  "rate_limit_resets_hours": 3,
  "timestamp": "2026-02-12 21:15:00"
}

许可证

MIT 许可证 — 欢迎自由修改与分发。