需配置Hermes Agent的cronjob功能以实现定时任务，包括编辑cron.yaml文件、编写YAML任务条目、CLI动态注册、验证服务状态及调试日志定位。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望让 Hermes Agent 按照固定时间自动执行服务器检查、日志采集或能源数据上报等任务，则需正确配置其 cronjob 功能。以下是完成该配置的具体步骤：
一、编辑 cron 配置文件
该操作通过修改 Hermes Agent 的 cron 任务定义文件，使系统识别并加载定时任务规则。配置文件通常位于 config/cron.yaml 或 cli-config.yaml 中的 cron 字段下。
1、使用终端工具打开配置文件：nano config/cron.yaml
2、在文件中添加或确认存在 cron: 顶层键，并在其下以列表形式定义任务项
3、确保每项任务包含 name、schedule 和 task 三个必需字段
二、编写标准 cron 任务条目
此方法采用 YAML 格式声明任务，由 Hermes Agent 内部解析器转换为系统级调度指令。每个任务独立运行，互不干扰。
1、在 cron: 下新增一个任务对象，格式如下：
2、设置任务名称，例如：name: "每日磁盘健康扫描"
3、指定执行周期，例如：schedule: "0 2 * * *"（表示每天凌晨2点）
4、填写要执行的操作描述，例如：task: "检查所有挂载点的使用率，超过90%时触发飞书告警"
三、使用 CLI 工具动态注册任务
该方式无需手动编辑 YAML 文件，而是通过命令行接口直接向 Hermes Agent 的调度模块提交新任务，适用于临时调试或快速部署场景。
1、启动 Hermes Agent CLI 环境：hermes shell
2、执行任务创建命令：hermes cron add --name "实时日志聚合" --schedule "*/5 * * * *" --task "运行 scripts/log_aggregate.py"
3、确认返回信息中显示 Cron job registered successfully
4、输入 hermes cron list 查看当前已激活的所有定时任务
四、验证 cron 服务是否正常运行
该步骤用于确认 Hermes Agent 的调度引擎已启动且能响应配置变更，避免因服务未就绪导致任务静默失效。
1、在终端中运行：hermes status
2、检查输出中是否存在 cron scheduler: active 字样
3、若状态为 inactive，执行：hermes start cron
4、观察日志流中是否出现类似 [CRON] Triggering task '服务器健康检查' at 2026-04-17T15:30:00Z 的记录
五、调试失败任务的日志定位
当某项 cron 任务未按预期执行时，需通过日志路径快速定位异常源头，排除语法错误、权限不足或依赖缺失等问题。
1、进入 Hermes Agent 日志目录：cd logs/cron/
2、列出最近生成的任务日志文件：ls -t | head -n 5
3、查看最新失败任务的详细输出：tail -n 20 cron_task_20260417_152959.log
4、重点查找包含 ERROR、Permission denied 或 Command not found 的行
