功能描述

实时记录和展示 Agent 任务执行进度，支持任务开始、命令执行、状态更新及错误日志的统一管理。

使用说明 (SKILL.md)

Agent Task Logger - Agent 任务日志系统

Name: Agent Task Logger
Author: gerald-luo

一个类似 Tomcat catalina.out 的实时任务日志系统，自动检测 Agent 工作空间，用于记录和展示 Agent 执行任务的进度。

🚀 快速使用

1. 初始化日志系统（自动检测工作空间）

初始化日志系统

2. 初始化日志系统（手动指定工作空间）

初始化日志系统 workspace=/path/to/workspace

2. 记录任务开始

记录任务开始 task-id=task-001 task-name="停止 Tomcat 8" estimated-time=5s

3. 记录执行命令

记录执行命令 task-id=task-001 command="cd /path && ./shutdown.sh"

4. 记录任务状态

记录任务状态 task-id=task-001 status="成功" actual-time=3.5s

5. 查看实时日志

tail -f /Users/openclaw/.openclaw/workspace/logs/agent-task.log

📋 参数说明

初始化日志系统

参数	必填	默认值	说明
`workspace`	❌	自动检测	工作空间根目录（可选，自动检测）
`log-dir`	❌	`logs`	日志目录（相对于 workspace）
`log-file`	❌	`agent-task.log`	日志文件名

工作空间自动检测

Skill 会自动检测 Agent 的工作空间位置，检测顺序：

WORKSPACE 环境变量
OPENCLAW_WORKSPACE 环境变量
脚本所在目录的父目录
~/.openclaw/workspace
当前目录

无需手动指定工作空间，开箱即用！

记录任务开始

参数	必填	说明
`task-id`	✅	任务唯一标识
`task-name`	✅	任务描述
`estimated-time`	❌	预估处理时间

记录执行命令

参数	必填	说明
`task-id`	✅	关联的任务 ID
`command`	✅	执行的 shell 命令

记录任务状态

参数	必填	说明
`task-id`	✅	关联的任务 ID
`status`	✅	任务状态（成功/失败/等待中）
`actual-time`	❌	实际处理时间

💡 触发词

初始化日志系统
记录任务开始
记录执行命令
记录任务状态
记录任务完成
记录错误信息
查看任务日志

📝 日志格式

参考 Tomcat catalina.out 格式，中文显示：

04-3 月 -2026 17:38:00.000 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 任务：停止 Tomcat 8
04-3 月 -2026 17:38:00.100 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 执行命令：cd /path && ./shutdown.sh
04-3 月 -2026 17:38:03.500 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 状态：Tomcat 8 关闭完成
04-3 月 -2026 17:38:03.600 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 预估时间：5 秒 | 实际时间：3.5 秒
04-3 月 -2026 17:38:03.700 INFO [agent-task-1] com.openclaw.agent.TaskExecutor.execute 结果：成功

🔧 使用示例

示例 1：完整任务流程（自动检测工作空间）

# 1. 初始化（自动检测工作空间）
初始化日志系统

# 2. 开始任务
记录任务开始 task-id=deploy-001 task-name="部署 Java 项目" estimated-time=60s

# 3. 执行命令
记录执行命令 task-id=deploy-001 command="mvn clean package"

# 4. 记录状态
记录任务状态 task-id=deploy-001 status="成功" actual-time=45s

# 5. 完成任务
记录任务完成 task-id=deploy-001

示例 2：多任务并行

# 任务 1：编译后端
记录任务开始 task-id=backend-compile task-name="编译后端项目" estimated-time=30s
记录执行命令 task-id=backend-compile command="mvn compile"
记录任务状态 task-id=backend-compile status="成功" actual-time=25s

# 任务 2：打包前端
记录任务开始 task-id=frontend-build task-name="打包前端项目" estimated-time=45s
记录执行命令 task-id=frontend-build command="npm run build"
记录任务状态 task-id=frontend-build status="成功" actual-time=40s

示例 3：错误处理

记录任务开始 task-id=deploy-app task-name="部署应用" estimated-time=30s
记录执行命令 task-id=deploy-app command="./deploy.sh"
记录错误信息 task-id=deploy-app error="权限不足，需要 sudo"
记录任务状态 task-id=deploy-app status="失败" actual-time=5s

📊 日志级别

级别	说明	使用场景
`INFO`	普通信息	任务开始、命令执行、状态更新
`WARN`	警告信息	非致命错误、性能警告
`ERROR`	错误信息	任务失败、异常
`DEBUG`	调试信息	详细调试输出

🛠️ 高级功能

查看任务统计

# 查看所有任务状态
grep "结果：" /Users/openclaw/.openclaw/workspace/logs/agent-task.log

# 查看失败任务
grep "结果：失败" /Users/openclaw/.openclaw/workspace/logs/agent-task.log

# 查看任务耗时
grep "实际时间：" /Users/openclaw/.openclaw/workspace/logs/agent-task.log

日志轮转

# 按日期归档日志
mv /Users/openclaw/.openclaw/workspace/logs/agent-task.log \
   /Users/openclaw/.openclaw/workspace/logs/agent-task-$(date +%Y%m%d).log

⚠️ 注意事项

日志文件权限：确保日志目录可写
日志大小：建议定期归档，避免文件过大
并发写入：支持多任务并发记录
时间格式：使用 24 小时制，精确到毫秒

📁 文件结构

workspace/
├── logs/
│   ├── agent-task.log          # 主日志文件
│   ├── agent-task-20260304.log # 归档日志
│   └── ...
└── skills/
    └── agent-task-logger/
        ├── SKILL.md            # 技能说明
        └── scripts/
            └── logger.sh       # 日志工具脚本

🔄 更新日志

v1.0 - 初始版本，支持基本任务记录
v1.1 - 添加中文支持
v1.2 - 添加任务统计功能

安全使用建议

This skill appears to be what it says: a local logger implemented in bash that writes to a logs directory under an autodetected workspace. Before installing, consider: 1) Where will logs be written? Verify WORKSPACE / OPENCLAW_WORKSPACE or run init with an explicit workspace to avoid unexpected locations. 2) Sensitive data: do not pass passwords, tokens, or other secrets as part of command strings or arguments — those will be appended to the log file. 3) Permissions and retention: set restrictive filesystem permissions on the logs directory and implement rotation/archiving to avoid large files and unwanted exposure. 4) Review the included scripts/logger.sh (already present) yourself or in your CI to confirm behavior. 5) If you want to limit risk, restrict who/what can invoke the skill or sanitize inputs before logging.

功能分析

Type: OpenClaw Skill Name: agent-task-logger Version: 1.3.0 The `scripts/logger.sh` skill is vulnerable to arbitrary file write/append. The `init` function allows an unsanitized `workspace` path, and the `LOG_FILE` can be overridden via an environment variable. User-controlled log content (e.g., `task_name`, `command`) is then appended to the resulting `$LOG_PATH`. An attacker could exploit this by setting `workspace` to a sensitive directory (e.g., `/etc`) and `LOG_FILE` to a sensitive file (e.g., `passwd`, `crontab`, `~/.ssh/authorized_keys`), then using logging functions to write arbitrary content, potentially leading to privilege escalation or backdoor creation. This is a critical vulnerability due to lack of input sanitization, not intentional malice.

能力评估

✓ Purpose & Capability

Name/description, README, SKILL.md and the included scripts/logger.sh all implement a local task-logging tool: detecting a workspace, creating a logs directory, and appending formatted log lines. The requested capabilities are proportionate to the stated purpose.

ℹ Instruction Scope

SKILL.md and the script instruct the agent to initialize the logger, record task start/commands/status/errors, and tail logs. The skill logs the command strings provided (it does not execute those commands), which is appropriate for a logger, but means any sensitive data passed as part of command arguments will be written to disk. The runtime instructions also reference environment variables and filesystem paths used for detection and examples (including an absolute example path).

✓ Install Mechanism

This is an instruction-only skill with an included bash script; there is no remote download or install step. No third-party packages are pulled in, so installation risk is low.

ℹ Credentials

The skill does not request credentials or declare required environment variables in registry metadata, but it does read WORKSPACE, OPENCLAW_WORKSPACE and LOG_FILE (for workspace detection and log file name). These env vars are reasonable for configuring a logger, but they are referenced in the SKILL.md/script even though none were declared as required in the metadata.

✓ Persistence & Privilege

The skill writes log files under the detected workspace and does not request elevated privileges or modify other skills/system-wide configs. always:false (no forced global inclusion). Note: the platform default allows autonomous invocation; combined with logging capabilities this only increases the risk that secrets could be logged if the agent is asked to record them.

版本历史

v1.3.0

v1.3: 添加工作空间自动检测功能，无需手动指定 workspace 参数

v1.2.0

agent-task-logger 1.2.0 - Added task statistics features (查看任务统计), enabling users to analyze task status, failures, and durations via log filtering. - Documentation updates with advanced usage examples for log statistics and log rotation. - Clarified usage scenarios, parameter details, and log format in Chinese and English. - Improved explanations for concurrent logging and log file management.

元数据

Slug agent-task-logger

版本 1.3.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 2

常见问题

Agent Task Logger 是什么？

实时记录和展示 Agent 任务执行进度，支持任务开始、命令执行、状态更新及错误日志的统一管理。它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 449 次。

如何安装 Agent Task Logger？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install agent-task-logger」即可一键安装，无需额外配置。

Agent Task Logger 是免费的吗？

是的，Agent Task Logger 完全免费（开源免费），可自由下载、安装和使用。

Agent Task Logger 支持哪些平台？

Agent Task Logger 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Agent Task Logger？

由 Gerald Luo（@gerald-luo）开发并维护，当前版本 v1.3.0。

Agent Task Logger