← 返回 Skills 市场
133
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install message-tracker
功能描述
Python-based system for real-time collection, storage, search, and statistical analysis of Feishu channel messages with daemon support.
使用说明 (SKILL.md)
Message Tracker Skill
版本: v2.0 更新日期: 2026-05-01 状态: 正常运行
简介
message-tracker 是一个基于 Python 的消息追踪系统,支持飞书频道消息采集、存储、检索和统计分析。
目录结构
message-tracker/
├── SKILL.md # 本文件
├── track.py # v1版本追踪器
├── track_v2.py # v2版本追踪器(推荐)
└── .daemon.pid # 守护进程PID文件
核心功能
1. 消息采集
- 飞书频道消息实时采集
- 定时轮询采集模式
- 支持指定时间范围
2. 消息存储
- SQLite本地存储
- JSON格式导出
- 自动归档
3. 消息检索
- 按关键词搜索
- 按时间范围过滤
- 按发送人筛选
4. 统计分析
- 消息数量统计
- 活跃度分析
- 趋势图表
使用方式
启动守护进程
# 启动v2版本(推荐)
python3 message-tracker/track_v2.py start
# 启动v1版本
python3 message-tracker/track.py start
命令行操作
# 查看状态
python3 message-tracker/track_v2.py status
# 停止守护进程
python3 message-tracker/track_v2.py stop
# 重启守护进程
python3 message-tracker/track_v2.py restart
# 手动触发采集
python3 message-tracker/track_v2.py collect
# 搜索消息
python3 message-tracker/track_v2.py search "关键词"
# 导出消息
python3 message-tracker/track_v2.py export --days 7 --output messages.json
# 统计报告
python3 message-tracker/track_v2.py stats --days 30
守护进程管理
# 检查进程
cat message-tracker/.daemon.pid
# 查看日志
tail -f /root/.openclaw/logs/message-tracker.log
# 手动杀死进程
kill $(cat message-tracker/.daemon.pid)
配置说明
数据存储
- 数据库:
/root/.openclaw/workspace/memory/tracker/messages.db - 日志:
/root/.openclaw/logs/message-tracker.log - 导出:
/root/.openclaw/workspace/memory/tracker/exports/
采集间隔
- 默认:60秒
- 可通过配置调整
日志级别
- INFO: 正常日志
- WARNING: 警告
- ERROR: 错误
状态文件
| 文件 | 路径 | 说明 |
|---|---|---|
| PID文件 | message-tracker/.daemon.pid | 守护进程PID |
| 数据库 | memory/tracker/messages.db | 消息存储 |
| 日志 | logs/message-tracker.log | 运行日志 |
常见问题
Q: 守护进程意外退出?
A: 检查日志文件 /root/.openclaw/logs/message-tracker.log 排查原因,手动重启。
Q: 消息采集不到?
A:
- 检查飞书机器人Token是否有效
- 检查网络连接
- 查看错误日志
Q: 数据库太大?
A: 使用 track_v2.py export 导出后清理旧数据
版本说明
| 版本 | 文件 | 说明 |
|---|---|---|
| v1 | track.py | 早期版本 |
| v2 | track_v2.py | 当前主力版本,功能更完善 |
安全使用建议
Install only if you intentionally want a background Feishu message indexer. Before enabling it, fix the tracker-hook.sh argument-handling issue, verify Feishu credential scopes, restrict daemon socket access, and understand where collected messages are stored and how to purge them.
能力评估
Purpose & Capability
The Feishu collection, storage, search, export, and statistics features are coherent with the stated purpose, but they involve sensitive chat data.
Instruction Scope
tracker-hook.sh interpolates message fields and command arguments directly into generated Python source, creating a code-execution risk if those values are malformed or attacker-controlled.
Install Mechanism
There is no install spec, but the included scripts are user-run wrappers around Python daemons and /run lock/socket files; this is disclosed but should be reviewed before use.
Credentials
The code reads Feishu app credentials from the local OpenClaw config and writes message data into OpenClaw memory paths, which is purpose-aligned but not declared in the registry metadata.
Persistence & Privilege
The skill is designed to run as a background daemon with PID files, lock files, and a Unix socket; this is core to the skill but means collection can continue until explicitly stopped.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install message-tracker - 安装完成后,直接呼叫该 Skill 的名称或使用
/message-tracker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of message-tracker skill, version 1.0.0.
- Tracks messages from Feishu channels with support for real-time and scheduled collection.
- Features include local SQLite storage, JSON export, message search/filtering, and statistical analysis.
- Provides command-line tools to control the daemon process, manage data, and generate reports.
- Supports configuration for data storage, collection intervals, and logging.
- Includes troubleshooting tips and versioning information for multiple tracker versions.
元数据
常见问题
Message Tracker 是什么?
Python-based system for real-time collection, storage, search, and statistical analysis of Feishu channel messages with daemon support. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 133 次。
如何安装 Message Tracker?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install message-tracker」即可一键安装,无需额外配置。
Message Tracker 是免费的吗?
是的,Message Tracker 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Message Tracker 支持哪些平台?
Message Tracker 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Message Tracker?
由 wjl1004(@wjl1004)开发并维护,当前版本 v1.0.0。
推荐 Skills