Skip to main content

定时任务（Cron）

你可以用自然语言或 Cron 表达式来自动调度任务。Hermes 通过统一的 cronjob 工具管理这些任务，采用“动作式”接口，而不是拆成多个创建、列出、删除工具。

当前 Cron 支持的能力​

Cron 任务目前可以：

  • 定时单次执行或周期性重复任务
  • 暂停、恢复、编辑、触发和移除任务
  • 为任务附加零个、一个或多个技能
  • 将结果返回至原始聊天会话、本地文件或已配置的平台目标
  • 在全新的代理会话中运行，并使用标准静态工具列表
warning

Cron 执行期间无法递归创建更多 Cron 任务。Hermes 会在 Cron 执行环境中禁用 Cron 管理工具，以防止出现无限调度循环。

创建定时任务​

在聊天中使用 /cron​

/cron add 30m "Remind me to check the build"
/cron add "every 2h" "Check server status"
/cron add "every 1h" "Summarize new feed items" --skill blogwatcher
/cron add "every 1h" "Use both skills and combine the result" --skill blogwatcher --skill find-nearby

通过独立 CLI​

hermes cron create "every 2h" "Check server status"
hermes cron create "every 1h" "Summarize new feed items" --skill blogwatcher
hermes cron create "every 1h" "Use both skills and combine the result" \
  --skill blogwatcher \
  --skill find-nearby \
  --name "Skill combo"

通过自然对话​

正常向 Hermes 提问即可：

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

Hermes 会内部调用统一的 cronjob 工具。

基于技能的 Cron 任务​

Cron 任务在执行前可以加载一个或多个技能。

单个技能​

cronjob(
    action="create",
    skill="blogwatcher",
    prompt="Check the configured feeds and summarize anything new.",
    schedule="0 9 * * *",
    name="Morning feeds",
)

多个技能​

技能会按顺序加载，提示词则作为叠加在这些技能之上的任务指令。

cronjob(
    action="create",
    skills=["blogwatcher", "find-nearby"],
    prompt="Look for new local events and interesting nearby places, then combine them into one short brief.",
    schedule="every 6h",
    name="Local brief",
)

如果你希望定时任务复用现成工作流，而不是把整段技能文本都塞进 Cron 提示里，这种方式会非常方便。

编辑任务​

无需删除并重新创建任务来修改它们。

聊天中​

/cron edit <job_id> --schedule "every 4h"
/cron edit <job_id> --prompt "Use the revised task"
/cron edit <job_id> --skill blogwatcher --skill find-nearby
/cron edit <job_id> --remove-skill blogwatcher
/cron edit <job_id> --clear-skills

独立 CLI​

hermes cron edit <job_id> --schedule "every 4h"
hermes cron edit <job_id> --prompt "Use the revised task"
hermes cron edit <job_id> --skill blogwatcher --skill find-nearby
hermes cron edit <job_id> --add-skill find-nearby
hermes cron edit <job_id> --remove-skill blogwatcher
hermes cron edit <job_id> --clear-skills

说明：

  • 重复使用 --skill 会替换任务附带的技能列表
  • --add-skill 会在原有列表基础上追加，不覆盖
  • --remove-skill 会移除指定的附加技能
  • --clear-skills 会移除所有附加技能

生命周期操作​

Cron 任务现在不只是“创建”和“删除”，而是具备完整的生命周期管理。

聊天中​

/cron list
/cron pause <job_id>
/cron resume <job_id>
/cron run <job_id>
/cron remove <job_id>

独立 CLI​

hermes cron list
hermes cron pause <job_id>
hermes cron resume <job_id>
hermes cron run <job_id>
hermes cron remove <job_id>
hermes cron status
hermes cron tick

这些命令的作用如下：

  • pause — 保留任务但停止调度
  • resume — 重新启用任务并计算下次未来执行时间
  • run — 在下一个调度周期立即触发任务
  • remove — 彻底删除任务

工作原理​

Cron 的实际执行由网关守护进程负责。 网关每 60 秒触发一次调度器，在隔离的代理会话中执行所有到期任务。

hermes gateway install     # Install as a user service
sudo hermes gateway install --system   # Linux: boot-time system service for servers
hermes gateway             # Or run in foreground

hermes cron list
hermes cron status

网关调度行为​

每次 tick 时，Hermes 会执行以下流程：

  1. 从 ~/.hermes/cron/jobs.json 加载任务
  2. 根据当前时间检查 next_run_at
  3. 为每个到期任务启动一个全新的 AIAgent 会话
  4. 可选地将一个或多个附加技能注入该新会话
  5. 运行提示直至完成
  6. 交付最终响应
  7. 更新运行元数据及下次计划时间

位于 ~/.hermes/cron/.tick.lock 的文件锁可防止多个调度 tick 重叠执行同一组任务。

输出交付选项​

创建调度任务时，需要指定输出目的地：

选项描述示例
"origin"返回到任务创建的位置消息平台默认
"local"仅保存到本地文件（~/.hermes/cron/output/）CLI 默认
"telegram"Telegram 主频道使用 TELEGRAM_HOME_CHANNEL
"telegram:123456"指定 Telegram 聊天 ID直接投递
"telegram:-100123:17585"指定 Telegram 主题chat_id:thread_id 格式
"discord"Discord 主频道使用 DISCORD_HOME_CHANNEL
"discord:#engineering"指定 Discord 频道通过频道名称
"slack"Slack 主频道
"whatsapp"WhatsApp 主账号
"signal"Signal
"matrix"Matrix 主房间
"mattermost"Mattermost 主频道
"email"邮件
"sms"通过 Twilio 发送短信
"homeassistant"Home Assistant
"dingtalk"DingTalk
"feishu"Feishu/Lark
"wecom"WeCom
"weixin"Weixin（微信）
"bluebubbles"BlueBubbles（iMessage）
"qqbot"QQ Bot（腾讯QQ）

代理的最终响应会自动投递。你不需要在 Cron 提示里再额外调用 send_message。

响应包装​

默认情况下，投递出去的 Cron 输出会包上一段标题和页脚，让接收者知道这是一条定时任务结果：

Cronjob Response: Morning feeds
-------------

<agent output here>

Note: The agent cannot see this message, and therefore cannot respond to it.

如果你希望直接发送原始代理输出，而不附加这层包装，可以把 cron.wrap_response 设为 false：

# ~/.hermes/config.yaml
cron:
  wrap_response: false

静默抑制​

如果代理的最终响应以 [SILENT] 开头，系统就会完全跳过投递。输出仍会保存在本地用于审计（位于 ~/.hermes/cron/output/），但不会发送到目标位置。

这在监控仅在出错时才需要报告的任务时非常有用：

Check if nginx is running. If everything is healthy, respond with only [SILENT].
Otherwise, report the issue.

失败任务始终会照常投递，不受 [SILENT] 标记影响。只有成功执行的任务才允许静默。

脚本超时​

预运行脚本（通过 script 参数附加）的默认超时时间为 120 秒。如果你的脚本需要更久，比如故意加入随机延迟来避免过于机械的执行节奏，可以把它调长：

# ~/.hermes/config.yaml
cron:
  script_timeout_seconds: 300   # 5 minutes

或设置 HERMES_CRON_SCRIPT_TIMEOUT 环境变量。优先级顺序为：环境变量 → config.yaml → 默认 120 秒。

提供商恢复机制​

Cron 任务会继承你配置的备用提供商和凭证池轮换策略。当主 API 密钥被限流，或当前提供商返回错误时，Cron 代理可以：

  • 降级到备用提供商，如果你在 config.yaml 中配置了 fallback_providers（或旧版 fallback_model）
  • 切换到同一提供商的下一个凭证，来自你的 凭证池

这意味着高频运行、或者恰好撞上高峰时段的任务会更稳健，单个被限流的密钥不至于拖垮整条任务。

调度格式​

代理的最终响应会自动投递，所以你不需要在 Cron 提示里再写一个 send_message 指向同样的目标。如果任务运行时又调用了 send_message 发往和调度器相同的接收方，Hermes 会自动跳过重复发送，并提示模型把面向用户的内容直接放进最终响应里。只有在你确实需要额外目标或不同目标时，才应该显式使用 send_message。

相对延迟（一次性）​

30m     → Run once in 30 minutes
2h      → Run once in 2 hours
1d      → Run once in 1 day

间隔（周期性）​

every 30m    → Every 30 minutes
every 2h     → Every 2 hours
every 1d     → Every day

Cron 表达式​

0 9 * * *       → Daily at 9:00 AM
0 9 * * 1-5     → Weekdays at 9:00 AM
0 */6 * * *     → Every 6 hours
30 8 1 * *      → First of every month at 8:30 AM
0 0 * * 0       → Every Sunday at midnight

ISO 时间戳​

2026-03-15T09:00:00    → One-time at March 15, 2026 9:00 AM

重复行为​

调度类型默认重复次数行为
一次性（30m，时间戳）1仅运行一次
间隔（every 2h）无限持续运行直到被移除
Cron 表达式无限持续运行直到被移除

你可以覆盖默认行为：

cronjob(
    action="create",
    prompt="...",
    schedule="every 2h",
    repeat=5,
)

程序化管理任务​

面向代理的 API 仅需一个工具：

cronjob(action="create", ...)
cronjob(action="list")
cronjob(action="update", job_id="...")
cronjob(action="pause", job_id="...")
cronjob(action="resume", job_id="...")
cronjob(action="run", job_id="...")
cronjob(action="remove", job_id="...")

对于 update，传入 skills=[] 可移除所有附加技能。

任务存储​

任务存储在 ~/.hermes/cron/jobs.json。任务运行的输出保存在 ~/.hermes/cron/output/{job_id}/{timestamp}.md。

存储使用原子文件写入，确保中断写入不会留下部分写入的任务文件。

自包含提示仍然重要​

重要

Cron 任务在完全全新的代理会话中运行。提示必须包含代理所需的所有内容，除非这些内容已由附加技能提供。

错误示例： "Check on that server issue"

正确示例： "SSH into server 192.168.1.100 as user 'deploy', check if nginx is running with 'systemctl status nginx', and verify https://example.com returns HTTP 200."

安全性计划任务提示在创建和更新时会扫描提示注入和凭证外泄模式。包含隐形Unicode技巧、SSH后门尝试或明显凭证外泄载荷的提示将被阻止。​