hz4th_coder
3e835371cb
- 新增 /api/agents/:agentName/conversations API，按 sessionKey 分组汇总 - 新增 /api/agents/:agentName/conversations/:sessionKey/timeline API - 前端新增「对话汇总」Tab，展示对话级别的统计信息 - 支持展开查看对话下的所有 session 阶段 - 修复 session 文件不存在时返回 404 的问题 功能： - 显示每个对话的总消息数、Token 数、压缩次数、时长 - 标注原始 session 和压缩后的 session - 显示对话时间跨度
60 lines
1.7 KiB
Markdown
60 lines
1.7 KiB
Markdown
# OpenClaw Agent Sessions Viewer
|
|
|
|
智能体会话历史查看器 - 一个用于展示 OpenClaw 智能体历史会话信息的网页工具。
|
|
|
|
## 功能
|
|
|
|
- 📋 **智能体列表** - 显示所有智能体及其会话数量
|
|
- 💬 **会话列表** - 查看每个智能体的会话，包含渠道、状态、模型等信息
|
|
- 📝 **消息详情** - 浏览会话中的完整消息历史
|
|
- 🔍 **完整内容查看** - 对于长消息，可点击查看完整内容
|
|
|
|
## 技术栈
|
|
|
|
- **后端**: Node.js + Express
|
|
- **前端**: 纯 HTML/CSS/JavaScript（无框架）
|
|
- **数据源**: `/home/openclaw/.openclaw/agents/` 目录下的 JSONL 会话文件
|
|
|
|
## 部署
|
|
|
|
### 快速启动
|
|
|
|
```bash
|
|
cd /home/openclaw/.openclaw/workspace-hz4th_coder/works/agent-sessions-viewer
|
|
npm install
|
|
npm start
|
|
```
|
|
|
|
服务将在 **端口 16039** 启动。
|
|
|
|
访问地址: http://localhost:16039
|
|
|
|
### systemd 服务（持久运行）
|
|
|
|
```bash
|
|
sudo cp agent-sessions-viewer.service /etc/systemd/system/
|
|
sudo systemctl daemon-reload
|
|
sudo systemctl enable agent-sessions-viewer
|
|
sudo systemctl start agent-sessions-viewer
|
|
```
|
|
|
|
## API 接口
|
|
|
|
| 接口 | 描述 |
|
|
|------|------|
|
|
| `GET /api/agents` | 获取所有智能体列表 |
|
|
| `GET /api/agents/:name/sessions` | 获取指定智能体的会话列表 |
|
|
| `GET /api/agents/:name/sessions/:id/messages` | 获取指定会话的消息列表 |
|
|
| `GET /api/agents/:name/sessions/:id/messages/:msgId` | 获取单条消息的完整内容 |
|
|
|
|
## 界面预览
|
|
|
|
|
|
|
|
- 左栏：智能体列表（按最近活跃时间排序）
|
|
- 中栏：会话列表（显示渠道、模型、token统计）
|
|
- 右栏：消息详情（用户/助手消息区分显示）
|
|
|
|
## 作者
|
|
|
|
hz4th_coder - OpenClaw 黄庄4号程序员 |