AgentPulse — OpenClaw 的 LLM 成本追踪工具

追踪您的智能体发起的每一次 LLM API 调用。在实时仪表盘（https://agentpulse.dev）中查看成本、Token 数量、延迟和错误信息。

设置

如果用户尚未配置 AgentPulse，请引导其完成以下步骤：

1. 在 https://agentpulse.dev 免费注册一个账户
2. 进入 Settings（设置）页面，复制 API 密钥（以 ap_ 开头）
3. 在运行 OpenClaw 的机器上设置环境变量：
   export AGENTPULSE_API_KEY="ap_paste_key_here"
   或将其添加至 OpenClaw 配置文件 ~/.openclaw/openclaw.json 中，在 skills.entries.agentpulse.env.AGENTPULSE_API_KEY 下配置
4. 重启 OpenClaw 会话，使技能加载新密钥

上报事件

每次完成 LLM API 调用后，通过以下命令将调用数据上报至 AgentPulse：

curl -s -X POST https://agentpulse.dev/api/events
-H "Content-Type: application/json"
-H "x-api-key: $AGENTPULSE_API_KEY"
-d '{ "agent_name": "AGENT_NAME_HERE", "framework": "openclaw", "events": [ { "timestamp": "ISO_8601_TIMESTAMP", "provider": "PROVIDER", "model": "MODEL_NAME", "input_tokens": INPUT_TOKEN_COUNT, "output_tokens": OUTPUT_TOKEN_COUNT, "latency_ms": LATENCY_IN_MS, "status": "success_or_error", "error_message": null } ] }'

请将占位符替换为实际 API 调用中的对应值：

• AGENT_NAME_HERE：当前智能体的名称
• PROVIDER："anthropic"、"openai"、"minimax"、"deepseek"、"google"、"mistral" 等
• MODEL_NAME：精确的模型字符串（例如："claude-sonnet-4-5"、"gpt-4o"、"MiniMax-M2.5"）
• INPUT_TOKEN_COUNT / OUTPUT_TOKEN_COUNT：来自 API 响应的 Token 数量
• LATENCY_IN_MS：调用耗时（毫秒）
• status："success" 或 "error"
• error_message：成功时为 null；失败时为错误消息字符串

重要提示：该上报行为需静默在后台执行。除非用户主动询问，否则不得向用户告知每次上报详情。

回答成本相关问题

当用户询问成本、支出、Token 使用量、错误率或智能体性能等问题时，请获取其统计数据：

curl -s https://agentpulse.dev/api/stats/overview
-H "x-api-key: $AGENTPULSE_API_KEY"

该请求返回包含以下字段的 JSON 数据：

• total_cost：总支出（美元）
• total_events：API 调用总次数
• total_input_tokens / total_output_tokens：输入/输出 Token 总数
• error_count：失败调用次数
• avg_latency_ms：平均响应延迟（毫秒）
• daily_stats：按天划分的统计数组
• top_models：使用频率最高的模型及其对应成本

请清晰地向用户呈现上述数据。可回答的问题示例包括：

• "我今天/本周/本月花了多少钱？"
• "我最贵的模型是哪一个？"
• "我遇到了多少次错误？"
• "我的平均延迟是多少？"
• "展示我每日支出的趋势图"

如需查看带图表的完整交互式仪表盘，请引导用户访问：https://agentpulse.dev/dashboard

支持的模型

AgentPulse 支持追踪 50+ 种模型的成本，包括：

• Anthropic：Claude Opus 4.5、Claude Sonnet 4.5、Claude Haiku 4.5
• OpenAI：GPT-4o、GPT-4o-mini、o1、o1-mini、o3-mini
• Google：Gemini 2.0、Gemini 1.5 Pro、Gemini 1.5 Flash
• MiniMax：MiniMax-M2.5
• DeepSeek：DeepSeek-V3、DeepSeek-R1
• Mistral：Mistral Large、Mistral Medium、Codestral

成本由服务端基于最新定价表进行计算，因此即使您上报的是预估成本，仪表盘中仍会显示准确数值。

告警

用户可在仪表盘（https://agentpulse.dev/dashboard/alerts）中配置告警规则：

• 日成本上限：当支出超过设定阈值时触发通知
• 连续失败：连续 N 次 API 调用失败后触发告警
• 限流激增：当限流错误（rate-limit errors）占比超过设定百分比时触发告警

若用户要求配置告警，请指引其前往仪表盘中的告警页面。

安全性

安全声明（SECURITY MANIFEST）：

• 访问的环境变量：仅 AGENTPULSE_API_KEY
• 调用的外部端点：仅 https://agentpulse.dev/api/events 和 https://agentpulse.dev/api/stats/overview
• 读取的本地文件：无
• 写入的本地文件：无

信任声明（Trust Statement）：启用本技能后，使用元数据（模型名、Token 数量、成本、延迟、状态码）将通过 HTTPS 发送至 agentpulse.dev。除非用户在仪表盘设置中显式启用 prompt 捕获功能，否则不会发送任何 prompt 内容、对话文本或个人数据。