Hermes Agent不弹出通知时，如何修复和设置？

本文共计1012个文字，预计阅读时间需要5分钟。

如果您已配置Hermes Agent的通知功能，但系统提醒或消息弹窗未正常触发，可能的原因包括：

一、检查并启用桌面通知权限

Hermes Agent 依赖操作系统级桌面通知 API（如 Linux 的 D-Bus、macOS 的 Notification Center、Windows 的 Toast API），若权限被禁用或未授权，将无法弹出提醒。

1、在 Linux 系统中，确认已安装并运行 notify-send 工具：which notify-send，若无输出，请执行 sudo apt install libnotify-bin（Ubuntu/Debian）或 brew install terminal-notifier（macOS）。

2、在 macOS 上，打开“系统设置 → 通知与焦点 → Hermes Agent”，确保“允许通知”和“在屏幕顶部显示横幅”已开启。

3、在 Windows 上，进入“设置 → 系统 → 通知 → Hermes Agent”，确认开关为开启状态，并检查“通知样式”是否设为“横幅和声音”。

二、验证 Gateway 服务是否正常运行

弹窗提醒由 Hermes Agent 的 Gateway 模块统一调度，若 Gateway 未启动或异常退出，则所有通知通道均失效。

1、在终端中执行 hermes gateway status，确认输出为 running 且 PID 存在。