名称： redline
描述： 为 Claude.ai（Max/Pro）和 OpenAI（Plus/Pro/Codex）提供实时速率限制监控。永不再触碰红线——你的代理会在每次心跳时检查剩余额度，并自动从全力模式切换到节能模式。包含两个 CLI 脚本和一个四级速率调控策略（🟢 绿色/🟡 黄色/🟠 橙色/🔴 红色），确保 7x24 小时以最高效的令牌利用率持续运行。
元数据：
openclaw:
requires:
bins: [python3]

使用速率调控

实时检查 Claude.ai 和 OpenAI/Codex 套餐的速率限制使用情况，并应用速率调控层级以避免触及限制。

脚本

claude-usage

从 macOS 钥匙串读取 Claude Code OAuth 令牌，并调用 Anthropic 用量 API。

# 带彩色进度条的人类可读输出
scripts/claude-usage

# JSON 格式输出（供程序化调用）
scripts/claude-usage --json

要求：
- 装有 security CLI（用于钥匙串访问）的 macOS 系统
- Claude Code OAuth 令牌已存入钥匙串（运行 claude login 进行设置）
- 令牌需要 user:profile 权限（标准的 Claude Code 登录会提供此权限）

令牌位置： macOS 钥匙串，服务名为 Claude Code-credentials，账户为你的 macOS 用户名。

openai-usage

从 OpenClaw 的认证配置文件中读取 OpenAI OAuth 令牌，并调用 ChatGPT 用量 API。

# 带彩色进度条的人类可读输出
scripts/openai-usage

# JSON 格式输出
scripts/openai-usage --json

要求：
- 已安装 OpenClaw 并拥有认证过的 openai-codex 配置文件（运行 openclaw auth openai-codex）
- 认证配置文件位于 ~/.openclaw/agents/main/agent/auth-profiles.json

速率调控层级

将这两个脚本集成到你的心跳机制中，即可根据剩余额度自动调控工作节奏：

心跳集成

添加到你的 HEARTBEAT.md 文件中：

## 使用速率调控（每次心跳执行）
- 运行 `scripts/claude-usage --json` 和 `scripts/openai-usage --json` 以检查速率限制。
- 将读数存储在 memory/heartbeat-state.json 的 "usage.claude" 和 "usage.openai" 字段下。
- 应用速率调控层级：
  - 绿色 (>50% 剩余)：正常操作
  - 黄色 (25-50%)：跳过子代理，推迟非紧急研究
  - 橙色 (10-25%)：仅限必要回复，不进行主动检查
  - 红色 (<10%)：仅限关键任务，并提醒用户
- 如果进入黄色或更高级别，在下一次发送消息时简要提及。

JSON 输出格式

Claude (--json):

{
  "five_hour": {"utilization": 39.0, "resets_at": "2026-02-18T04:00:00Z"},
  "seven_day": {"utilization": 12.0, "resets_at": "2026-02-24T03:00:00Z"},
  "extra_usage": {"is_enabled": true, "used_credits": 5044, "monthly_limit": 5000}
}

OpenAI (--json):

{
  "plan_type": "plus",
  "rate_limit": {
    "primary_window": {"used_percent": 0, "limit_window_seconds": 10800, "reset_at": 1771556400},
    "secondary_window": {"used_percent": 34, "limit_window_seconds": 86400, "reset_at": 1771556400}
  },
  "credits": {"balance": "882.99"}
}