# claw-management

**Repository Path**: xcodinglifex/claw-management

## Basic Information

- **Project Name**: claw-management
- **Description**: 一款专为 OpenClaw 设计的桌面端日志分析工具，基于 Electron 构建，帮助开发者高效浏览、分析和管理 OpenClaw 会话记录。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: https://gitee.com/xcodinglifex/claw-management
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-13
- **Last Updated**: 2026-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Claw Management — OpenClaw 日志分析工具

[![License](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

> 一款专为 **OpenClaw** 设计的桌面端日志分析工具，基于 Electron 构建，帮助开发者高效浏览、分析和管理 OpenClaw 会话记录。

---

## 功能介绍

### 会话列表浏览

- **按天分组** 展示所有会话记录，清晰直观
- **通道筛选**：支持按网页聊天、企业微信、心跳通道分类查看
- **时间范围筛选**：自定义日期区间，快速定位目标日志
- **备份兼容**：自动识别 `.jsonl.reset.*` 和 `.jsonl.deleted.*` 备份文件

### 会话详情查看

- 查看单个会话的 **完整对话链路**
- 消息类型区分：用户提问、助手回复、工具调用、工具结果
- 对话链路 **时间轴弹窗**，直观展示交互过程

### 多维度统计分析

| 分析维度 | 说明 |
|---------|------|
| 统计概览 | 总会话数、总消息数、工具调用次数、平均消息数 |
| 通道分布 | 网页 / 企微 / 心跳 各通道占比统计 |
| 响应耗时 | 按对话轮次统计用户提问到助手回复的耗时，Top 20 排名 |
| 工具使用 | 各工具调用频次及平均耗时统计 |
| 意图分类 | 自动按关键词归类用户意图：咨询、操作、查询、分析 |
| 异常检测 | 识别超长思考时间、高频工具调用等异常情况 |
| 24小时热力图 | 按日期和小时维度展示用户提问分布，支持通道切换 |

---

## 界面预览

### 首页

![首页](doc/home.png)

### 日志分析

![日志分析](doc/analyzer.png)

### 会话详情

![会话详情](doc/detail.png)

---

## 快速开始

### 环境要求

- Node.js >= 18
- Windows 系统（目前主要支持 Windows）

### 安装与运行

```bash
# 克隆仓库
git clone <你的仓库地址>
cd claw-management

# 安装依赖
npm install

# 开发模式启动
npm start
```

### 使用日志分析功能

1. 启动应用后，点击 **「日志管理」** 模块进入
2. 点击左侧 **「选择目录」** 按钮，选择你的 OpenClaw `sessions` 目录（例如：`openclaw/sessions`）
3. 目录加载后，左侧列表会按天分组的展示所有会话记录
4. 点击任意会话，右侧即可查看 **会话详情**
5. 切换到 **「日志分析」** 标签页，点击 **「分析」** 按钮，即可生成多维度统计分析报表

> 小技巧：首次使用时，应用会自动尝试从配置中读取 skills 目录并推算 sessions 路径，若已配置好则无需手动选择。

---

## 打包构建

```bash
# 打包为可执行文件
npm run dist
```

打包后的安装包位于 `dist/` 目录下。

---

## 技术栈

- **Electron** — 跨平台桌面应用框架
- **HTML5 / CSS3 / JavaScript** — 前端界面
- **ECharts** — 数据可视化图表
- **electron-store** — 本地配置持久化

---

## 项目结构

```
claw-management/
├── main.js                   # Electron 主进程
├── preload.js                # 预加载脚本（IPC 通信桥接）
├── index.html                # 应用首页
├── views/
│   └── log-analyzer/         # 日志分析模块
│       ├── index.html        # 日志分析页面
│       ├── log-analyzer.css  # 样式文件
│       ├── log-analyzer.js   # 业务逻辑
│       └── lib/echarts.js    # 图表库
├── doc/                      # 文档图片
│   ├── home.png
│   ├── analyzer.png
│   └── detail.png
└── package.json
```

---

## License

[MIT](LICENSE)

---

> 如果你觉得这个项目有帮助，欢迎 Star ⭐ 支持！