一个供 AI 智能体在长时间运行的操作期间，提供手动和自动定期状态更新的通信框架。
安装与下载
1. ClawHub CLI
从源直接安装技能的最快方式。
npx clawhub@latest install task-status
2. 手动安装
将技能文件夹复制到以下位置之一
~/.openclaw/skills/ <project>/skills/ 优先级：工作区 > 本地 > 内置
3. 提示词安装
将此提示词复制到 OpenClaw 即可自动安装。
请帮我使用 Clawhub 安装 task-status。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
更倾向于下载？
获取包含原生技能文件的ZIP压缩包。
什么是 任务状态？
Task Status 技能是开发者在 Openclaw Skills 生态系统中构建复杂工作流的重要组件。它为 AI 智能体提供了必要的工具，以便将简短且具有描述性的状态消息发回用户聊天界面，确保多步骤操作期间的透明度。通过支持手动里程碑和自动定期心跳，它能防止用户在长时间后台处理过程中产生断连感。
该技能对于超过 30 秒的任务特别有效，在这类任务中，需要定期反馈以确认智能体仍处于活动状态并正在执行其逻辑。无论您是进行数据迁移、视频处理还是复杂的 API 同步，Task Status 都能确保从进度到最终成功或失败的每个状态都得到清晰的沟通。
任务状态 应用场景
- 为长时间运行的数据处理任务每 5 秒提供一次心跳更新。
- 在多阶段部署流水线中通知用户具体的里程碑进度。
- 当后台进程遇到非致命问题时，呈现具体的错误消息或警告。
- 使用具体的状态描述跟踪文件上传或下载的进度。
任务状态 工作原理
- AI 智能体启动任务并调用
monitor_task.py脚本以开始后台心跳。 - 监控脚本每 5 秒自动向聊天界面发送一次“仍在处理中...”的状态更新。
- 当智能体达到特定里程碑时，它使用
send_status.py提供详细的手动进度更新。 - 如果任务失败，智能体会发送包含特定诊断信息的错误状态。
- 完成后，智能体在监控器上调用停止命令，发送最终成功消息并终止后台进程。
任务状态 配置指南
要将其集成到您的工作流中，请将 task-status 文件夹复制到您的本地安装目录：
# 标准安装路径
C:\Users\Luffy\AppData\Roaming\npm\node_modules\clawdbot\skills\task-status
复制完成后，请确保您的 AGENTS.md 或 TOOLS.md 引用了该技能目录，以便 Python 脚本可供执行。
任务状态 数据架构与分类体系
该技能使用以下参数和视觉指示器组织状态信息：
| 状态类型 | 图标 | 使用场景 |
|---|---|---|
| progress | 🔄 | 正在进行的后台工作或活动处理 |
| success | ✅ | 任务完成的最终确认 |
| error | ❌ | 由于失败或异常导致的任务终止 |
| warning | ⚠️ | 遇到但不停止任务的问题 |
所有消息应保持在 140 个字符以内，以确保在 Openclaw Skills 界面中的可读性。
任务状态 高级特性
- 具有可自定义间隔（默认为 5 秒）的后台监控。
- 直接支持 Python 库，用于将状态函数导入自定义智能体脚本。
- 与 Clawdbot cron 集成，实现自动化的定时状态检查。
- 支持使用
--details标志附加详细元数据，以便高级用户进行调试。
SKILL.md
加载中
Openclaw 相关技能
精选*
