Anthropic Usage — Anthropic 使用

您正在帮助用户通过 Admin API 查询他们的 Anthropic 令牌使用情况。运行任何命令之前，请检查 API 密钥是否可用：[[ -n "${ANTHROPIC_ADMIN_API_KEY:-}" ]] && echo "KEY_EXISTS" || echo "KEY_MISSING" 如果输出是 KEY_MISSING：停止并引导用户完成设置。不要在变量设置之前继续。如果输出是 KEY_EXISTS：继续。

设置指南（显示当 KEY_MISSING 时） 告诉用户他们有两个选项： 选项 1（推荐）— OpenClaw UI：打开 OpenClaw UI，前往 Skills → anthropic-usage，输入 Admin API 密钥到 API 密钥字段中，并点击 Save key。 选项 2 — 直接编辑 ~/.openclaw/openclaw.json（适用于 CLI 用户）：在技能条目下添加密钥： { "skills": { "entries": { "anthropic-usage": { "enabled": true, "apiKey": "sk-ant-admin-..." } } } } 网关会自动检测到更改 — 无需重启。他们可以从 Anthropic Console 的 Settings → API Keys → Admin keys 中获取 Admin API 密钥。他们的账户必须在 Organization 计划中才能访问使用情况报告。

运行使用情况脚本 一旦密钥存在，使用适当的标志运行 scripts/usage.sh，基于用户的请求： 用户意图 命令 今天的使用情况 bash scripts/usage.sh --daily 本周 bash scripts/usage.sh --weekly 本月 bash scripts/usage.sh --monthly 按模型划分 bash scripts/usage.sh --breakdown 每周 + 模型划分 bash scripts/usage.sh --weekly --breakdown 每月 + 模型划分 bash scripts/usage.sh --monthly --breakdown 从技能的根目录（scripts/ 所在位置）运行命令，或使用 scripts/usage.sh 的完整路径。

格式化输出 脚本运行后：以友好的聊天消息形式呈现数据，而不是原始数据转储。在顶部总结关键数字（总输入令牌，总输出令牌）。如果使用了 --breakdown，渲染每个模型的表格以便于阅读。估计成本（代理端步骤）：脚本仅返回令牌计数 — 不包括定价。在呈现令牌数据后，使用 web_fetch 工具获取 https://www.anthropic.com/pricing 并提取结果中出现的每个模型的当前费率（输入、缓存写入、缓存读取和输出令牌费率）。计算每个模型的估计成本和总成本。将其呈现为令牌表格后的成本摘要。如果在页面上找不到模型的定价，请将其标记为未知并跳过总计。这个获取是故意的，仅限于 anthropic.com。如果脚本以错误代码（非零退出代码）退出，显示错误消息并建议修复： 退出 1 / "密钥文件未找到" → 重新显示设置指南 "401 未经授权" → 密钥无效或过期 "403 禁止" → 密钥缺乏 Admin 权限或账户不在 Organization 计划中 网络错误 → 询问用户检查其互联网连接

示例友好输出 以下是您过去 7 天的 Anthropic 使用情况： 📥 输入令牌：12,450,000 📤 输出令牌：1,830,000 🔢 总令牌：14,280,000 模型划分： | 模型 | 输入令牌 | 输出令牌 | |---------------------------|-------------|---------------| | claude-opus-4-6 | 8,200,000 | 1,100,000 | | claude-sonnet-4-6 | 3,900,000 | 680,000 | | claude-haiku-4-5-20251001 | 350,000 | 50,000 | 💰 估计成本（从 anthropic.com/pricing 获取的价格）： | 模型 | 估计成本 | |---------------------------|----------------| | claude-opus-4-6 | $152.40 | | claude-sonnet-4-6 | $18.72 | | claude-haiku-4-5-20251001 | $0.53 | | 总计 | $171.65 | 保持有帮助和简洁的语气。