qoderwake定时任务需通过四种方式配置：一、定时触发策略（cron+沙盒）；二、ai定时任务（可视化+推送）；三、cli+crontab联合调度；四、webhook事件驱动。任一方式未正确配置均会导致任务不执行或状态不可见。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望QoderWake按固定周期自动执行数据库备份、日志归档或指标快照等运维操作，但发现任务未按时运行或状态不可见，则可能是由于定时触发策略未启用、Cron表达式配置错误或执行沙盒未通过审计校验。以下是设置QoderWake定时任务的具体路径：
一、配置定时触发策略
定时触发策略基于标准Cron表达式驱动，在独立沙盒中运行所有周期性任务，并自动生成完整审计日志，适用于日志归档、指标快照、备份检查等场景。该方式支持时区选择与沙盒隔离，确保任务互不干扰。
1、登录QoderWake管理控制台，进入「触发管理」→「定时触发」模块。
2、点击「添加计划」，输入计划名称，例如“每日01:30核心库备份”。
3、选择执行时区，默认为服务器本地时区；如需统一按北京时间调度，手动切换为Asia/Shanghai。
4、在Cron表达式输入框中填写时间规则，例如0 30 1 * * *表示每天01:30执行（秒 分 时 日 月 周 年七字段格式）。
5、点击「关联任务」，从已启用的AI脚本或预设工作流中选择目标执行体，确保其参数校验已通过且处于启用状态。
6、勾选「启用审计日志记录」，系统将为每次执行生成唯一trace_id、开始时间、结束时间、退出码及标准输出摘要。
7、点击「保存并激活」，QoderWake将立即编译该计划至调度中心，并在下次匹配时间点自动触发。
二、使用平台内置AI定时任务
该方式通过QoderWake可视化界面直接创建可执行、可追溯的AI驱动定时任务，所有逻辑封装在平台内，无需脱离控制台即可完成全链路部署与状态监控。
1、进入【自动化】→【AI定时任务】模块。
2、点击“新建任务”，任务类型选择“Python AI脚本”，名称设为“每日增量备份”。
3、在脚本编辑区输入导出指令，例如：
import qoderwake.db as db
db.export_table(export_format="parquet", tables=["users", "orders"], output_path="/backup/daily_{{now|strftime:%Y%m%d}}.parquet")
4、在「调度设置」区域点击「设置定时」，选择「按Cron表达式」，填入0 30 1 * * ?（兼容Quartz六字段语法）。
5、开启「执行状态推送」，绑定企业微信/钉钉机器人Webhook地址，任务成功或失败时将实时通知。
Qoder Linux版是由阿里推出的智能体自主开发工作台，支持开发者通过定义需求即可让Agent团队“自动驾驶”，自主完成代码执行、验证与交付的全流程。其全新的Quest独立视窗集成了任务管理与状态追踪能力，并支持跨项目多任务并行处理，显著提升开发效率。此外，Qoder还提供专家团模式与团队级知识引擎，适配复杂开发场景。
6、点击「启用任务」，系统显示绿色状态条并生成任务ID，可在【任务监控】页按ID检索全部历史执行记录。
三、绑定CLI+系统级crontab联合调度
该方式适用于需要复用现有Linux运维体系的场景，通过Qoder CLI调用平台API提交一次性或周期性任务请求，由宿主机crontab负责时间控制，兼顾灵活性与权限收敛。
1、在目标服务器安装Qoder CLI工具，执行qoderwake login --api-key YOUR_API_KEY完成认证。
2、编写Shell脚本/opt/qoder/tasks/daily_backup.sh，内容为：
qoderwake job submit --workflow-id wfl-789abc --param output_path="/backup/$(date +\%Y\%m\%d)"
3、赋予脚本执行权限：chmod +x /opt/qoder/tasks/daily_backup.sh。
4、编辑系统crontab：crontab -e，添加一行：
30 1 * * * /opt/qoder/tasks/daily_backup.sh >> /var/log/qoder_backup.log 2>&1
5、验证crontab加载：systemctl restart cron（Debian/Ubuntu）或systemctl restart crond（RHEL/CentOS）。
6、手动执行脚本测试连通性：/opt/qoder/tasks/daily_backup.sh，确认返回HTTP 201及job_id字段。
四、启用Webhook触发预设AI工作流
该方式适用于私有云隔离环境，通过外部系统（如Zabbix告警平台、审批流引擎）主动发起HTTP POST请求触发QoderWake预设工作流，实现事件驱动型周期调度，所有请求强制签名验证与Schema校验。
1、在「触发管理」→「API回调触发」中点击「创建新端点」。
2、系统生成唯一Webhook URL，形如https://wake.qoder.ai/v1/webhook/def456，请记录该地址。
3、点击「生成密钥」，获取HMAC-SHA256密钥字符串，并同步配置至调用方系统头部X-Hub-Signature-256字段。
4、在「请求体映射」区域定义JSON Schema，声明必需字段：{"type":"object","properties":{"event_type":{"const":"DAILY_CRON"},"schedule_time":{"format":"date-time"},"target_env":{"enum":["prod","staging"]}},"required":["event_type","schedule_time","target_env"]}
5、配置外部系统定时器，每24小时向该Webhook URL发送POST请求，携带符合Schema的JSON载荷。
6、QoderWake接收到请求后，校验签名与字段合法性，通过则启动对应AI工作流，并在【执行监控】页生成带trigger=webhook标签的执行实例。
