Clawalytics CN

面向 Claude Code 与 OpenClaw 的 AI 成本分析仪表盘。
用一个本地面板看清你的花费、Token、模型使用、Agent 表现、渠道数据和安全状态。

Clawalytics 把原本分散在日志、会话记录和网关事件里的信息整理成一个更容易读懂的界面。除了 OpenClaw，现已支持 Hermes 作为分析数据源：可以读取 Hermes 的会话与用量数据，统一展示成本、Token、模型和趋势，并在设置页按数据源切换对应的配置与诊断信息。你可以快速回答这些问题：

• 今天、本周、本月一共花了多少钱
• 哪个模型、哪个 Agent、哪个渠道最耗资源
• Prompt Cache 帮你省了多少成本
• 最近有哪些会话、设备、配对请求和安全告警
• 当前预算有没有接近阈值

OpenClaw 与 Hermes 可以分别配置数据位置并独立分析；切换数据源后，仪表盘会使用对应的数据管道和统计结果，不影响本地运行方式。

当前版本：v0.7.10

v0.7.10 修复设备配对同步的可靠性、非 /ws WebSocket 升级请求的处理和桌面端 CSV 导出，并升级旧数据库的配对记录迁移。

当前发布提供 Windows x64 NSIS 安装版，推荐直接下载安装：

• 下载 Clawalytics v0.7.10 Windows 安装包
• 下载 Clawalytics v0.7.10 Portable 版
• 查看 v0.7.10 Release

本次发布提供 Windows x64 安装包和 portable 构建，普通用户推荐使用上面的 NSIS 安装包。

0.7.10 本次更新

这一版以“有效快照是权威状态”为核心重构了配对同步，并修复两个发布阻断问题，全部改动先以失败回归测试还原：

• 旧数据库迁移修复：新增 schema v5，把没有稳定请求 ID 的旧 pending 配对记录收敛为单条有效请求（最新一条绑定 source_request_id，其余保留历史并标记 removed），覆盖从 v3 直接升级和 v4 之后出现“旧记录 + 新规范记录”并存两种路径。
• 配对/设备状态可收敛同步：paired.json / pending.json 任一文件变化都会重新读取两份快照并做全量对账；只针对真实状态变化写库、记审计和发告警，重复快照不再产生重复记录或通知。
• 文件乱序最终一致：请求先从 pending 消失再出现在 paired（或反之）两种顺序都会收敛到 resolved；已 resolved 的历史请求不会因设备以后移除而降级。
• 快照缺失或损坏时保留数据库与内存状态，按 100/250/500/1000/2000ms 单队列重试，新文件事件会重置重试；畸形条目（如 {"requests":[{}]}）不会写库也不会阻止后端启动。
• WebSocket 安全边界：非 /ws 路径的 upgrade 请求现在明确返回 404 并关闭连接，不再留下悬挂 socket，服务器 stop 不再因此挂起。
• 桌面端 CSV 导出修复：Dashboard 与工具页改用同源认证 fetch + 临时 <a download> 触发下载，文件名取自 Content-Disposition，失败时显示双语错误提示；不再依赖会被 Electron 拦截的 window.open。
• 桌面 E2E 扩展：验证页面内认证、无 token 请求 403、HttpOnly 令牌不可读、页面 WebSocket connected、渲染器隔离、主题切换与两处非空 CSV 下载。

0.7.9 本次更新

• 兼容 OpenClaw 2026.8.2 将活跃会话迁移到 SQLite 后的数据读取
• 支持 WSL2 SQLite/WAL 一致性快照、旧版 JSONL 和旧版 SQLite 格式
• OpenClaw 无法创建快照时保留历史数据并明确提示数据源已过期
• 支持 reasoning tokens，并过滤不可直接读取的 .zst 压缩归档

0.7.8 本次更新

这一版专注于修复七个潜在的数据正确性问题，全部通过测试先行方式还原。每个修复都新增了回归测试，且没有改变对外的 HTTP 接口与配置格式。

• 自定义价格保存后立即生效，无需重启进程；删除内置模型的价格会自动恢复为默认值，删除纯自定义模型则保持无定价。
• 月末日期（29-31 号）下“上月”键不再溢出到当月，2 月 / 4 月等短月份终于能被正确计入上月成本。
• 一条 Hermes 聚合记录代表 N 次调用时，模型每日 / Agent 每日 / 全 Agent 每日的请求数都按 N 累加；显式 0 次保留为 0。
• 切换到“仅 Hermes”时不再泄漏零成本的 OpenClaw Agent 列表。
• 网关解析器统一复用 costs.ts 中的供应商识别，MiniMax / MiMo / Moonshot k2p5 / Mistral / Llama 等模型归类一致。
• 模型异常检测窗口改为两个互不重叠的 7 天窗口，真实成本尖峰（上周 1 / 本周 100）现在能触发告警，不再被 2 倍比率上限压制。
• Hermes 成功刷新后会触发与 OpenClaw 相同的预算 / 异常检查，且检查始终在“all”数据源上下文运行。
• 预算与异常检测的去重键统一使用本地日历日期，不再因时区差异错位到“明天”。

0.7.7 本次更新

这一版重点修复本机后端服务在局域网可被访问的风险，并补齐相关回归测试：

• 后端 HTTP 服务固定绑定到 IPv4 回环接口（127.0.0.1），避免无认证的分析与配置 API 在局域网内被访问。
• Electron 桌面端的后端请求统一限制在 127.0.0.1 回环接口，并使用每进程临时令牌保护。
• 新增 pnpm test:server-binding：在每次发布前自动验证监听地址、健康接口响应，以及对外部接口的连接拒绝。
• 新增 Hermes 数据源支持：可读取 Hermes 会话和用量数据，接入统一的成本、Token、模型与趋势分析，并提供数据源切换和配置诊断。
• 其它可用性修复：仪表盘模型用量 Treemap 在窄区域内的文字越界、圆角不一致等问题（沿用 v0.7.6 已修复内容）。

0.7.0 本次更新

这一版重点补齐 Windows 桌面端和 OpenClaw 数据接入体验：

• 新增 OpenClaw WSL2 数据源支持：设置页可先选择 OpenClaw 运行在 Windows 还是 WSL2，再填写对应路径；WSL2 模式支持发行版名、Linux 路径和 \\wsl.localhost\... 读取路径预览。
• 优化数据接口设置布局：Windows 模式保留目录选择器；WSL2 模式输入框会用灰字提示 ~/.openclaw、/home/you/.openclaw 这类 Linux 路径格式。
• 开机启动支持两种方式：可以选择登录 Windows 后直接显示主页面，也可以选择静默启动到托盘。
• 启动速度优化：OpenClaw 会话解析加入增量缓存，启动时先显示已有缓存数据，再在后台刷新变更过的 session 文件。
• 后台刷新更稳：会话重解析、价格刷新和 WSL2 目录监听都调整为更适合桌面常驻的方式，减少启动等待和退出卡顿。
• 数据完整性增强：兼容新版 OpenClaw 的 agent SQLite transcript，以及 /new、/reset 产生的 .jsonl.reset.* / .jsonl.deleted.* 历史文件；同一会话优先读取 SQLite，避免重复计费。

相比原版，这个分支多了什么

这个仓库基于 clawalytics/clawalytics，保留了原版的成本分析、会话历史、Agent 分析、渠道分析和安全监控能力，同时额外补上了更适合中文用户和 Windows 用户的增强：

• 完整中文本地化：内置 中文 / English 切换，导航、页面文案、设置项、错误页以及部分时间展示都做了双语支持
• Windows 桌面版：新增 Electron 桌面应用，提供可直接安装的 setup.exe
• 托盘常驻体验：支持最小化到托盘、关闭时询问、记住关闭动作、托盘菜单重新打开和真正退出
• 开机自启与启动方式：可配置登录 Windows 后自动启动，并选择启动后直接显示主窗口或静默驻留托盘
• OpenClaw WSL2 支持：可选择 Windows 或 WSL2 数据源，支持 Linux 路径填写和 \\wsl.localhost\... 读取路径预览
• 桌面通知增强：支持原生 Windows 通知，并可在设置里控制通知开关、触发条件和通知延迟秒数
• 设置与接入体验优化：补充了更完整的设置页，优化了 OpenClaw 路径配置和桌面端初次使用流程
• 主题与视觉优化：增加图表颜色联动、主题细化和 Windows Accent Color 适配，让桌面版外观更统一
• 中文文档与发布体验：README、安装说明和 Release 分发方式都更偏向中文用户的直接使用场景

如果你想要的是“原版能力 + 中文界面 + Windows 常驻桌面体验”，这个分支会更适合直接落地使用。

亮点

模块	你能看到什么
成本总览	生命周期、月、周、日花费，趋势图，缓存节省，模型占比
会话分析	每次会话的项目路径、模型、Token、成本、最近活跃时间
模型分析	不同模型和供应商的成本分布、调用次数、输入输出 Token
Agent 分析	OpenClaw 多 Agent 的成本、趋势、请求量与表现对比
渠道分析	WhatsApp、Telegram、Slack 等渠道的成本、消息数、单条消息成本
安全监控	设备列表、配对请求、安全告警、连接历史、审计日志
桌面体验	Windows 桌面版、托盘驻留、原生通知、开机自启与启动方式选择
数据接入	OpenClaw Windows / WSL2 与 Hermes 数据源、增量会话缓存、后台刷新

Windows 桌面版

现在仓库已经提供可安装的 Windows 桌面版本，适合希望常驻后台、随时查看成本数据的用户。

• Release 页面: https://github.com/xinmo114514/clawalytics-cn/releases
• 当前安装包命名规则: Clawalytics-<version>-win-x64-setup.exe
• 安装完成后会出现在开始菜单和桌面快捷方式中

桌面版特性

• Win11 风格窗口壳和更现代的标题栏
• 支持开机自启，并可选择“启动后直接打开主窗口”或“静默启动到托盘”
• 关闭按钮支持弹出选择:
  • 最小化到托盘
  • 退出应用
  • 取消
• 支持记住关闭时的选择
• 托盘菜单可重新打开窗口，也可以重置为“下次关闭时再次询问”
• 托盘里的 Quit 会真正退出程序，不会继续驻留后台
• 支持原生 Windows 通知，并可设置通知开关、触发条件和通知延迟

安装与使用说明

• Clawalytics-<version>-win-x64-setup.exe
  • 推荐普通用户使用
  • 安装后会自动创建开始菜单和桌面快捷方式
• 第一次打开应用后，建议先在右上角设置里确认:
  • OpenClaw 数据运行在 Windows 还是 WSL2
  • OpenClaw 数据目录或 WSL2 Linux 路径
  • Gateway 日志目录
  • 是否开启开机自启
  • 开机后显示主窗口，还是直接驻留托盘
  • 点击关闭按钮时是询问、最小化到托盘，还是直接退出
  • 桌面通知是否开启、按什么条件触发、延迟多少秒提醒

快速开始

Clawalytics CN 仅通过 GitHub Releases 提供 Windows 桌面版。下载并运行 Clawalytics-<version>-win-x64-setup.exe，应用会在本机回环地址启动内嵌后端， 不会在安装或卸载时注册、启动或停止系统服务。

源码开发方式

开发者可以从源码运行 Vite 与 Electron：

pnpm install
pnpm dev
pnpm build
pnpm lint
pnpm format:check

从源码构建 Windows 安装包

pnpm install
pnpm build:desktop

构建完成后，产物默认在：

release/Clawalytics-<version>-win-x64-setup.exe
release/Clawalytics-<version>-win-x64-portable.exe
release/win-unpacked/Clawalytics.exe

典型使用场景

只使用 Claude Code

即使你没有接入 OpenClaw，Clawalytics 也可以单独工作，用来分析：

• Claude Code 日志中的成本与 Token
• 会话趋势与项目分布
• 模型使用占比
• Prompt Cache 带来的节省

配合 OpenClaw 使用

接入 OpenClaw 后，你还可以额外获得：

• 多 Agent 成本归因
• 渠道维度的成本和消息统计
• 设备配对与安全监控
• 审计日志与工具调用分析

功能概览

成本与 Token 分析

• 生命周期、月、周、日成本统计
• 30 天花费趋势
• 输入、输出、缓存创建、缓存读取 Token 拆分
• Prompt Cache 节省估算
• 按模型查看成本分布

会话历史

• 全量会话列表
• 按项目、日期、关键字筛选
• 每次会话的成本归因
• 最近活跃时间与持续时长

Agent 与渠道洞察

• 多 Agent 成本对比
• 单 Agent 趋势图与详情页
• 渠道消息量与成本对比
• 单条消息成本估算

安全与审计

• 已配对设备列表
• 待处理配对请求
• 安全告警面板
• 连接事件历史
• 可筛选的审计日志
• 工具调用成功率与耗时统计

使用体验

• 中文 / English 语言切换
• Light / Dark / System 主题切换
• 本地数据库，无需单独部署外部数据库
• Windows Electron 桌面端内置本机后端与数据分析

配置与数据位置

Clawalytics 默认把配置和数据放在用户目录下：

• 配置文件：~/.clawalytics/config.yaml
• 数据库：~/.clawalytics/clawalytics.db
• 日志文件：~/.clawalytics/clawalytics.log

常见配置项包括：

• OpenClaw 数据路径
• Gateway 日志路径
• 安全告警开关
• 模型手工费率覆盖

一个常见配置示例：

# Claude Code 日志目录，默认会自动检测
logPath: ~/.claude/projects

# OpenClaw 集成
openClawEnabled: true
openClawPath: ~/.openclaw

# 安全监控
securityAlertsEnabled: true
gatewayLogsPath: /tmp/openclaw

# 预算阈值
alertThresholds:
  dailyBudget: 10
  weeklyBudget: 50
  monthlyBudget: 200

支持的模型与供应商

Clawalytics 支持对多家 AI 供应商的调用成本进行分析，包含但不限于：

供应商	典型模型
Anthropic	Claude Opus 4、Claude Sonnet 4、Claude Sonnet 3.5、Claude Haiku 3.5
OpenAI	GPT-4o、GPT-4o-mini、GPT-5
Google	Gemini 系列
DeepSeek	DeepSeek Chat、DeepSeek Reasoner
Kimi	Kimi 系列

对支持缓存定价的模型，系统会自动把缓存相关成本纳入统计。

技术栈

• 前端：React 19、TanStack Router、TanStack Query、Tailwind CSS、Recharts
• 后端：Express 5、better-sqlite3、WebSocket
• 桌面端：Electron
• 构建：Vite、TypeScript、electron-builder

主题色与美观度提升

这一版对整体配色做了更系统的整理，不再只是“能换主题”，而是尽量让不同模块在视觉上看起来属于同一套产品语言。

• 仪表盘里的“每日成本”“最近 30 天花费趋势”等核心图表，已经和当前主题色联动，切换主题后主曲线、辅助曲线、网格线、坐标轴与提示色会一起变化。
• 统一收敛了原本分散的硬编码颜色，优先改为读取主题变量，减少某些卡片、图表、图标和状态色彼此风格割裂的问题。
• 每套主题不仅有主色，还补齐了图表色、成功色、警告色、信息色与边框层级，让浅色 / 深色模式下都更协调、更耐看。
• Windows 桌面版支持跟随系统 Accent Color，配合应用内的蓝色、紫色、绿色、橙色、粉色主题，可以更自然地融入不同用户的系统环境。
• 这次优化的目标不是单纯把颜色“做得更亮”，而是让数据可读性、层次感和整体观感同时提升，尤其是在长时间查看成本图表时更舒服。

License

MIT