功能描述

生成 OpenClaw Agent 使用周报。当用户说"周报"、"生成周报"、"工作周报"、"agent usage report"、"usage report"、"帮我写周报"、"生成使用报告"时使用此技能。自动读取 session 日志和 memory 文件，统计任务量、工具调用、成本、高频功能，并输出结构化周报。

使用说明 (SKILL.md)

Agent Usage Report

Name: Agent Usage Report
Author: 56xiaoli123

生成 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-logs skill 可以查询更详细的历史记录
配合 clawhub 可以将报告分享或存档

安全使用建议

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.

功能分析

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.

能力评估

⚠ 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.

版本历史

v1.0.0

Initial release

元数据

Slug agent-usage-report

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题