Hermes Agent 脚本输出管道：将 Agent 输出接入外部工具

hermes send 是一个小巧、可脚本化的 CLI 工具，可以将消息推送到 Hermes 已配置的任何消息平台。你可以把它当作跨平台的 curl 通知工具——不需要运行中的 gateway、不需要 LLM，也不需要在每个脚本中重复粘贴 bot token。

适用场景：

• 系统监控（内存、磁盘、GPU 温度、长时间任务完成通知）
• CI/CD 通知（部署完成、测试失败）
• Cron 脚本需要将结果推送给你
• 终端中快速发送一次性消息
• 将任何工具的输出管道转发到任何地方（make | hermes send --to slack:#builds）

该命令复用了 hermes gateway 已有的凭据和平台适配器，因此无需维护第二套配置。

快速开始

# 发送纯文本到平台的默认频道
hermes send --to telegram "deploy finished"

# 从任何命令的 stdout 管道输入
echo "RAM 92%" | hermes send --to telegram:-1001234567890

# 发送文件
hermes send --to discord:#ops --file /tmp/report.md

# 附加主题/标题行
hermes send --to slack:#eng --subject "[CI] build.log" --file build.log

# 发送到线程目标（Telegram topic、Discord thread）
hermes send --to telegram:-1001234567890:17585 "threaded reply"

# 列出所有已配置的目标
hermes send --list

# 按平台过滤
hermes send --list telegram

参数参考

目标格式

Hermes 提供适配器的任何平台都可作为目标： telegram、discord、slack、signal、sms、whatsapp、matrix、mattermost、feishu、dingtalk、wecom、weixin、email 等。

退出码

退出码遵循标准 Unix 惯例，你的脚本可以像处理 curl 或 grep 一样进行分支判断。

消息体解析顺序

hermes send 按以下顺序解析消息体：

1. 位置参数 — hermes send --to telegram "hi"
2. --file PATH — hermes send --to telegram --file msg.txt
3. 管道 stdin — echo hi | hermes send --to telegram

当 stdin 是 TTY（无管道）时，Hermes 不会等待输入——而是返回清晰的用法错误。这可以防止脚本因意外省略消息体而挂起。

实际应用示例

监控：内存 / 磁盘告警

用一条可移植的命令替换监控脚本中临时的 curl https://api.telegram.org/... 调用：

#!/usr/bin/env bash
ram_pct=$(free | awk '/^Mem:/ {printf "%d", $3 * 100 / $2}')
if [ "$ram_pct" -ge 85 ]; then
  hermes send --to telegram --subject "⚠ MEMORY WARNING" \
    "RAM ${ram_pct}% on $(hostname)"
fi

由于 hermes send 复用了 Hermes 配置，同一脚本在安装了 Hermes 的任何主机上都能正常工作——无需手动将 bot token 导出到每台机器的环境变量中。

提示：不要通过 gateway 告警 gateway 自身的问题 对于可能在 gateway 自身出问题时触发的监控（OOM 告警、磁盘满告警），请继续使用最小化的 curl 调用而非 hermes send。如果 Python 解释器因系统资源耗尽而无法加载，你仍然需要那个告警能够发出。

CI / CD：构建和测试结果

# 在 .github/workflows/deploy.yml 或任何 CI 脚本中
if ./scripts/deploy.sh; then
  hermes send --to slack:#deploys "✅ ${CI_COMMIT_SHA:0:7} deployed"
else
  tail -n 100 deploy.log | hermes send \
    --to slack:#deploys --subject "❌ deploy failed"
  exit 1
fi

Cron：每日报告

# Crontab 条目
0 9 * * * /usr/local/bin/generate-metrics.sh \
  | /home/me/.hermes/bin/hermes send \
      --to telegram --subject "Daily metrics $(date +%Y-%m-%d)"

长时间运行任务：完成时通知

./train.py --epochs 200 && \
  hermes send --to telegram "training done" || \
  hermes send --to telegram "training failed (exit $?)"

使用 --json 和 --quiet 进行脚本编程

# 投递失败时脚本硬终止；成功时不污染日志
hermes send --to telegram --quiet "keepalive" || {
  echo "Telegram delivery failed" >&2
  exit 1
}

# 捕获消息 ID 用于后续编辑/线程化
msg_id=$(hermes send --to discord:#ops --json "build started" \
  | jq -r .message_id)

hermes send 是否需要 Gateway 运行？

通常不需要。 对于任何使用 bot token 的平台——Telegram、Discord、Slack、Signal、SMS、WhatsApp Cloud API 及大多数其他平台——hermes send 使用 ~/.hermes/.env 和 ~/.hermes/config.yaml 中的凭据直接调用平台的 REST 端点。它是一个独立的子进程，消息投递后即退出。

只有插件平台需要运行中的 gateway——这些平台依赖持久适配器连接（例如，保持长连接 WebSocket 的自定义插件）。在这种情况下，你会收到明确的错误提示指向 gateway；使用 hermes gateway start 启动后重试即可。

列出和发现目标

在发送到特定频道之前，你可以先查看可用目标：

# 所有已配置平台的所有目标
hermes send --list

# 仅 Telegram 目标
hermes send --list telegram

# 机器可读格式
hermes send --list --json

目标列表基于 ~/.hermes/channel_directory.json 构建，gateway 运行期间每隔几分钟刷新一次。如果你看到 "no channels discovered yet"，请先启动 gateway（hermes gateway start）让它填充缓存。

人类可读的名称（discord:#ops、slack:#engineering）在发送时根据此缓存解析，因此你无需记忆数字 ID。

与其他方案的对比

hermes send 的设计理念是尽可能简单。如果你需要 agent 来决定发送什么内容，请在聊天或 cron 任务中使用 send_message 工具。如果你需要定时运行并生成 LLM 内容，使用 cronjob(action='create', prompt=...) 配合 deliver='telegram:...'。如果你只需要管道传递原始字符串，就用 hermes send。

相关文档

• 使用 Cron 自动化一切 — 定时任务，输出自动投递到任何平台。
• Gateway 内部机制 — hermes send 与 cron 投递共享的投递路由器。
• 消息平台配置 — 各平台的一次性配置指南。