push-task-to-negative-screen OpenClaw Skill
通用任务结果推送器,当任务完成后将结果推送到负一屏。使用统一的标准数据格式,支持各种类型的任务结果推送。
Installation
clawhub install push-task-to-negative-screen
Requires npm i -g clawhub
131
Downloads
0
Stars
0
current installs
0 all-time
12
Versions
Today Task
技能概述
这是一个通用的任务结果推送器,专门用于在任务完成后将结果推送到负一屏。使用统一的标准数据格式,支持各种类型的任务结果推送。
🚀 使用方式(模型必读)
第一步:执行任务推送(只支持 JSON 输入(确保格式完整))
# 1. 创建JSON文件
{
"task_name": "任务名称",
"task_content": "# Markdown内容",
"task_result": "完成状态"
}
# 2. 推送
python scripts/task_push.py --data task.json
快速创建工具
# 从markdown文件创建JSON
python scripts/create_task_json.py "任务名称" content.md
# 输出:已创建 任务名称_20260402.json
为什么?
- ✅ JSON 确保 markdown 格式 100%保留
- ✅ 避免命令行编码和转义问题
- ✅ 使用更简单可靠
注意:不再支持--name、--content等命令行参数。
第二步:推送成功后自动检查技能更新
python scripts/update_checker.py
更新检查策略:
- 配置未开启更新检查:静默跳过,不提示用户
- 时间间隔未满足:静默跳过,不提示用户
- 版本是最新的:静默跳过,不提示用户
- 只有以下情况会提示用户:
- 发现新版本可用:显示更新通知和更新命令
- 更新检查异常:网络问题、ClawHub 服务异常等,显示错误信息
第三步:在对话中整合显示结果
使用 JSON 推送成功 + 有更新时:
✅ 任务推送成功!
🔄 技能更新检查:
发现新版本可用!
当前版本: {当前版本}
最新版本: {最新版本}
💡 更新命令: `clawhub update today-task`
使用 JSON 推送成功 + 无更新/无需检查时:
✅ 任务推送成功!
(技能更新检查:配置未开启/时间间隔未满足/已是最新版本,无需提示)
使用 JSON 推送成功 + 更新检查异常时:
✅ 任务推送成功!
⚠️ 更新检查异常:无法从ClawHub获取版本信息,请检查网络或稍后重试
推送失败时:
❌ 任务推送失败!
{错误信息}
关键要求:
- 只使用 JSON 输入:必须通过 JSON 文件推送,确保 markdown 格式完整保留
- 智能更新检查:只在必要时提示用户(有更新或检查异常)
- 减少干扰:配置未开启、时间间隔未满足、版本最新时不提示
- 结果整合显示:将推送结果和更新检查结果一起在对话中回复
- 异常处理:更新检查异常时给出明确提示
- 给出具体命令:如果有更新,必须显示
clawhub update today-task
🔒 安全说明
本技能已通过安全审查,不包含恶意代码。除可选的技能更新检查外,所有网络请求仅发送到用户配置的指定 URL。更新检查会联系 ClawHub 服务获取版本信息。
⚠️ 重要安全提示
本技能会传输以下数据到配置的端点:
- 授权码 (authCode):用于服务认证的敏感令牌
- 任务内容 (task_content):您输入的任务文本内容
- 任务元数据:任务名称、ID、时间戳、执行结果等
🔐 安全特性
- HTTPS 加密传输:所有数据通过 TLS 加密传输
- 本地日志脱敏:敏感信息在日志中显示为
ABC***格式 - 用户完全控制:可配置自定义端点,控制数据流向
详细安全声明请查看 SECURITY.md。
⚙️ 配置要求(必需)
本技能需要以下配置才能正常工作:
1. 授权码 (authCode) - 必需
- 用途:用于身份验证,确保只有授权用户可以向负一屏推送内容
- 安全重要性:授权码是敏感令牌,会通过网络传输到配置的端点
- 获取方式:
先从从 OpenClaw 全局配置中获取,使用命令 openclaw config get skills.entries.today-task.config.authCode。
如果不存在则提示用户按如下步骤获取:- 从手机桌面右滑进入负一屏
- 点击左上角头像
- 进入"我的"页面,点击右上角设置图标
- 选择"动态管理"
- 点击"关联账号"
- 找到"Claw 智能体"并点击获取授权码
⚠️ 授权码安全警告
- 授权码会通过网络传输:作为 HTTP 请求的一部分发送到配置的端点
- 不要在聊天中粘贴授权码:避免授权码被记录在聊天历史中
- 使用安全配置方式:推荐使用 OpenClaw 全局配置或本地配置文件
- 定期更新授权码:增强安全性,防止未授权访问
2. 推送 URL (pushServiceUrl) - 必需
- 用途:指定推送服务的目标地址
- 获取方式:从config.json 中获取
- 默认值:
https://hiboard-claw-drcn.ai.dbankcloud.cn/distribution/message/cloud/claw/msg/upload
🔧 配置方式
本技能使用混合配置系统,支持灵活的配置优先级:
⚠️ 重要安全说明
数据传输透明度
使用本技能时,您的数据将被发送到配置的推送端点:
1. 默认端点(如果使用默认配置)
https://hiboard-claw-drcn.ai.dbankcloud.cn/distribution/message/cloud/claw/msg/upload
- 服务提供商:华为云(Huawei Cloud)
- 地理位置:中国东莞(DRCN = Dongguan)
- 数据传输:通过 HTTPS 加密传输
2. 传输的数据包括:
- 授权码 (
authCode):用于服务认证的令牌 - 任务内容 (
task_content):您输入的任务文本内容 - 任务元数据:任务名称、ID、时间戳、执行结果等
3. 隐私建议:
- 避免在任务内容中包含高度敏感的个人信息
- 了解数据发送的目的地
- 可以配置自定义端点以控制数据流向
配置优先级规则
- 优先使用 OpenClaw 全局配置
- 如果没有设置,则使用本地 config.json 中的配置
- 如果都没有设置,技能将无法正常工作
OpenClaw 全局配置命令
# 设置授权码
openclaw config set skills.entries.today-task.config.authCode YOUR_AUTH_CODE
# 设置推送URL
openclaw config set skills.entries.today-task.config.pushServiceUrl YOUR_PUSH_URL
# 查看技能配置
openclaw config get skills.entries.today-task
# 删除配置
openclaw config unset skills.entries.today-task.config.authCode
openclaw config unset skills.entries.today-task.config.pushServiceUrl
本地配置文件 (config.json)
其他配置项在技能目录的 config.json 文件中设置:
{
"timeout": 30,
"max_content_length": 5000,
"auto_generate_id": true,
"default_result": "任务已完成",
"log_level": "INFO",
"save_records": true,
"records_dir": "push_records",
"max_records": 100,
"pushServiceUrl": "https://hiboard-claw-drcn.ai.dbankcloud.cn/distribution/message/cloud/claw/msg/upload"
}
注意:如果缺少必需的授权码或推送 URL 配置,技能将无法正常工作并会显示明确的错误信息。
💾 数据存储说明
本技能会在本地创建以下目录用于运行记录:
📁 日志目录 (logs/)
- 用途:运行监控和故障排查
- 内容:包含脱敏的运行信息(授权码显示为
Twe7***格式) - 控制:通过
log_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", // 任务摘要,必填,说明具体是什么任务,以及任务的执行状态,比如 "生成新闻早报任务已完成"、"生成新闻早报任务异常"
"result": "string", // 任务执行结果,必填,说明是已成功完成了,还是异常中断了
"content": "string", // 任务的执行结果具体内容,markdown格式的长文本数据,必填
"source": "string", // 来源,人工是openclaw的任务,则值为OpenClaw,必填
"taskFinishTime": "number" // 任务完成的时间戳,秒的时间戳,必填
}
]
}
}
⏰ 时间戳使用指南
重要提醒
避免使用错误的时间戳获取方式,这可能导致推送时间显示不正确!
❌ 错误方式(不要使用)
# PowerShell 中的错误方式(可能产生时区问题)
[int][double]::Parse((Get-Date -UFormat %s))
[int](Get-Date -UFormat %s)
✅ 正确方式
Python(本技能使用的方式)
import time
timestamp = int(time.time()) # UTC 时间戳,推荐使用
PowerShell(其他脚本中使用)
# 正确!使用 UTC 时间,避免时区问题
$timestamp = [DateTimeOffset]::UtcNow.ToUnixTimeSeconds()
##### PowerShell需要设置控制台编码为UTF-8
```powershell
# 正确设置控制台编码为UTF-8
chcp 65001
本技能的时间戳处理
本技能自动处理时间戳:
- 使用 Python 的
time.time()获取 UTC 时间戳 - 自动验证时间戳合理性
- 确保与负一屏服务时间一致
时区说明
- 负一屏服务使用 UTC 时间戳
- 本地时间可能因时区设置不同而产生误差
- 始终使用 UTC 时间 避免时区问题
- 中国时区(UTC+8)的用户需要注意时间转换
验证时间戳
如果你在其他脚本中集成本技能,请验证时间戳:
# 验证时间戳是否在合理范围内
import time
def validate_timestamp(timestamp):
min_valid = 1609459200 # 2021-01-01
max_valid = int(time.time()) + 31536000 # 当前时间 + 1年
return min_valid <= timestamp <= max_valid
# 使用示例
current_ts = int(time.time())
if validate_timestamp(current_ts):
print(f"时间戳有效: {current_ts}")
else:
print(f"时间戳可能有问题: {current_ts}")
常见问题
- 时间显示不对:检查是否使用了本地时间而非 UTC 时间
- 时间戳为 0 或负数:时间戳获取方式错误
- 时间差 8 小时:中国时区(UTC+8)未正确转换
最佳实践
- 统一使用 UTC 时间:所有时间戳都使用 UTC
- 验证时间戳:在关键操作前验证时间戳有效性
- 记录时间源:明确记录时间戳的来源和时区
- 使用本技能的工具:本技能已正确处理时间戳,无需额外处理
内容格式规范
任务的执行结果具体内容使用 markdown 格式,遵循以下样式规范:
主标题文本
- font size: Subtitle_L (Bold) = 18
- color: font_primary = #000000 90%
- 行高:默认
一级文本
- font size: Body_L (Bold) = 16
- color: font_primary = #000000 90%
- 行高:22
二级文本
- font size: Body_M (Bold) = 14
- color: font_primary = #000000 90%
- 行高:22
段落文本
- font size: Body_M (regular) = 14
- color: font_secondary = #000000 60%
- 行高:22
分割线
- 使用控件:Divider
AI 生成注释文本
- font size: 10 medium
- color: font_fourth #000000 20%
- 行高:默认
📁 输入要求
任务结果数据格式
{
"task_id": "string", // 任务ID(必填)
"task_name": "string", // 任务名称(必填)
"task_result": "string", // 任务执行结果描述(必填)
"task_content": "string", // 任务详细内容,markdown格式(必填)
"schedule_task_id": "string", // 周期性任务ID(必填,非周期性任务时等于task_id)
"auth_code": "string" // 授权码(可选,可在配置中设置)
}
简化输入格式
// 格式1:完整格式
{
"task_id": "news_20240327_1001",
"task_name": "今日新闻汇总",
"task_result": "任务已完成",
"task_content": "# 今日新闻汇总\n\n## 热点新闻\n\n1. OpenAI发布新一代模型...",
"schedule_task_id": "news_20240327_1001",
"auth_code": "asdf166553"
}
🛠️ 推送流程
- 数据接收:接收任务结果数据
- 格式标准化:转换为标准 pushData 格式
- 数据验证:验证必需字段
- 授权码处理:使用配置的授权码或数据中的授权码
- 推送执行:调用负一屏 API 推送数据
- 结果处理:处理推送结果并保存记录
📝 输出格式
成功响应
{
"success": true,
"message": "任务结果推送成功",
"task_id": "news_20240327_1001",
"task_name": "今日新闻汇总",
"push_time": "2024-03-27 10:15:30",
"record_id": "push_20240327_101530",
"hiboard_response": {
"code": "0000000000",
"desc": "成功"
},
"update_check": {
// 版本更新检查
"status": "skipped_or_error",
"message": "更新检查异常或配置未开启",
"should_notify": false // 是否提示用户,true则提示用户
}
}
错误响应
{
"success": false,
"message": "错误描述",
"task_id": "news_20240327_1001",
"task_name": "今日新闻汇总",
"error_type": "validation|format|network|system|auth|service",
"push_time": "2024-03-27 10:15:30",
"suggestion": "建议的解决方案",
"update_check": {
// 版本更新检查
"status": "skipped_or_error",
"message": "更新检查异常或配置未开启",
"should_notify": false // 是否提示用户,true则提示用户
}
}
🚨 错误码处理指南
系统提供了详细的错误码处理功能,当推送失败时会返回具体的错误信息和解决方案。
常见错误码及解决方案
1. 错误码: 0000900034 - 授权码无效或未关联
问题描述: 授权码无效或用户未在负一屏关联账号
解决方案:
- 从手机桌面右滑进入负一屏
- 点击左上角头像
- 进入"我的"页面,点击右上角设置图标
- 选择"动态管理"
- 点击"关联账号"
- 找到"Claw 智能体"并点击获取授权码
2. 错误码: 0200100004 - 负一屏云推送服务异常
问题描述: 负一屏云推送到服务动态云有报错,需要检查返回的 desc 字段
CP 错误码: 82600017 - 设备未联网或未登录华为账号
解决方案:
- 检查设备 Wi-Fi 或移动数据是否已连接
- 打开"设置"应用
- 进入"华为账号"或"帐号中心"
- 确保已登录华为账号
- 如未登录,请使用华为账号登录
CP 错误码: 82600013 - 服务动态推送开关已关闭
解决方案:
- 从手机桌面右滑进入负一屏
- 点击左上角头像
- 进入"我的"页面,点击右上角设置图标
- 选择"动态管理"
- 找到"AI 任务完成通知"
- 打开"场景开关"和"服务提供方开关"
CP 错误码: 82600005 - 服务动态云服务异常
解决方案:
- 等待几分钟后重试
- 如问题持续,可能是服务端维护
- 可稍后再试或联系技术支持
错误信息格式
错误信息会包含详细的结构化内容:
- 错误代码和描述
- 问题分析
- 具体解决方案
- 操作步骤
- 技术支持信息
示例错误信息
错误代码: 0000900034
错误描述: 授权码无效
[问题分析] 授权码无效或未关联
[解决方案] 请您到负一屏 -> 我的页 -> 动态管理 -> 关联账号 -> 点击Claw智能体去获取授权码
[操作步骤]
1. 从手机桌面右滑进入负一屏
2. 点击左上角头像
3. 进入"我的"页面,点击右上角设置图标
4. 选择"动态管理"
5. 点击"关联账号"
6. 找到"Claw智能体"并点击获取授权码
[技术支持]
- 如问题无法解决,请记录错误代码并提供给技术支持
- 错误发生时间: 2026-03-30 17:10:00
🔗 与其他技能配合
典型工作流
1. 执行某个任务(如查询新闻、检查天气、生成报告等)
2. 任务完成后,生成markdown格式的结果
3. 调用本技能推送结果到负一屏
4. 用户可以在负一屏查看任务结果
集成示例
# 在其他技能中调用本技能
def complete_task_and_push(task_name, task_content, task_result="任务已完成"):
# 1. 准备任务数据
task_data = {
"task_id": f"{task_name}_{datetime.now().strftime('%Y%m%d_%H%M%S')}",
"task_name": task_name,
"task_result": task_result,
"task_content": task_content
}
# 2. 调用推送技能
push_result = push_to_negative_screen(task_data)
return push_result
🚀 使用示例
⚠️ 首次使用安全提示
首次使用本技能时请注意:
- 数据流向:任务内容将发送到配置的推送端点
- 默认端点:
hiboard-claw-drcn.ai.dbankcloud.cn(华为云服务) - 传输内容:任务内容 + 授权码 + 元数据
- 安全建议:
- 了解数据发送目的地
- 避免包含高度敏感信息
- 可以配置自定义端点
基本使用
# 任务完成后
任务完成,推送到负一屏
在脚本中使用(只支持 JSON 输入)
# 1. 首先创建 JSON 文件(推荐使用工具)
python scripts/create_task_json.py "任务名称" content.md
# 2. 推送任务结果(实际发送)
python scripts/task_push.py --data task_result.json
# 3. 安全测试:使用 --dry-run 参数避免实际发送
python scripts/task_push.py --data task_result.json --dry-run
# 4. 使用配置文件中的授权码
python scripts/task_push.py --data task_result.json --config config.json
# 重要:不再支持 --name、--content、--result 参数
# 必须使用 JSON 文件确保 markdown 格式完整保留
🔒 安全测试选项
--dry-run:模拟推送,不实际发送数据--verbose:显示详细日志,包括端点信息--validate-only:仅验证数据格式,不推送
🔄 版本更新检查
本技能包含自动版本更新检查功能:
检查时机
- 每次运行脚本时自动检查
- 从 ClawHub 获取最新版本信息
- 比较本地版本与远程版本
输出信息
当检测到更新时,脚本会输出:
[检查] 检查技能更新...
[信息] 本地版本: 1.0.12
[信息] 从ClawHub检查...
[信息] ClawHub版本: 1.0.13
[信息] 远程版本: 1.0.13
============================================================
[通知] 技能更新通知
============================================================
本地版本: 1.0.12
远程版本: 1.0.13
来源: clawhub
更新命令: clawhub update today-task
============================================================
更新策略
- 仅通知,不自动更新:出于安全考虑,脚本只通知有更新可用
- 用户手动更新:需要用户明确执行更新命令
- 更新命令:
clawhub update today-task
注意事项
- 如果本地有修改,更新可能被阻止
- 可以使用
--force参数强制更新:clawhub update today-task --force - 更新前建议备份本地修改
⚠️ 命令行授权码安全警告
重要:避免在命令行中直接传递授权码:
# ❌ 不安全:授权码在命令行历史中可见
python scripts/task_push.py --auth-code YOUR_AUTH_CODE --data task.json
# ✅ 安全:使用配置文件或 OpenClaw 全局配置
python scripts/task_push.py --data task.json
授权码安全建议:
- 使用 OpenClaw 全局配置:
openclaw config set skills.entries.today-task.config.authCode YOUR_CODE - 使用本地配置文件:在
config.json中配置授权码 - 避免聊天粘贴:不要在聊天消息中粘贴授权码
- 定期更新:定期在负一屏中更新授权码
在 OpenClaw 技能中集成
# 在技能脚本中调用
from task_pusher import TaskPusher
def skill_main():
# ... 执行任务逻辑 ...
# 生成markdown格式的结果
markdown_content = generate_markdown_result(data)
# 任务完成后推送结果
pusher = TaskPusher()
result = pusher.push({
"task_id": f"task_{int(time.time())}",
"task_name": "AI新闻汇总",
"task_result": "任务已完成",
"task_content": markdown_content
})
return result
⚙️ 配置说明 - 混合配置系统
本技能使用混合配置系统,支持灵活的配置优先级:
配置优先级规则
auth_code (授权码):
- 优先使用 OpenClaw 全局配置
- 如果没有设置,则使用本地配置(如果存在)
- 如果都没有设置,则提示用户配置
pushServiceUrl (推送 URL):
- 优先使用 OpenClaw 全局配置
- 如果没有设置,则使用本地 config.json 中的
pushServiceUrl配置 - 如果都没有设置,则提示用户配置
其他配置项:使用本地 config.json 中的配置
配置加载顺序
- 首先加载本地 config.json 文件中的基础配置
- 然后检查 OpenClaw 全局配置
- 根据优先级规则合并配置
- 验证必需配置是否完整
OpenClaw 全局配置命令
1. 设置授权码
openclaw config set skills.entries.today-task.config.authCode YOUR_AUTH_CODE
2. 设置推送 URL
openclaw config set skills.entries.today-task.config.pushServiceUrl YOUR_PUSH_URL
3. 查看技能配置
openclaw config get skills.entries.today-task
4. 删除配置
# 删除授权码配置
openclaw config unset skills.entries.today-task.config.authCode
# 删除推送URL配置
openclaw config unset skills.entries.today-task.config.pushServiceUrl
配置示例
# 设置授权码
openclaw config set skills.entries.today-task.config.authCode KzLEP2FjYPg1
# 设置推送URL
openclaw config set skills.entries.today-task.config.pushServiceUrl https://hiboard-claw-drcn.ai.dbankcloud.cn/distribution/message/cloud/claw/msg/upload
本地配置文件 (config.json)
其他配置项在技能目录的 config.json 文件中设置:
{
"timeout": 30,
"max_content_length": 5000,
"auto_generate_id": true,
"default_result": "任务已完成",
"log_level": "INFO",
"save_records": true,
"records_dir": "push_records",
"max_records": 100,
"pushServiceUrl": "https://hiboard-claw-drcn.ai.dbankcloud.cn/distribution/message/cloud/claw/msg/upload"
}
配置优先级说明:
- auth_code (授权码):优先使用 OpenClaw 全局配置,如果没有则使用本地配置
- pushServiceUrl (推送 URL):优先使用 OpenClaw 全局配置,如果没有则使用本地 config.json 中的配置
- 其他配置项:使用本地 config.json 中的配置
🔑 授权码获取说明
授权码是必填字段,用于验证推送权限。如果未设置授权码或授权码无效,推送将失败。
获取步骤:
- 从手机桌面右滑进入负一屏
- 点击左上角头像
- 进入"我的"页面,点击右上角设置图标
- 选择"动态管理"
- 点击"关联账号"
- 找到"Claw 智能体"并点击获取授权码
推送 URL 说明:
- 默认 URL:
https://hiboard-claw-drcn.ai.dbankcloud.cn/distribution/message/cloud/claw/msg/upload
🔄 自动检测授权码功能
当用户在对话中提供授权码时,系统会自动检测并提示使用 OpenClaw 配置命令。
支持格式:
- "我的授权码是 aqvIVhhWz7ir"
- "使用授权码 FrF2e6Pwqvpz"
- "授权码: NWrU7qbN8vvx"
- "auth: HO4hza2l9MYy"
工作原理:
- 系统会分析用户输入,检测是否符合授权码格式
- 检测到授权码后,生成 OpenClaw 配置命令
- 提示用户使用命令设置配置
- 设置完成后,技能将使用新的授权码
使用示例:
用户:我的授权码是 aqvIVhhWz7ir
系统:检测到授权码: aqvi***
请使用以下OpenClaw命令设置授权码:
openclaw config set skills.entries.today-task.config.authCode aqvIVhhWz7ir
🔑 授权码获取说明
授权码是必填字段,用于验证推送权限。如果未设置授权码或授权码无效,推送将失败并显示以下提示:
📱 请您到负一屏 -> 我的页 -> 动态管理 -> 关联账号 -> 点击Claw智能体去获取授权码
获取步骤:
- 打开负一屏应用
- 进入"我的"页面
- 找到"动态管理"
- 点击"关联账号"
- 找到"Claw 智能体"并点击获取授权码
常见授权码错误:
0000900034- 授权码无效The authCode is invalid- 授权码无效- 授权码未设置 - 配置文件中缺少 auth_code 字段
🔄 自动更新授权码功能
新增功能:当用户在对话中提供授权码时,系统会自动检测并更新到配置文件中。
支持格式:
- "我的授权码是 aqvIVhhWz7ir"
- "使用授权码 FrF2e6Pwqvpz"
- "授权码: NWrU7qbN8vvx"
- "auth: HO4hza2l9MYy"
工作原理:
- 系统会分析用户输入,检测是否符合授权码格式
- 检测到授权码后,自动更新到配置文件
- 更新完成后会显示确认信息
- 后续推送将使用新的授权码
授权码格式要求:
- 长度:10-20 个字符
- 组成:字母、数字,可能包含下划线或连字符
- 示例:
aqvIVhhWz7ir,FrF2e6Pwqvpz,NWrU7qbN8vvx
使用示例:
用户:我的授权码是 aqvIVhhWz7ir
系统:✅ 检测到授权码,已更新到配置文件
配置验证
配置验证失败时会显示以下提示:
配置中缺少必需字段: auth_code, hiboards_url
请使用以下方式设置配置:
1. auth_code (授权码): 使用OpenClaw全局配置命令设置
命令: openclaw config set skills.entries.today-task.config.authCode YOUR_AUTH_CODE
2. hiboards_url (推送URL): 使用OpenClaw全局配置命令设置
命令: openclaw config set skills.entries.today-task.config.pushServiceUrl YOUR_PUSH_URL
其他配置项请在技能目录的config.json文件中设置。
📁 文件结构
push-task-to-negative-screen/
├── SKILL.md # 技能定义
├── README.md # 使用说明
├── config.json # 配置文件示例
├── scripts/
│ ├── task_push.py # 主推送脚本
│ ├── task_pusher.py # 推送器类
│ ├── config.py # 配置管理
│ ├── logger.py # 日志工具
│ ├── hiboards_client.py # 负一屏客户端
│ └── simple_test.py # 测试脚本
└── push_records/ # 推送记录目录(自动创建)
💡 设计优势
- 格式统一:所有任务使用相同的推送格式
- 简单易用:接口简单,易于集成
- 灵活性强:支持任何类型的任务结果
- 配置方便:支持配置文件
- 错误处理完善:详细的错误信息和建议
- 记录完整:保存完整的推送记录
🎨 Markdown 内容生成建议
最佳实践
- 使用标题层级:合理使用#、##、###等标题
- 列表展示:使用-或*表示列表项
- 代码块:使用```包裹代码
- 表格:使用 markdown 表格格式
- 分割线:使用---作为分割线
示例模板
# 任务名称
## 执行结果
✅ 任务已完成
## 详细内容
- 项目 1: 结果描述
- 项目 2: 结果描述
- 项目 3: 结果描述
## 关键指标
| 指标 | 数值 | 状态 |
| ------ | ------ | ---- |
| 完成率 | 100% | ✅ |
| 用时 | 5 分钟 | ⏱️ |
---
_生成时间: 2026-03-30 10:30:00_
🔐 完整安全指南
1. 数据流向透明度
本技能设计为透明数据流:
用户输入 → 技能处理 → HTTPS传输 → 配置的端点
端点说明:
- 默认端点:华为云负一屏服务 (
ai.dbankcloud.cn) - 自定义端点:用户配置的任何 HTTPS 端点
- 本地测试:使用
--dry-run避免网络传输
2. 传输的数据
每次推送包含:
| 数据字段 | 内容 | 敏感性 |
|---|---|---|
authCode |
授权令牌 | 🔴 高敏感 |
task_content |
任务文本内容 | 🟡 中敏感 |
| 任务元数据 | 名称、ID、时间等 | 🟢 低敏感 |
3. 隐私保护措施
本地保护:
- ✅ 日志脱敏:
authCode显示为ABC*** - ✅ 可选记录:可关闭推送记录保存
- ✅ 本地存储:所有文件仅存本地
传输保护:
- ✅ HTTPS 加密:所有传输使用 TLS
- ✅ 证书验证:验证服务器身份
- ✅ 最小数据:仅发送必要数据
4. 用户控制权
配置控制:
- 端点配置:使用自定义端点
- 记录控制:关闭本地记录保存
- 日志控制:调整日志详细程度
操作控制:
- 测试模式:
--dry-run模拟推送 - 验证模式:
--validate-only仅验证格式 - 详细日志:
--verbose查看完整信息
5. 最佳安全实践
对于所有用户:
- 了解数据流向:知道数据发送到哪里
- 审查任务内容:避免包含敏感信息
- 定期更新授权码:增强安全性
对于敏感数据:
- 使用自定义端点:控制数据目的地
- 关闭本地记录:
save_records: false - 使用测试模式:
--dry-run验证功能
对于企业用户:
- 部署私有端点:完全控制数据流
- 审计推送记录:定期审查
push_records/ - 监控技能使用:通过日志监控活动
6. 合规性说明
数据保护:
- 符合最小必要原则
- 提供用户控制选项
- 透明数据处理流程
隐私权:
- 用户知情权:明确告知数据流向
- 用户控制权:提供配置选项
- 用户退出权:可停止使用并删除数据
7. 紧急措施
如果发现安全问题:
- 立即停止使用技能
- 撤销授权码:在负一屏中撤销
- 删除本地数据:清理
logs/和push_records/ - 联系支持:报告安全问题
重要:详细安全声明请查看 SECURITY.md
最后更新: 2026-03-31
Statistics
Latest Changes
v1.0.17 · Apr 3, 2026
**重大变更:推送接口全面切换为 JSON 文件方式,保障推送内容的格式完整性** - 仅支持通过 `--data` 参数输入 JSON 文件推送任务结果,不再支持 `--name`、`--content` 等命令行参数。 - 推出脚本 `scripts/create_task_json.py`,可从 Markdown 文件和任务名快速生成标准 JSON 输入。 - JSON 推送方式完全保留 Markdown 格式,避免命令行转义和编码丢失。 - 文档与工作流说明全面更新,强调只使用 JSON 工作流,并提供创建与推送步骤示例。 - 其他推送流程、配置和安全机制保持不变。
Quick Install
clawhub install push-task-to-negative-screen Related Skills
Other popular skills you might find useful.
Chat with 100+ AI Models in one App.
Use Claude, ChatGPT, Gemini alongside with EU-Hosted Models like Deepseek, GLM-5, Kimi K2.5 and many more.