Ai Bill Clawhub

核心功能

AI Bill Intelligence 是一款专为 OpenClaw 生态设计的 API 成本监控工具，提供实时、可视化的多平台 AI 服务费用追踪能力。核心功能涵盖：

• 多供应商支持：覆盖 OpenAI、Anthropic Claude、Google Gemini、Moonshot Kimi、DeepSeek、xAI Grok 六大主流 AI API
• 实时数据采集：30 秒间隔自动拉取 OpenClaw 会话数据，即时计算 Token 消耗与费用
• 可视化仪表盘：本地 Web 服务（端口 8003）展示实时支出、剩余余额、用量趋势
• 预算管理：通过 vault.json 预设各平台初始额度，实现精细化成本控制

显著优点

1. 开箱即用：systemd 服务托管，无需手动维护进程
2. 本地化部署：数据不出本地，满足隐私敏感场景
3. 零代码配置：JSON 文件驱动，非技术用户亦可快速上手
4. 灵活定价：prices.json 支持自定义费率，适应促销或企业协议价

潜在局限

• 生态绑定：深度依赖 OpenClaw 会话格式，独立使用受限
• 单点架构：无多用户或团队协作能力，仅适合个人开发者
• 手动对账：依赖用户手动更新初始余额，无法自动同步云端账单
• 精度限制：30 秒采集周期可能遗漏短促请求峰值

适合人群

• 高频调用多平台 API 的个人开发者
• 需要成本可视化的 AI 应用原型团队
• 对数据本地化和隐私有强要求的用户

常规风险

| 风险类型 | 说明 | 建议措施 |

|---------|------|---------|

| 配置泄露 | `vault.json` 含余额信息可能误提交 Git | 纳入 `.gitignore` 并加密存储 |

| 服务中断 | systemd 服务异常导致监控盲区 | 配置健康检查与告警 |

| 定价滞后 | 官方调价后未同步 `prices.json` | 订阅供应商费率变更通知 |

| 端口暴露 | 本地仪表盘默认监听所有接口 | 绑定 `127.0.0.1` 或启用认证 |

核心用法

AI Bill Intelligence 是一款专为 OpenClaw 生态设计的 AI API 成本监控技能，通过本地服务架构实现实时计费追踪。用户完成安装后，需在 vault.json 中配置各 AI 服务商的初始余额，随后启动 ai-bill 与 ai-bill-collector 双服务即可运行。Collector 组件每 30 秒自动读取 OpenClaw 会话数据，结合 prices.json 中的定价规则计算实时成本，最终在本地 8003 端口呈现可视化仪表板。支持 OpenAI、Claude、Gemini、Kimi、DeepSeek、Grok 六大主流平台，覆盖当前开发者的核心 AI 服务矩阵。

显著优点

该技能的最大优势在于透明可控的本地化处理——所有敏感会话数据仅在本地文件系统流转，无外部 API 上传风险，符合 GDPR 数据最小化原则。技术实现上采用轻量级双服务架构，Dashboard 服务提供实时可视化界面，Collector 服务保障数据持续同步，这种分离设计既降低资源占用又提升稳定性。定价配置完全开放，用户可根据实际费率自定义 prices.json，灵活应对各平台的动态调价策略。此外，依赖栈极为精简（仅 express、cors 两个 npm 包），攻击面小且维护成本低。

潜在局限

作为 T3 来源级别的社区项目，其长期维护能力与生态持续性存在不确定性——GitHub 仓库无法通过 API 验证，无法确认作者账号信誉、贡献者规模及 issue 响应时效。功能层面，该技能深度绑定 OpenClaw 生态，非 OpenClaw 用户无法直接使用；会话文件路径的硬编码默认值（/root/.openclaw/agents/main/sessions/sessions.json）在自定义部署场景中可能引发权限或路径不匹配问题。此外，30 秒的数据采集间隔对于高频调用场景略显滞后，且缺乏成本预警阈值、预算自动锁定等进阶管控能力。

适合人群

该技能主要面向多模型并行使用的 AI 开发者与中小型技术团队，特别是需要精细化管理多平台 API 预算、避免账单失控的场景。对运维敏感的企业用户而言，纯本地数据处理模式是重要加分项。同时适合已将工作流深度集成 OpenClaw 生态的忠实用户，以及偏好自托管监控方案、不愿将计费数据托管至第三方 SaaS 的隐私优先型开发者。

使用风险

来源可信度风险：T3 级别意味着需人工复核 GitHub 仓库实际状态，建议首次使用前访问仓库检查 commit 历史与维护活跃度。文件系统安全风险：Collector 需读取会话数据目录，应确保 OPENCLAW_SESSIONS 环境变量正确配置或默认路径权限受控，避免会话文件被意外篡改。依赖演进风险：express 与 cors 虽为成熟包，但长期未更新可能累积 CVE，建议每季度执行 npm audit。本地服务暴露风险：Dashboard 监听 8003 端口，需在防火墙层确保仅本地可访问，防止敏感成本数据外泄。配置持久化风险：vault.json 存储余额信息，建议纳入备份策略避免配置丢失。