← Back to Skills Marketplace
Agent Usage Report
by
56xiaoli123
· GitHub ↗
· v1.0.0
· MIT-0
65
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install agent-usage-report
Description
生成 OpenClaw Agent 使用周报。当用户说"周报"、"生成周报"、"工作周报"、"agent usage report"、"usage report"、"帮我写周报"、"生成使用报告"时使用此技能。自动读取 session 日志和 memory 文件，统计任务量、工具调用、成本、高频功能，并输出结构化周报。
README (SKILL.md)
Agent Usage Report
生成 OpenClaw Agent 的使用周报，包括运行数据、高频工具调用、memory 日志摘要。
快速使用
python3 \x3Cskill-path>/scripts/generate_report.py
默认输出上周（周一~周日）的统计数据。
参数选项
| 参数 | 说明 |
|---|---|
--start YYYY-MM-DD |
指定开始日期 |
--end YYYY-MM-DD |
指定结束日期 |
--workspace /path |
工作区路径（默认 ~/.openclaw/workspaces/bot6） |
--output file.txt |
保存到文件而不是打印 |
示例
# 默认上周周报
python3 \x3Cskill-path>/scripts/generate_report.py
# 指定日期范围
python3 \x3Cskill-path>/scripts/generate_report.py --start 2026-04-01 --end 2026-04-07
# 保存到文件
python3 \x3Cskill-path>/scripts/generate_report.py --output ~/weekly-report.txt
输出内容
- 运行数据概览 — session 数、消息数、工具调用数、成本
- 高频工具调用 TOP10 — 统计所有工具使用频次
- Memory 日志摘要 — 从
memory/目录提取本周记录片段 - 异常记录 — 待扩展（可从 session 错误日志中提取）
数据来源
- Session 日志：
~/.openclaw/agents/\x3CagentId>/sessions/*.jsonl - Memory 文件：
~/.openclaw/workspaces/bot6/memory/*.md
扩展周报内容
如果需要更完整的周报（风险记录、优化、下周计划），需要人工补充以下内容：
- 风险记录 — 本周遇到的具体问题
- 优化对策 — 解决方案和改进行动
- 下周计划 — 下一周的演进方向
这些内容建议由使用者根据实际使用场景补充到报告末尾。
配合其他技能
- 结合
session-logsskill 可以查询更详细的历史记录 - 配合
clawhub可以将报告分享或存档
Usage Guidance
This skill mostly matches its description (it reads OpenClaw session logs and workspace memory to build a report) and does not perform network I/O, but there are a few issues to consider before installing: 1) The script hard-codes AGENT_ID = "xiaotianmao" so it may read a different agent's sessions or none at all — verify and (preferably) modify the script to accept an agent-id parameter or derive it at runtime. 2) The script reads potentially sensitive session and memory files from ~/.openclaw; review those files so you understand what data would be included in reports. 3) Because the tool prints memory snippets, be careful if you plan to share generated reports externally. If you trust the source, consider patching the script to accept --agent or to use the provided --workspace path for session lookup, and run it in a safe environment first. If you do not trust the skill source, do not run it with access to real session/memory directories.
Capability Analysis
Type: OpenClaw Skill
Name: agent-usage-report
Version: 1.0.0
The skill is a utility for generating usage reports from OpenClaw session logs and memory files. The Python script (scripts/generate_report.py) uses standard libraries to parse local JSONL and Markdown files within the expected OpenClaw directory structure (~/.openclaw) and does not perform any network requests, command execution, or data exfiltration.
Capability Assessment
Purpose & Capability
The name/description (generate agent usage weekly report) matches the script's functionality (reads session logs and memory and summarizes them). However the script hard-codes AGENT_ID = "xiaotianmao" rather than using a runtime agentId or a CLI flag; this diverges from the SKILL.md which implies it will read the current agent's sessions. That mismatch can cause the tool to read the wrong agent's sessions or none at all, and is an incoherence between claimed purpose and actual code.
Instruction Scope
SKILL.md instructs running scripts/generate_report.py which reads files under ~/.openclaw/... (sessions/*.jsonl and workspace memory .md). That is within the described scope, but the script only accepts a --workspace option and does not allow overriding the AGENT_ID used to locate sessions. The script reads local logs and memory (sensitive data) and prints/outputs them; while expected for a reporting tool, this is sensitive I/O and should be noted. There are no steps that read unrelated system files, no external network calls, and no vague instructions granting broad discretionary data collection.
Install Mechanism
This is an instruction-only skill with an included Python script and no install spec; nothing is downloaded or executed beyond the provided script. That is low-risk from an install mechanism perspective.
Credentials
The skill requests no environment variables or credentials and only reads predictable local OpenClaw paths. This is proportionate for a reporting tool, but the script does access potentially sensitive session and memory files under the user's home directory—appropriate for the stated purpose but worth reviewing before granting access.
Persistence & Privilege
The skill is not forced-always and has no install actions that change agent configuration or grant persistent elevated privileges. Autonomous invocation is allowed by default but not by itself a red flag here.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install agent-usage-report - After installation, invoke the skill by name or use
/agent-usage-report - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release
Metadata
Frequently Asked Questions
What is Agent Usage Report?
生成 OpenClaw Agent 使用周报。当用户说"周报"、"生成周报"、"工作周报"、"agent usage report"、"usage report"、"帮我写周报"、"生成使用报告"时使用此技能。自动读取 session 日志和 memory 文件，统计任务量、工具调用、成本、高频功能，并输出结构化周报。 It is an AI Agent Skill for Claude Code / OpenClaw, with 65 downloads so far.
How do I install Agent Usage Report?
Run "/install agent-usage-report" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Agent Usage Report free?
Yes, Agent Usage Report is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Agent Usage Report support?
Agent Usage Report is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Agent Usage Report?
It is built and maintained by 56xiaoli123 (@56xiaoli123); the current version is v1.0.0.
More Skills