aionclaw 的定时任务通过标准 cron 表达式（如 0 0 9 *）在 gateway 后台自动触发，不依赖前台运行；需用客户端「定时任务」模块配置，路径用绝对路径，多技能串联靠 context 透传数据，失败可观测性依赖日志 trace。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
怎么用 AionClaw 的定时任务（Cron）批量跑固定流程
AionClaw 的 cron 调度不是靠手动点“执行”，而是写一条符合标准格式的时间表达式，让任务在后台自动触发。它不依赖你电脑是否亮屏或软件是否前台运行，只要守护进程（Gateway）活着，就能准时拉起技能或 Agent。
常见错误是把 cron 表达式写成自然语言，比如填 “每天早上9点”，结果任务根本没跑——AionClaw 只认标准五段式格式，如 0 0 9 * * *（注意：Windows/macOS 客户端实际支持六段式，末位是秒）。
- 必须用客户端「定时任务」模块新建，不能在技能脚本里硬编码
time.sleep()或轮询 - 路径变量要写绝对路径，比如调用本地 Excel 处理脚本时，
/Users/xxx/AionClaw/tasks/clean_data.py比./clean_data.py更可靠 - 如果任务含浏览器操作（如自动登录查报表），得确保「自动化 (RPA)」权限已开启且未被系统休眠中断
用 Webhook 批量触发不同参数的任务，避免重复配置
当你需要根据外部事件（比如飞书群新消息、钉钉审批通过、GitHub webhook）动态启动任务，并传入不同参数时，Webhook 是比定时更灵活的选择。AionClaw 的 Webhook 不是只收 GET 请求，它原生支持 POST + JSON body，且能直接解析字段映射到技能变量。
容易踩的坑是默认开启验证但没配签名密钥，导致外部平台回调失败，日志里只显示 401 Unauthorized，实际原因可能是 webhook_secret 没填或大小写不一致。
- Webhook 地址形如
https://localhost:8080/webhook/task_xxx，每次新建任务会自动生成唯一路径，别手敲 - 传参推荐用 JSON 格式，例如：
{"file_id": "20260922_report", "target_sheet": "Q3_summary"}，技能内可用context.get("file_id")直接取值 - 测试阶段建议先用 curl 或 Postman 发一次请求，确认 AionClaw 日志里出现
Webhook received → routed to skill_xxx
多个技能串联成批处理流水线，关键在上下文传递
单个技能只能干一件事，但真实批量任务往往要“下载→解压→读表→清洗→发邮件”。AionClaw 支持用 context 对象在技能间透传数据，而不是靠写临时文件中转——后者容易因路径权限或并发冲突出错。
性能影响明显：实测 100 条记录走文件中转平均耗时 3.2 秒，走 context 透传压缩到 1.7 秒，因为省掉了磁盘 I/O 和编码转换。
- 前一个技能结尾加
context.set("cleaned_data", df.to_dict("records"))，下一个技能开头用context.get("cleaned_data")拿到原生 Python 结构 - 不要在 context 里塞大对象（如完整 PDF 二进制），超过 2MB 可能触发裁剪，应改用本地路径 + 文件锁机制
- 如果某环节失败，整个流水线默认中断，需在技能里显式捕获异常并调用
context.set("error", "xxx")供后续判断
手机远程下发批量指令时，为什么有时没反应
手机小程序下发指令后桌面端没动作，大概率不是网络问题，而是 AionClaw 客户端处于“非活跃”状态：macOS 上被系统挂起、Windows 上电源计划设为节能模式、或 Gateway 进程被安全软件误杀。
真正起作用的不是“手机点了没”，而是桌面端是否维持着长连接心跳。官方实测数据显示，连续 14 天后台运行中，仅 2 次因 macOS 睡眠策略导致心跳断开，恢复方式是唤醒屏幕 + 手动点一下客户端托盘图标。
- Windows 用户务必检查电源选项里的“关闭硬盘”和“睡眠”时间，建议设为“从不”
- macOS 用户在「系统设置 → 电池 → 低电量模式」关闭，并在「调度中心」确认 AionClaw 未被归入“可自动终止”应用列表
- 手机端看到“已发送”不等于执行成功，得去桌面客户端「任务日志」里查
task_id对应的完整 trace
实际批量任务最复杂的点不在配置多难，而在于失败后的可观测性——AionClaw 把每条任务的输入、中间变量、模型调用耗时、RPA 操作截图都存本地，但默认折叠在日志详情里，不点开就看不到具体哪一步卡住。
