QoderWake自动化任务设置完整教程-人工智能-PHP中文网

qoderwake需配置定时触发、ai定时任务、webhook事件驱动及cli+crontab四种调度方式，并做好防睡眠与常驻配置。定时触发用cron表达式；ai定时任务支持可视化编辑与推送；webhook需校验签名与schema；cli方式适配无gui环境；mac/linux须禁用休眠并启用守护进程。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

qoderwake自动化任务设置完整教程 - php中文网

你想让QoderWake真正跑起来，自动执行数据库备份、周报生成、网页数据抓取等任务，而不是每次都要手动点一下才动一下。这需要打通触发、执行、监控三道关卡，缺一不可。

配置定时触发策略

该方式适用于日志归档、指标快照、每日备份等强周期性任务，所有动作在独立沙盒中运行并生成审计日志，避免任务间互相干扰。

1、登录QoderWake管理控制台，进入「触发管理」→「定时触发」模块。

2、点击「添加计划」，输入计划名称，例如“每日02:00生产库全量备份”。

3、选择执行时区——【务必确认此处与你业务所在时区一致，Asia/Shanghai为国内默认】；若选错，任务将在错误时间点触发，且日志时间戳无法回溯修正。

4、在Cron表达式输入框填写规则，例如 0 0 2 * * * 表示每天02:00执行（七字段：秒分时日月周年）；注意：QoderWake采用标准Unix Cron语法，不支持?占位符，填*或具体值即可。

5、点击「关联任务」，从已启用的AI脚本或预设工作流中选择目标执行体；【必须确保该任务处于启用状态且参数校验已通过，否则保存后仍显示“未就绪”】。

6、勾选「启用审计日志记录」，系统将为每次执行生成唯一trace_id、开始时间、结束时间、退出码及标准输出摘要。

7、点击「保存并激活」，QoderWake将立即编译该计划至调度中心，并在下次匹配时间点自动触发。

创建AI定时任务（可视化+推送）

适合不想写Cron、需要快速验证逻辑、同时要求执行结果可通知的场景，比如每日增量备份成功后发钉钉消息。

方法一：用内置模板快速启动

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六字段兼容格式，表示每天01:30）。

5、开启「执行状态推送」，绑定企业微信/钉钉机器人——【Webhook地址必须提前在对应平台创建并复制，QoderWake不提供机器人创建入口】。

方法二：复用历史成功对话固化为定时工作流

1、打开任意一次已成功执行的对话记录，点击右上角「转为定时任务」按钮。

2、系统自动提取该次对话中的全部上下文、变量和动作链，生成可编辑的AI工作流。

3、修改触发时间为每周五17:00，保存即生效，无需重写逻辑。

接入Webhook事件驱动

当你已有监控系统、审批流或CRM，希望它们发出告警或完成信号时，QoderWake立刻响应处理，就用这个方式。

第一步：创建Webhook端点

1、在「触发管理」页面选择「API回调触发」，点击「创建新端点」。

php获得文件的mime type类

下载

2、系统自动生成唯一Webhook URL，形如 https://wake.qoder.ai/v1/webhook/abc123，请复制保存。

第二步：配置安全与校验

1、点击「生成密钥」获取HMAC-SHA256密钥字符串，同步配置至调用方系统请求头中（通常为X-Qoder-Signature字段）。

2、在「请求体映射」区域定义JSON Schema，明确声明必需字段，例如：{"event_type":{"type":"string"},"target_env":{"enum":["prod","staging"]}}。

第三步：绑定执行逻辑

1、点击「关联任务」，选择一个已调试通过的AI脚本或数字流程专员。

2、保存后，QoderWake将对所有到达该URL的请求执行签名验证与Schema校验，任一失败即返回401错误，不落库、不重试。

启用CLI+crontab联合调度

Linux/macOS高级用户常用方式，绕过图形界面依赖，实现纯命令行级守护与调度，适合部署在服务器或树莓派等无GUI环境。

① 安装QoderWake CLI运行时

下载qoderwake-cli-v0.9.1.tar.gz，解压后执行./install.sh，确保qwrun命令全局可用。

② 编写本地任务脚本

在/opt/qoder/tasks/backup.qw中写入：
trigger: immediate
action: shell "mysqldump -u root app_db > /data/backup/app_{{now|strftime:%Y%m%d_%H%M%S}}.sql"
timeout: 300000

③ 配置系统级crontab

执行crontab -e，添加一行：
0 2 * * * /usr/local/bin/qwrun --script /opt/qoder/tasks/backup.qw >> /var/log/qw-backup.log 2>&1

④ 启动守护进程

执行nohup qwrun --daemon --config /opt/qoder/conf.yaml &，确保CLI后台持续监听任务队列。