词元之母TOK.MOM - 平台充值汇率 1:1 即 1 人民币充值到账 1 美元,支持一个 Key 调用近 600+ 海内外模型,限时特价模型低至 1 折,欢迎上岸!
hermes send 是一个轻量、可脚本化的 CLI,能将消息推送到 Hermes 已配置的任意消息平台。可以把它理解为跨平台的通知专用 curl——无需运行中的 gateway,无需 LLM,也无需在每个脚本里重复粘贴 bot token。make | hermes send --to slack:#builds)hermes gateway 已有的凭据和平台适配器,无需维护第二套配置。| 标志 | 说明 |
|---|---|
-t, --to TARGET | 目标地址。参见目标格式。 |
message(位置参数) | 消息文本。省略时从 --file 或 stdin 读取。 |
-f, --file PATH | 从文件读取消息体。--file - 强制从 stdin 读取。 |
-s, --subject LINE | 在消息体前添加标题/主题行。 |
-l, --list | 列出可用目标。可选位置参数用于按平台过滤。 |
-q, --quiet | 成功时不输出到 stdout(仅返回退出码——适合脚本使用)。 |
--json | 输出发送结果的原始 JSON。 |
-h, --help | 显示内置帮助文本。 |
| 格式 | 示例 | 含义 |
|---|---|---|
platform | telegram | 发送到该平台配置的默认频道 |
platform:chat_id | telegram:-1001234567890 | 指定数字 chat / 群组 / 用户 |
platform:chat_id:thread_id | telegram:-1001234567890:17585 | 指定线程或 Telegram 论坛话题 |
platform:#channel | discord:#ops | 易读的频道名称(通过频道目录解析) |
platform:+E164 | signal:+15551234567 | 以电话号码寻址的平台:Signal、SMS、WhatsApp |
telegram、discord、slack、signal、sms、whatsapp、matrix、mattermost、feishu、dingtalk、wecom、weixin、email 等。| 码 | 含义 |
|---|---|
0 | 发送(或列出)成功 |
1 | 平台层面投递失败(认证、权限、网络) |
2 | 用法 / 参数 / 配置错误 |
curl 或 grep 一样对其进行分支判断。hermes send 按以下顺序解析消息体:hermes send --to telegram "hi"--file PATH — hermes send --to telegram --file msg.txtecho hi | hermes send --to telegramcurl https://api.telegram.org/... 调用:hermes send 复用你的 Hermes 配置,同一脚本可在任何安装了 Hermes 的主机上运行——无需手动将 bot token 导出到每台机器的环境变量中。curl 调用,而非 hermes send。如果 Python 解释器因机器抖动无法加载,你仍然希望告警能发出去。--json 与 --quiethermes send 需要 gateway 运行吗?hermes send 直接使用 ~/.hermes/.env 和 ~/.hermes/config.yaml 中的凭据调用平台的 REST 接口。它是一个独立的子进程,消息投递完成后即退出。hermes gateway start 后重试即可。~/.hermes/channel_directory.json,gateway 运行期间每隔几分钟刷新一次。如果看到"尚未发现频道",请先启动一次 gateway(hermes gateway start)以填充缓存。discord:#ops、slack:#engineering)在发送时通过该缓存解析,无需记忆数字 ID。| 方案 | 多平台 | 复用 Hermes 凭据 | 需要 gateway | 最适合 |
|---|---|---|---|---|
hermes send | ✅ | ✅ | 否(bot token) | 以下所有场景 |
对各平台直接 curl | 各自单独编写 | 手动管理 | 否 | 关键 watchdog |
带 --deliver 的 cron 任务 | ✅ | ✅ | 否 | 定时 agent 任务 |
send_message agent 工具 | ✅ | ✅ | 否 | agent 循环内部 |
hermes send 有意保持最简接口。如果需要 agent 决定说什么,请在对话或 cron 任务中使用 send_message 工具。如果需要定时运行并生成 LLM 内容,请使用带 deliver='telegram:...' 的 cronjob(action='create', prompt=...)。如果只需要管道传输原始字符串,直接用 hermes send。