正文内容
使用速率控制(Usage Pacing)
实时检查 Claude.ai 和 OpenAI/Codex 订阅计划的速率限制使用情况,并依据剩余配额自动应用分级速率控制策略,避免触达调用上限。
脚本
claude-usage
从 macOS Keychain 读取 Claude Code OAuth Token,并调用 Anthropic 的用量 API。
# 带彩色进度条的人类可读输出
scripts/claude-usage
# JSON 格式输出(供程序化调用)
scripts/claude-usage --json
依赖条件:
- macOS 系统,且已安装
securityCLI 工具(用于访问 Keychain) - 已在 Keychain 中存入 Claude Code OAuth Token(运行
claude login可完成配置) - Token 需具备
user:profile权限范围(标准 Claude Code 登录流程默认提供该权限)
Token 存储位置: macOS Keychain,服务名 Claude Code-credentials,账户名 = 当前 macOS 用户名。
openai-usage
从 OpenClaw 的 auth-profiles 中读取 OpenAI OAuth Token,并调用 ChatGPT 用量 API。
# 带彩色进度条的人类可读输出
scripts/openai-usage
# JSON 格式输出
scripts/openai-usage --json
依赖条件:
- 已安装并配置 OpenClaw,且存在已认证的
openai-codexprofile(运行openclaw auth openai-codex可完成认证) - Auth profiles 文件路径为
~/.openclaw/agents/main/agent/auth-profiles.json
速率控制等级(Pacing Tiers)
将上述两个脚本集成至您的心跳机制(heartbeat),根据当前剩余预算自动调整任务执行节奏:
| 等级 | 剩余配额 | 行为策略 |
|---|---|---|