agent-cost-monitor

💰 多代理成本监控与预算管家

OpenClaw 多代理成本监控工具,实时追踪 token 消耗与预算,提供模型降级策略,帮助降低 40%-100% AI 调用成本。

收藏
2k
安装
1k
版本
v1.1.1
CLS 安全性认证2026-05-08
点击查看完整报告 >

使用说明

核心用法

Agent Cost Monitor 是专为 OpenClaw 平台设计的多代理成本监控技能。它通过调用平台内置的 session_status 工具,实时获取各个代理的会话状态与 token 消耗数据,无需任何外部 API 调用即可生成详细的成本报告。用户可通过自然语言指令(如"查看今日成本报告")手动触发,也可配置 cron 定时任务实现每日 20:00 的自动化监控。系统会对比实际消耗与预设预算阈值(如日预算 $5、周预算 $20),在接近上限时发送警报,并提供具体的优化建议。

显著优点

该技能的最大优势在于其零外部依赖的纯文档架构,从根本上杜绝了代码注入与数据泄露风险。它提供了业界罕见的详细成本估算表,涵盖 Anthropic Claude 系列(Opus/Sonnet/Haiku)的输入/输出/缓存读写费率,以及 Ollama 本地模型和 Gemini 免费层级的对比。特别实用的是其优化策略矩阵:建议将心跳检测从昂贵的 Opus 切换到免费的 Ollama 可节省 100% 成本,常规任务从 Opus 降级到 Sonnet 可节省 40%,而启用上下文剪枝与缓存保留策略能进一步降低重复 token 消耗。报告格式清晰,支持按代理、按模型、按时间维度的多视角分析。

潜在缺点与局限性

首先,该技能与 OpenClaw 平台深度绑定,非该生态用户无法使用。其次,成本估算基于官方定价表,实际费用可能因缓存命中率、特殊计费规则等因素存在偏差(文档注明为保守估算)。第三,成本追踪粒度限于会话(session)级别,无法精确到单个对话或请求级别。最后,自动化 cron 配置需要用户具备一定的技术背景手动编写 JSON5 配置,对非技术用户不够友好。此外,作为纯文档型技能,它本身不执行监控动作,依赖用户或外部代理来触发查询。

适合的目标群体

主要面向使用 OpenClaw 平台运营多个 AI 代理的开发者、DevOps 工程师和技术团队。特别适合那些月度 AI 调用预算敏感、需要严格控制运营成本的企业用户,以及希望优化代理配置以提升性价比的效率追求者。对于同时运行心脏跳动(heartbeat)监控、数据分析、内容生成等多种类型代理的复杂场景,该技能能有效识别资源浪费点。不适合单代理轻量用户或非 OpenClaw 生态用户。

使用风险

尽管技能本身为纯文档无执行风险,但用户应注意:成本估算仅供参考,不应作为财务结算的唯一依据;预算警报依赖用户正确配置阈值,配置错误可能导致超支风险;建议的模型降级策略(如从 Opus 切换到 Haiku)可能影响任务质量,需结合实际业务场景评估;使用 Ollama 等本地模型虽免费,但需自行承担本地运维成本与稳定性风险。

安全解读

核心用法

Agent Cost Monitor 是一款面向 OpenClaw 多智能体环境的成本监控技能,通过调用内置 session_status 工具实现零外部依赖的 token 追踪。用户可通过自然语言指令(如"今日哪个 agent 消耗最多 token")或定时 Cron 任务触发成本报告,获取包含单 agent 用量、预估费用、预算预警及优化建议的结构化分析。

显著优点

1. 零成本监控:纯 Markdown 指导型技能,无外部 API 调用,不增加额外费用
2. 多维度洞察:支持按 agent、模型、时间段维度拆解成本,识别"费用黑洞"

3. 实战优化手册:内置 Model Tiering 策略(Opus→Sonnet→Haiku→Ollama 降级路径)、心跳间隔调整、缓存策略优化等立即可执行的降本方案,典型场景可节省 40%-100% 成本

4. 预算安全网:可配置日/周/单 agent 多级预算阈值,支持 Telegram 等渠道主动告警

5. 自动化集成:Cron 定时报告与 DevOps Agent 工作流无缝衔接

潜在局限

  • 估算非精确值:成本基于公开模型定价估算,实际费用受缓存命中率影响,存在±10%-15% 偏差
  • 非实时细粒度:依赖 session_status 快照,无法追踪单对话级成本,最小粒度为 session 级别
  • 模型覆盖有限:内置定价表仅覆盖 Anthropic 主流模型及 Ollama/Gemini,非主流模型需手动补充费率
  • 无自动执行能力:优化建议需人工或配合其他 agent 执行,技能本身不自动调整配置

适合人群

  • 运行 3 个以上 OpenClaw agent 的中重度用户
  • 对 API 成本敏感的个人开发者、小型团队
  • 需向团队/客户汇报 AI 资源消耗的运维角色
  • 希望从"盲用"进阶到"精细化运营"的多智能体管理者

常规风险

  • 过度依赖估算:实际账单可能与预测存在偏差,建议结合官方账单校准阈值
  • 策略误配风险:盲目降级模型(如复杂推理任务用 Haiku)可能导致输出质量下降,反而增加迭代次数和总成本
  • 版本号不一致:当前 v1.1.0(文档)与 v1.1.1(meta)存在差异,升级时需留意变更日志

agent-cost-monitor 内容

手动下载zip · 3.1 kB
SKILL.mdtext/markdown
请选择文件