← All skills
Tencent SkillHub · Developer Tools

长任务监控方案。实现 Worker-Monitor 架构,Monitor 通过 hook-logger 日志监控 Worker 状态,每轮 10 分钟通过 Announce 汇报。采用主会话轮询机制(因子代理 sessions_send 限制)。推荐 OpenClaw 2.21+。触发词:长任务、监控任务、任务监控

长任务监控方案 V2。实现 Worker-Monitor 架构,Monitor 通过 hook-logger 日志监控 Worker 状态,每轮 10 分钟通过 Announce 汇报。采用主会话轮询机制(因子代理 sessions_send 限制)。推荐 OpenClaw 2.21+。触发词:长任务、监控任务、...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

长任务监控方案 V2。实现 Worker-Monitor 架构,Monitor 通过 hook-logger 日志监控 Worker 状态,每轮 10 分钟通过 Announce 汇报。采用主会话轮询机制(因子代理 sessions_send 限制)。推荐 OpenClaw 2.21+。触发词:长任务、监控任务、...

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Known item issue.

This item's current download entry is known to bounce back to a listing or homepage instead of returning a package file.

Quick setup
  1. Open the source page and confirm the package flow manually.
  2. Review SKILL.md if you can obtain the files.
  3. Treat this source as manual setup until the download is verified.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Manual review
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
_meta.json, CHANGELOG.md, long-task-monitor-plan.md, long-task.js, monitor-prompt.txt, SKILL.md

Validation

  • Open the source listing and confirm there is a real package or setup artifact available.
  • Review SKILL.md before asking your agent to continue.
  • Treat this source as manual setup until the upstream download flow is fixed.

Install with your agent

Agent handoff

Use the source page and any available docs to guide the install because the item currently does not return a direct package file.

  1. Open the source page via Open source listing.
  2. If you can obtain the package, extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the source page and extracted files.
New install

I tried to install a skill package from Yavira, but the item currently does not return a direct package file. Inspect the source page and any extracted docs, then tell me what you can confirm and any manual steps still required.

Upgrade existing

I tried to upgrade a skill package from Yavira, but the item currently does not return a direct package file. Compare the source page and any extracted docs with my current installation, then summarize what changed and what manual follow-up I still need.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.3

Documentation

ClawHub primary doc Primary doc: SKILL.md 18 sections Open source page

功能

实现长任务监控方案(V2): 创建 Worker 执行长任务 创建 Monitor 监控 Worker 状态(每轮 10 分钟) 主会话轮询处理 Monitor 汇报 任务完成时自动清理 Worker/Monitor sessions

English Description

Long-running task monitoring solution (V2). Implements Worker-Monitor architecture: Monitor tracks Worker status via hook-logger logs, reports to main session every 10 minutes via Announce. Uses main session polling mechanism due to subagent sessions_send limitation. Recommended for OpenClaw v2.21+. Note: This skill is primarily designed for Chinese users, but the monitor/worker mechanism can be implemented independently by referring to long-task-monitor-plan.md in the skill folder. Trigger: "长任务", "监控任务", "任务监控"

1. 安装 hook-logger 插件

本方案依赖 hook-logger 插件读取 Worker 状态,必须先安装: # 安装 hook-logger 插件 openclaw plugins install @scotthuang/hook-logger # 或手动安装 cd ~/.openclaw/extensions/hook-logger npm install 注意:确保 hook-logger 已更新到支持 sessionKey 记录的版本(用于过滤特定 Worker 的日志)。

2. 无需额外权限配置

Monitor → 主会话:Announce(自动) 主会话 → Worker:sessions_send(parent→child 默认允许)

启动长任务流程

# 1. 创建任务 node ~/.openclaw/workspace/skills/long-task-monitor/long-task.js start "任务描述" "worker命令" # 2. 启动 Worker(获取 session key 后) sessions_spawn(task="...", label="worker-xxx", cleanup="keep") # 3. 更新 Worker Session Key node long-task.js update <task_id> worker "<sessionKey>" # 4. 启动 Monitor sessions_spawn(task="...", label="monitor-xxx", cleanup="delete") # 5. 更新 Monitor Session Key node long-task.js update <task_id> monitor "<sessionKey>" # 6. 任务完成时手动清理 node long-task.js complete <task_id> "结果描述"

快捷命令

# 创建任务 node long-task.js start "描述" "worker任务" # 更新 Worker Session Key node long-task.js update <task_id> worker "<sessionKey>" # 更新 Monitor Session Key node long-task.js update <task_id> monitor "<sessionKey>" # 生成 Worker 启动命令 node long-task.js worker-command <task_id> "worker任务" # 生成 Monitor 启动命令 node long-task.js monitor-command <task_id> <worker_session_key> 1 # 标记任务完成并清理 sessions node long-task.js complete <task_id> "结果描述" # 查看任务状态 node long-task.js status

任务文件夹结构

~/.openclaw/workspace/long-tasks/<task-id>/ ├── task.json # 任务信息(包含 workerSessionKey, monitorSessionKey) ├── status.json # 最终状态(完成后) └── monitor-rounds/ # Monitor 轮次记录 ├── current-round.json # 当前轮次记录 └── round-1.json # 第一轮记录

task.json 字段说明

{ "taskId": "task-xxx", "description": "任务描述", "workerTask": "pip install torch", "workerSessionKey": "agent:main:subagent:xxx", "monitorSessionKey": "agent:main:subagent:yyy", "createdAt": "2026-02-22T10:00:00Z", "status": "running", "monitorRound": 1, "workerRestartCount": 0 }

Monitor 行为

定期记录 - 写入 monitor-rounds/current-round.json(注:实际取决于执行频率) 10 分钟到 - Announce 返回结果 检测完成 - 发现 Worker agent_end 事件时返回 检测挂掉 - 超过 5 分钟无日志时返回

轮询逻辑

轮次行为1-5自动继续下一轮监控6+询问用户是否继续

1. 任务完成时需要手动清理

当前版本需要手动执行 complete 命令清理 sessions: node long-task.js complete <task_id> "结果描述"

2. Monitor 轮次日志

Monitor 尝试每分钟记录状态,但实际频率取决于 Worker 执行速度。如果 Worker 执行很快,可能只记录 1-2 次。

3. Session Key 更新

spawn Worker/Monitor 后,必须手动更新 task.json: 获取 Worker Session Key → 更新 获取 Monitor Session Key → 更新

4. 任务完成判断

Monitor 会检测 agent_end 事件判断 Worker 是否完成 如果 Worker 已完成,Monitor 会返回"已完成"状态 主会话收到后需要手动执行 complete 清理

已知限制

complete 命令有 bug - 当前版本可能报 ReferenceError,需手动清理 sessions 无法自动检测 Worker 完成 - 需要等待 Monitor 下一轮汇报 Session Key 需要手动更新 - 无法自动获取

发布更新

如果修改了 skill: cd ~/.openclaw/workspace/skills/long-task-monitor # 未来如有 npm 包需求

⚠️ 安全说明

本 skill 已做安全加固: 使用 execFile + 参数数组防止命令注入 所有用户输入经过过滤(只允许安全字符,包含 : 用于 session keys) 依赖 hook-logger 插件,请确保来源可信

⚠️ 已知限制

Monitor Agent 需要使用 exec 工具执行 shell 命令(写入监控日志),这是架构固有限制 Session Key 必须包含 : 字符(如 agent:main:subagent:xxx),已修复过滤函数允许此字符

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
3 Docs1 Scripts1 Config1 Files
  • SKILL.md Primary doc
  • CHANGELOG.md Docs
  • long-task-monitor-plan.md Docs
  • long-task.js Scripts
  • _meta.json Config
  • monitor-prompt.txt Files