消息网关与平台接入

Hermes Gateway 是一个后台进程，用来把 Hermes 接到多个消息平台。它负责接收消息、维护每个 chat 的 session、调用 agent、运行 cron，并把结果发回原平台。

支持的平台

Gateway 覆盖 Telegram、Discord、Slack、WhatsApp、Signal、SMS、Email、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、Weixin、BlueBubbles、QQ、Yuanbao 和浏览器入口。不同平台支持能力不同：Telegram、Discord、Slack、Mattermost、Matrix、Feishu 等支持更完整的文件、图片、线程、typing 或 streaming；SMS 和 Home Assistant 更偏轻量文本控制。

语音相关能力集中在 Voice Mode 文档里，包括 CLI 麦克风、消息平台语音转写、TTS 回复和 Discord voice channel。

快速配置

最简单的入口是交互式 wizard：

hermes gateway setup

它会列出平台、显示当前配置状态，并在结束后询问是否启动或重启 gateway。

常用服务命令：

hermes gateway
hermes gateway install
hermes gateway start
hermes gateway stop
hermes gateway status

Linux 上也可以安装 system service：

sudo hermes gateway install --system
sudo hermes gateway start --system
sudo hermes gateway status --system

聊天内命令

消息平台里可以直接发 slash command：

• /new 或 /reset：新会话。
• /model [provider:model]：查看或切换模型。
• /retry、/undo、/stop：重试、撤销、中止。
• /status、/usage、/insights：查看状态和使用情况。
• /approve、/deny：处理危险命令审批。
• /background <prompt>：后台运行一个独立任务。
• /reload-mcp：重新加载 MCP server。
• /<skill-name>：调用已安装 skill。

安全默认值

Gateway 默认拒绝未 allowlist 或未配对的用户，这是正确默认值，因为 bot 可能有 terminal 权限。推荐显式配置允许用户：

TELEGRAM_ALLOWED_USERS=123456789,987654321
DISCORD_ALLOWED_USERS=123456789012345678
EMAIL_ALLOWED_USERS=trusted@example.com,colleague@work.com

全局 allowlist：

GATEWAY_ALLOWED_USERS=123456789,987654321

GATEWAY_ALLOW_ALL_USERS=true 只适合完全受控环境，不建议给有终端权限的 bot 使用。

中断、排队和后台任务

默认行为是：忙碌时你再发一条消息，会中断当前任务。也可以改成 queue 或 steer：

display:
  busy_input_mode: steer
  busy_ack_enabled: true

长任务用后台 session：

/background Check all servers in the cluster and report any that are down

后台任务会继承当前 provider、toolsets、reasoning 和路由配置，但拥有独立 session。完成后结果会回到发起任务的同一个 chat。