Cron Channel

Cron 通道通过定时任务触发 Agent 执行，无需外部消息输入。

---

概述

Cron 通道不是传统的"聊天"通道，而是一个事件注入机制。它按计划时间向 Agent 发送预定义消息，触发自动化工作流。

配置

channels:
  cron:
    enabled: true

能力

能力	支持
编辑消息	❌
表情回应	❌
文件发送	❌
实时响应	❌
群聊	❌

创建定时任务

通过 CLI

echo-agent cron list
echo-agent cron authorize <job-id>   # 需先停止服务
echo-agent cron revoke <job-id>      # 需先停止服务

通过 Agent 对话

Agent 可以通过 cronjob 工具自行创建定时任务：

"每天早上 9 点给我发送天气预报"

也可以给已存在的任务补授权或撤销授权：

"授权定时任务 148fb4a4b9"

通过 Dashboard

Dashboard Cron 页面支持可视化管理定时任务。

授权机制

新创建的 Cron 任务默认未获授权，任务仍会按时触发，但其中的写文件/执行命令等特权操作会被拒绝。这是安全设计：

• 防止 Agent 在无人值守时让定时任务执行高风险操作
• 授权按单个任务签发，三条路径：对话里说「授权定时任务 <id>」、Dashboard 定时任务页勾选、或停止服务后运行 echo-agent cron authorize <id>
• 授权与任务内容绑定：修改指令、频率或投递目标后授权自动失效，需要重新授权（改名和暂停/恢复不会）

详见定时任务指南。

输出路由

Cron 通道本身没有"发送"能力，投递目标记在每个任务上，不是全局配置 —— 配置中没有 gateway.deliveryRoutes 这样的路由表。

任务载荷中的两个字段决定输出去向：

字段	说明
deliver_channel	目标通道名，如 telegram
deliver_chat_id	目标会话 ID

两者留空时回落到任务的 channel / chat_id。用 cronjob 工具或 Dashboard 创建任务时指定即可。

常见问题

任务创建了但不执行？ - 检查是否已授权：echo-agent cron list - 确认 Gateway 正在运行

时区问题？ - Cron 表达式使用系统本地时区