定时任务 NEW

概述

定时任务（Scheduled Tasks）让 Agent 自动定期执行预设任务 —— 无需你手动启动对话。桌面 APP 独有功能。

典型场景：

• 每天 9:00 抓取 5 个竞品官网，对比变化，发到钉钉
• 每周一 18:00 从 Gmail 搜本周所有"合同"相关邮件，汇总成 Excel 并邮寄给老板
• 每 30 分钟检查一次邮件，如有紧急邮件发微信通知我
• 每月 1 日生成上月的团队工作总结报告

入口

桌面 APP → 左侧设置菜单 → 定时任务

三种调度模式

常用 Cron 表达式

执行模式

创建任务时选择执行方式：

选择建议：

• 彼此独立的任务（如每日监控） → isolated
• 希望 Agent 记住之前的结果（如持续跟进的项目） → persistent
• 需要复用已有会话的上下文 → selected

通知配置

任务执行完成后可以通过多种渠道通知你：

渠道配置详见 渠道配置。

通知内容：任务执行状态（成功/失败）+ 简要摘要或完整输出

任务详情页

每个任务的详情页包含：

运行历史（AllRunsHistory）

每个任务都有独立的运行历史表：

支持按时间、状态筛选。

操作指南

创建一个定时任务

1. 打开 APP → 设置 → 定时任务
2. 点击 + 新建任务
3. 填写基本信息：
   • 名称：如"每日竞品监控"
   • 描述：简要说明
4. 选择调度模式：
   • 一次性：选日期时间
   • 周期：输入间隔数和单位
   • Cron：填写 Cron 表达式
5. 填写任务 Prompt：
   请抓取以下 3 个竞品官网的首页， 对比它们昨天和今天的变化（新产品、新公告、新定价）， 输出变化摘要： - 竞品 A: https://... - 竞品 B: https://... - 竞品 C: https://...

                         
                         请抓取以下 3 个竞品官网的首页，
   对比它们昨天和今天的变化（新产品、新公告、新定价），
   输出变化摘要：
   - 竞品 A: https://...
   - 竞品 B: https://...
   - 竞品 C: https://...
   
                       

   此代码块在浮窗中显示
6. 选择执行模式（通常选 isolated）
7. 配置通知渠道（如钉钉）
8. 保存

手动触发一次

在任务列表点击任务行的 立即运行 按钮，可以手动触发一次执行（不影响下一次预定执行时间）。

暂停 / 恢复任务

任务详情页有 启用/禁用 开关。禁用后任务停止调度，但保留配置，可随时恢复。

组织隔离

定时任务按 orgId 隔离 —— 你只能看到自己所在组织的任务。切换组织时，任务列表也会切换。

账号切换影响：如果当前登录用户变更（跨账号切换），会话中的任务不会终止，但后续执行时会校验归属。

常见问题

定时任务能执行有权限弹窗的工具吗

任务执行时会触发工具权限弹窗。如果此时你在 APP 前台，可以响应；如果无人响应，系统按以下规则处理：

• 同账号：如果 APP 在线，弹窗会显示，用户可响应
• 跨账号 enterprise 场景：5 分钟无响应则默认拒绝

为避免阻塞，建议：

1. 将定时任务常用的 Bash、Web Fetch 等工具设为 P0（APP 自动执行）
2. 使用"总是允许"选项把常用命令加入白名单
3. 在 运行时安全 中针对性配置

任务执行失败怎么办

查看任务详情页的运行历史 → 失败记录 → 错误信息。常见原因：

• 模型 API Key 过期：去"模型"页重新配置
• 网络问题：工具可能无法访问外网
• 权限超时：参考上一问
• LLM 限流：增加重试间隔或换用更高配额的模型

连续失败达到阈值时，任务会自动暂停并发通知。

APP 关闭了任务还会执行吗

不会。定时任务需要 APP 在线才能触发。如果你需要 7×24 执行，请：

1. 让 APP 常驻运行（macOS 后台运行 / Windows 系统托盘）
2. 考虑用一台一直开机的备用机部署 APP

能否和 Claw 的 "scheduled-task" 技能配合使用

可以。Claw 对话中如果启用了 scheduled-task 技能，Agent 可以在对话中代你创建定时任务。例如说"每天 9 点帮我抓取这 3 个网站"，Agent 会调用 scheduled-task 技能自动创建一个任务。

相关文档

• 渠道配置 — 配置 Telegram、钉钉等通知渠道
• 技能管理 — scheduled-task 预置技能
• 运行时安全 — 工具权限级别配置