Today Task
v1.0.17通用任务结果推送器,当任务完成后将结果推送到负一屏。使用统一的标准数据格式,支持各种类型的任务结果推送。
运行时依赖
安装命令
点击复制技能文档
Today Task 技能概述
这是一个通用的任务结果推送器,专门用于在任务完成后将结果推送到负一屏。使用统一的标准数据格式,支持各种类型的任务结果推送。
🚀 使用方式(模型必读) 第一步:执行任务推送(只支持 JSON 输入(确保格式完整)) # 1. 创建JSON文件 { "task_name": "任务名称", "task_content": "# Markdown内容", "task_结果": "完成状态" }
# 2. 推送 python scripts/task_push.py --data task.json
快速创建工具 # 从markdown文件创建JSON python scripts/创建_task_json.py "任务名称" content.md # 输出:已创建 任务名称_20260402.json
为什么? ✅ JSON 确保 markdown 格式 100%保留 ✅ 避免命令行编码和转义问题 ✅ 使用更简单可靠
注意:不再支持--name、--content等命令行参数。
第二步:推送成功后自动检查技能更新 python scripts/更新_检查er.py
更新检查策略:
配置未开启更新检查:静默跳过,不提示用户 时间间隔未满足:静默跳过,不提示用户 版本是最新的:静默跳过,不提示用户 只有以下情况会提示用户: 发现新版本可用:显示更新通知和更新命令 更新检查异常:网络问题、ClawHub 服务异常等,显示错误信息 第三步:在对话中整合显示结果
使用 JSON 推送成功 + 有更新时:
✅ 任务推送成功!
🔄 技能更新检查: 发现新版本可用! 当前版本: {当前版本} 最新版本: {最新版本}
💡 更新命令: ClawHub 更新 today-task
使用 JSON 推送成功 + 无更新/无需检查时:
✅ 任务推送成功! (技能更新检查:配置未开启/时间间隔未满足/已是最新版本,无需提示)
使用 JSON 推送成功 + 更新检查异常时:
✅ 任务推送成功! ⚠️ 更新检查异常:无法从ClawHub获取版本信息,请检查网络或稍后重试
推送失败时:
❌ 任务推送失败! {错误信息}
关键要求: 只使用 JSON 输入:必须通过 JSON 文件推送,确保 markdown 格式完整保留 智能更新检查:只在必要时提示用户(有更新或检查异常) 减少干扰:配置未开启、时间间隔未满足、版本最新时不提示 结果整合显示:将推送结果和更新检查结果一起在对话中回复 异常处理:更新检查异常时给出明确提示 给出具体命令:如果有更新,必须显示 ClawHub 更新 today-task 🔒 安全说明
本技能已通过安全审查,不包含恶意代码。除可选的技能更新检查外,所有网络请求仅发送到用户配置的指定 URL。更新检查会联系 ClawHub 服务获取版本信息。
⚠️ 重要安全提示
本技能会传输以下数据到配置的端点:
授权码 (authCode):用于服务认证的敏感令牌 任务内容 (task_content):您输入的任务文本内容 任务元数据:任务名称、ID、时间戳、执行结果等 🔐 安全特性 HTTPS 加密传输:所有数据通过 TLS 加密传输 本地日志脱敏:敏感信息在日志中显示为 ABC 格式 用户完全控制:可配置自定义端点,控制数据流向
详细安全声明请查看 SECURITY.md。
⚙️ 配置要求(必需)
本技能需要以下配置才能正常工作:
- 授权码 (authCode) - 必需
- 推送 URL (push服务Url) - 必需
本技能使用混合配置系统,支持灵活的配置优先级:
⚠️ 重要安全说明 数据传输透明度
使用本技能时,您的数据将被发送到配置的推送端点:
- 默认端点(如果使用默认配置)
服务提供商:华为云(Huawei Cloud) 地理位置:中国东莞(DRCN = Dongguan) 数据传输:通过 HTTPS 加密传输
- 传输的数据包括:
- 隐私建议:
# 设置推送URL OpenClaw config 设置 技能s.entries.today-task.config.push服务Url YOUR_PUSH_URL
# 查看技能配置 OpenClaw config 获取 技能s.entries.today-task
# 删除配置 OpenClaw config un设置 技能s.entries.today-task.config.authCode OpenClaw config un设置 技能s.entries.today-task.config.push服务Url
本地配置文件 (config.json)
其他配置项在技能目录的 config.json 文件中设置:
{ "timeout": 30, "max_content_length": 5000, "auto_生成_id": true, "default_结果": "任务已完成", "记录_level": "信息", "save_records": true, "records_dir": "push_records", "max_records": 100, "push服务Url": "https://hiboard-claw-drcn.AI.dbankcloud.cn/distribution/message/cloud/claw/msg/上传" }
注意:如果缺少必需的授权码或推送 URL 配置,技能将无法正常工作并会显示明确的错误信息。
💾 数据存储说明
本技能会在本地创建以下目录用于运行记录:
📁 日志目录 (记录s/) 用途:运行监控和故障排查 内容:包含脱敏的运行信息(授权码显示为 Twe7 格式) 控制:通过 记录_level 配置项控制详细程度 📁 推送记录目录 (push_records/) 用途:历史记录和审计追踪 内容:任务推送响应数据 控制: 通过 save_records 配置项控制是否保存(默认:true) 通过 max_records 配置项控制最大记录数(默认:100) 通过 records_dir 配置项指定目录位置 🔐 隐私保护措施 敏感信息脱敏:授权码等敏感信息在日志中仅显示部分字符 用户完全控制:可关闭记录保存功能 本地存储:所有文件仅存储在用户本地设备 定期清理:建议定期清理或通过配置限制文件数量
用户责任:请定期检查和管理这些本地文件,确保符合您的隐私要求。
🎯 设计理念 统一格式:使用标准化的数据格式,不区分任务类型 简单直接:专注于任务结果的格式化和推送 灵活通用:支持任何类型的任务结果 易于集成:提供简单的 API 接口 📋 触发条件 "任务完成,推送到负一屏" "推送任务结果" "发送到负一屏" 任何任务完成后需要推送结果到负一屏的场景 🔄 工作流程 版本检查:自动检查技能更新,输出版本信息(如有更新会通知) 任务完成:其他技能或任务执行完成 结果收集:收集任务执行结果数据 格式转换:将任务结果转换为标准格式 数据验证:验证数据完整性和格式 执行推送:推送到负一屏系统 结果反馈:返回推送状态和记录,包含版本更新信息 📊 标准数据格式 推送数据格式 { "authCode": "string", // 授权码,负一屏上对OpenClaw进行账号关联之后生成的授权码 "msgContent": [ // MsgContent数组,消息内容 { "scheduleTaskId": "string", // 任务ID,必填,对于周期性任务此ID需要保持一致 "scheduleTaskName": "string", // 任务名称,必填,如"生成日报任务、生成新闻任务" "summary": "string", // 任务摘要,必填,说明具体是什么任务,以及任务的执行状态,比如 "生成新闻早报任务已完成"、"生成新闻早报任务异常" "结果": "string", // 任务执行结果,必填,说明是已成功完成了,还是异常中断了 "content": "string", // 任务的执行结果具体内容,markdown格式的长文本数据,必填 "source": "string", // 来源,人工是OpenClaw的任务,则值为OpenClaw,必填 "taskFinishTime": "number" // 任务完成的时间戳,秒的时间戳,必填 } ] } }
⏰ 时间戳使用指南 重要提醒
避免使用错误的时间戳获取方式,这可能导致推送时间显示不正确!
❌ 错误方式(不要使用) # PowerShell 中的错误方式(可能产生时区问题) [int][double]::解析((获取-Date -U格式化 %s)) int
✅ 正确方式 Python(本技能使用的方式) 导入 time timestamp = int(time.time()) # UTC 时间戳,推荐使用
PowerShell(其他脚本中使用) # 正确!使用 UTC 时间,避免时区问题 $times