需配置消息通道与推送规则：一、飞书机器人需创建应用、开通权限、配置Webhook并写入config.yaml；二、Telegram Bot需通过@BotFather获取Token并限制allowed_users；三、企微需配置可信IP与加解密参数；四、终端日志可用tail+grep监听；五、钉钉需设置关键词过滤与签名验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已成功部署 Hermes Agent，但希望其在执行任务、状态变更或外部事件触发时主动向您推送通知，则需配置对应的消息通道与推送规则。以下是实现该功能的具体操作步骤：
一、启用飞书机器人通知
飞书机器人可作为稳定可靠的通知出口，支持私聊与群聊消息推送，并能接收服务端 Webhook 事件触发的主动通知。需先在飞书开放平台创建应用并开通机器人能力。
1、访问 https://open.feishu.cn，使用企业管理员账号登录飞书开放平台。
2、点击“创建应用”，选择“企业自建应用”，填写名称如“Hermes Notify”，描述为“Hermes Agent 状态通知专用机器人”。
3、进入应用详情页，点击“添加应用能力”，勾选“机器人”并保存。
4、在“权限管理”中开通以下权限：im:message:收发消息、contact:user.id:readonly、im:message.group_at_msg（如需群内推送）。
5、在“凭证与基础信息”页记录 App ID 与 App Secret；在“事件订阅”页配置 URL 为 https://your-server-ip:3000/webhook/feishu，并订阅 im.message.receive_v1 事件。
6、编辑 ~/.hermes/config.yaml，在 gateways 下添加飞书配置段并设 enabled: true，填入 App ID、App Secret、verification_token 及 encrypt_key（若启用加密）。
二、配置 Telegram Bot 推送通道
Telegram Bot 提供轻量级、低延迟的单向通知能力，适合监控告警类场景，无需复杂鉴权，仅需 Bot Token 即可完成集成。
1、在 Telegram 中搜索并私聊 @BotFather，发送指令 /newbot。
2、按提示设置 Bot 名称（如 hermes-notify-bot）和用户名（必须以 _bot 结尾），获取 Bot Token。
3、将 Bot Token 添加至 Hermes 配置文件：~/.hermes/config.yaml 中 gateways.telegram 段下，设置 enabled: true 与 bot_token 字段。
4、在 allowed_users 列表中填入您的 Telegram 用户 ID（可通过 @userinfobot 获取），确保仅您本人可接收通知。
5、执行 hermes restart 使配置生效；随后在 Telegram 中搜索并私聊该 Bot，即可接收 Hermes Agent 发出的状态通知。
三、启用企业微信应用消息推送
企业微信适用于组织内部通知分发，支持消息加密、可信 IP 白名单及会话上下文保持，适合部署在私有网络环境中的 Hermes Agent 使用。
1、登录企业微信管理后台，进入【应用管理】→【自建】→【创建应用】，填写应用名称（如“Hermes 告警中心”）与描述。
2、在应用详情页复制“接收消息 URL”，格式为 https://your-server-ip/webhook/wecom；同时记录 Token 与 EncodingAESKey。
3、在【可信 IP】列表中添加 Hermes Agent 所在服务器的公网 IP 地址。
4、编辑 ~/.hermes/config.yaml，在 gateways.wecom 下配置 enabled: true、token、encoding_aes_key 与 endpoint（即上述 URL）。
5、重启 Hermes Agent 后，在企业微信客户端中搜索该应用，关注后即可接收由 Hermes 主动推送的任务完成、模型异常等通知消息。
四、配置本地终端日志通知开关
当未启用外部消息通道时，Hermes Agent 默认将关键事件写入终端 stdout 与 ~/.hermes/logs/ 目录下的时间戳日志文件，可通过系统级工具捕获并转为通知。
1、确认 Hermes 运行时启用日志输出：启动命令中不加 --quiet 参数，或检查 ~/.hermes/config.yaml 中 logging.level 是否设为 info 或 debug。
2、使用 Linux tail + grep 组合监听日志变化，例如：tail -f ~/.hermes/logs/hermes-$(date +%Y-%m-%d).log | grep -E "(ERROR|ALERT|TASK_COMPLETED)"。
3、将匹配结果通过 mail、notify-send 或 curl 转发至邮件、桌面弹窗或 Webhook 服务。
4、将该命令写入 systemd service 文件或 crontab，实现后台常驻监听与即时响应。
五、启用钉钉自定义机器人通知
钉钉自定义机器人支持关键词过滤与安全校验（签名或 IP 白名单），适合作为生产环境的通用通知通道，兼容文本、链接与 Markdown 格式。
1、在目标钉钉群中点击右上角【群设置】→【智能群助手】→【添加机器人】→【自定义】。
2、设置机器人名称（如“Hermes Alert”），开启“自定义关键词”，添加 [HERMES] 作为触发词；复制 Webhook 地址（含 access_token 参数）。
3、在 ~/.hermes/config.yaml 的 gateways.dingtalk 段中配置 enabled: true 与 webhook_url 字段，URL 中不可省略 timestamp 与 sign 参数（如需签名验证）。
4、配置 message_format: markdown（支持粗体、链接、引用块），并设定 notify_keywords: ["ERROR", "TIMEOUT", "DEPLOYED"] 以控制推送粒度。
5、执行 hermes restart 后，Hermes Agent 将在满足关键词条件时，向该钉钉群发送结构化通知消息。
