Agent Task Logger

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

Security Scan

The skill's files and instructions match its stated purpose (recording agent task logs); it does not request credentials or download code, but you should be aware it will write logs to an autodetected workspace and can record command strings (which may contain secrets).

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.

Assessment

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.

Agent Task Logger - Agent 任务日志系统

一个类似 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 的工作空间位置，检测顺序：

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

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

记录任务开始

参数	必填	说明
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

⚠️ 注意事项

1. 日志文件权限：确保日志目录可写
2. 日志大小：建议定期归档，避免文件过大
3. 并发写入：支持多任务并发记录
4. 时间格式：使用 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 - 添加任务统计功能