AgentGuard Burn

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install agentguard-burn
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 agentguard-burn。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

AgentGuard Burn 是一款免费的命令行工具，可用于调查 Claude Code 和 Codex 的使用限额、高 Token 会话，以及疑似失控的子代理。它会读取用户设备上的会话记录，并按来源报告 Token 使用量，包括对话历史、文件、工具输出和子代理活动。不会上传任何内容。
作为 Openclaw Skills 工作流，它能将使用数据转化为可执行的说明，而不会把 API 标价当成订阅账单，也不会承诺节省 Token。报告中的可选 Next: 行会提供一项根据测量结果判定为最相关的操作。

应用场景

用户达到 Claude Code 或 Codex 的使用限额，想了解 Token 被什么消耗了。
某次编程会话异常快速地消耗 Token，用户想找出消耗最多的部分。
用户怀疑子代理过度扩展，或尚未完成工作就停止了。
用户想比较两个会话、查看每天的 Token 使用量，或检查完整前缀缓存重写。
用户想要一项限制子代理启动次数的本地防护措施；安装插件前必须明确征得用户同意。

工作原理

在用户设备上运行 npx agentguard-burn why。如果没有提供会话参数，Burn 会选择最近修改的本地 Claude Code 或 Codex 对话记录；也会包含 Claude Code 子代理的对话记录。
也可以传入会话 ID、ID 末尾部分或对话记录路径，选择特定会话。
查看报告标题中的会话、响应数、Token 总数和 API 标价等值。说明美元金额不是账单；订阅用户应关注 Token 数量与限额的对比。
查看 Token 明细，并指出按 Token 占比计算最大的项目。Token 占比表示 Token，而不是美元。
将任何 Measured change: 行解释为 /compact、切换模型或 /clear 等事件之后的测量结果，而非保证节省量。
如果报告中有单独的 Next: 行，请逐字引用。如果没有，就说明没有特别显著之处，不要臆造建议。
只有当报告的下一步指向 AgentGuard 插件，或用户询问子代理限额时，才提供可选的 AgentGuard 插件；安装前先征求许可。

配置指南

要求：Node.js 20 或更高版本、npx，以及首次运行时访问 npm 的网络连接。Burn 会读取本地 Claude Code 和 Codex 对话记录。
运行报告：
npx agentguard-burn why
通过 ID、部分 ID 或对话记录路径选择特定会话：
npx agentguard-burn why SESSION_ID
在 Claude Code 中，用户也可以运行： ! npx agentguard-burn why 首次运行时会从 npm 下载软件包。安装可选插件是单独的操作，需要用户批准。
Claude Code 插件安装：
claude plugin marketplace add MerchantGuard/agentguard-codex-plugin
claude plugin install agentguard@agentguard
用于本地任务的 Codex 或 ChatGPT 桌面应用：
codex plugin marketplace add MerchantGuard/agentguard-codex-plugin
codex plugin add agentguard@agentguard
Codex 显示已安装的插件文件夹后，在该文件夹中运行 npm ci。未经用户同意，不得安装插件。

数据架构

Burn 会分析已有的本地会话记录；此技能未指定单独的导出格式或生成的对话记录归档。其报告会按以下类别整理结果：
报告项目 信息
标题 会话、响应数、Token 总数和 API 标价等值
Token 明细 指令堆栈与系统提示、重新发送的历史记录、重新读取的文件、子代理扩展、工具输出、对话、完整前缀重写、输出及无法归属的 Token
测量行 /compact、切换模型或 /clear 等事件之后可选的 Measured change:；它表示测量结果，而非节省量
建议 根据会话数据选出的至多一项 Next: 操作
本地分析会将对话记录内容保留在设备上。不要复制或上传对话记录内容。API 标价等值不是账单，Token 占比百分比也不是美元占比百分比。

高级特性

分析会话时会纳入 Claude Code 子代理的对话记录，因此可以在 Token 明细中看到子代理扩展情况。
npx agentguard-burn calendar
，按天统计 Claude Code 和 Codex 的 Token，并标记有子代理活动的日期。
npx agentguard-burn compare
，并排比较两个会话。
npx agentguard-burn rewrites
，列出完整前缀缓存重写及其原因。
npx agentguard-burn quiet on
Next:
提示，以及
npx agentguard-burn quiet off
重新显示提示。
可选的免费 AgentGuard 插件会在本地应用子代理限额：任意连续 15 个活跃分钟内最多启动 15 次，任意连续 120 个活跃分钟内最多启动 40 次，单个会话最多 50 亿 Token，子代理最多两层深度。
在 Claude Code 默认的 accept edits、auto 或 plan 模式中，超过限额的启动会等待用户许可。在 Codex 以及 Claude Code 的 bypass-permissions、don't-ask 或 print 模式中，启动会被 STOP 提示框阻止；Codex 不会提示用户批准。
用户可以用
npx agentguard-burn shadow
切换为仅记录模式，用
npx agentguard-burn enforce
恢复强制执行。代理不得代替用户运行 override、shadow 或 calibrate 命令。
插件钩子在本地运行，不会打开网络连接。除非用户请求 AgentGuard Score，否则免费使用不会发送任何内容。

name: agentguard-burn description: Find out what used up a Claude Code or Codex usage limit. Runs npx agentguard-burn why on this machine's session transcripts, explains where the tokens went, relays the one "Next:" step it prints, and can install the free AgentGuard plugin that holds runaway sub-agent launches. Use when the user hit their Claude Code or Codex limit, asks where their tokens went, why a session cost so much or ran out so fast, or mentions runaway sub-agents. version: 1.0.0
author: agentguard-run
compatibility: Needs Node.js 20 or later with npx and network access to npm for the first run. Reads Claude Code and Codex transcripts on the local machine.