hermes agent 通过 cronjob 实现定时任务调度，支持 yaml 配置、cli 动态注册、自然语言生成三种方式，并需验证执行环境与日志排查。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 Hermes Agent 定期执行代码脚本或对指定文件进行自动化处理（例如定时运行 Python 脚本、压缩日志、清理临时文件等），则需通过其 cronjob 功能完成任务注册与调度。以下是实现该目标的具体操作路径：
一、通过 YAML 配置文件定义定时代码执行任务
该方式适用于长期稳定运行的批处理任务，配置持久化保存于本地文件系统，重启后自动加载。任务定义需严格遵循 YAML 语法，并置于 Hermes Agent 可识别的 cron 配置路径下。
1、使用终端编辑器打开 cron 配置文件：nano ~/.hermes/config.yaml
2、在文件末尾添加 cron: 顶层字段（若尚不存在），并在其下以列表形式新增一项任务
3、为任务指定唯一名称，例如：name: "每日凌晨3点执行数据清洗"
4、设置标准 cron 表达式，例如：schedule: "0 3 * * *"（表示每天 03:00 执行）
5、在 task 字段中声明具体动作，例如：task: "运行 scripts/clean_data.py --input /var/log/raw/ --output /var/log/clean/"
二、使用 CLI 命令行动态创建文件处理任务
该方式无需修改配置文件，适合快速验证脚本逻辑、临时启用文件归档或测试路径权限，所有任务均实时注册至调度引擎并立即生效。
1、进入 Hermes Agent 交互式 CLI 环境：hermes shell
2、执行任务注册命令，明确指定脚本路径与参数：hermes cron add --name "每周六压缩旧日志" --schedule "0 0 * * 6" --task "bash scripts/archive_logs.sh /tmp/logs/ /backup/weekly/"
3、检查返回信息是否包含：Cron job registered successfully
4、列出当前全部激活任务以确认新增项已就位：hermes cron list
三、通过自然语言对话生成定时执行指令
此方法依赖 Hermes Agent 的语义理解能力，可将模糊需求直接转化为结构化 cron 任务，特别适用于非技术用户或快速原型阶段，无需记忆语法与路径格式。
1、启动 Hermes 对话会话：hermes chat
2、输入完整意图描述，例如：“每小时检查一次 /home/user/documents/ 目录下的 PDF 文件数量，如果超过 50 个，就运行 cleanup_pdfs.py 并把结果发到我的飞书”
3、等待 Hermes 解析并反馈任务摘要，确认无误后按提示输入 yes
4、查看 Hermes 自动生成的 cron 条目 ID 与执行时间窗口，例如：Job #crn-8a2f registered: runs every hour, triggers scripts/cleanup_pdfs.py
四、验证脚本执行环境与文件路径权限
该步骤用于排除因权限不足、路径不存在或解释器缺失导致的任务静默失败，确保 Hermes Agent 具备实际调用外部程序与读写目标文件的能力。
1、手动模拟任务上下文执行对应命令：sudo -u $(whoami) bash -c "python3 scripts/clean_data.py --input /var/log/raw/"
2、检查目标目录是否存在且可写：ls -ld /var/log/raw/ && test -w /var/log/raw/ && echo "writable"
3、确认脚本首行 shebang 正确指向可用解释器，例如：head -1 scripts/archive_logs.sh 应返回 #!/bin/bash
4、若脚本依赖虚拟环境，需在 task 字段中显式激活，例如：task: "source /opt/venv/bin/activate && python scripts/process_files.py"
五、定位脚本执行失败的日志输出位置
当某次定时任务未产生预期文件变更或报错时，需直接查阅 Hermes Agent 记录的任务执行快照，其中包含完整的标准输出、错误流及退出码，是调试的核心依据。
1、获取最近一次 cron 任务的原始日志路径：hermes log tail -m cron -n 20
2、在输出中查找包含 [CRON] Executing job '每日凌晨3点执行数据清洗' 的行
3、向下追踪紧邻的 ERROR 或 Traceback 字样，例如：ERROR subprocess.CalledProcessError: Command 'python3 scripts/clean_data.py' returned non-zero exit status 1
4、提取失败命令的完整执行路径与参数，复现该命令并观察终端实时反馈：cd ~/.hermes && python3 scripts/clean_data.py --input /var/log/raw/ --output /var/log/clean/
