消息网关概览
Hermes 消息网关让你可以通过 14+ 个主流即时通讯平台与 Agent 交互，实现真正的「一个 Agent，随处可用」。
支持的平台
| 平台 | 类型 | 说明 |
|---|---|---|
| Telegram | 即时通讯 | 支持文字、语音、图片、文件，支持群组 |
| Discord | 即时通讯 | 支持文字、语音频道，支持服务器部署 |
| Slack | 团队协作 | 支持工作区 Bot，适合企业使用 |
| 即时通讯 | 通过 WhatsApp Web 桥接，需 Node.js v22 | |
| Signal | 即时通讯 | 注重隐私的加密通讯平台 |
| SMS（Twilio） | 短信 | 通过 Twilio 收发短信，支持手机号触达 |
| 邮件 | 通过 SMTP/IMAP 收发邮件 | |
| Home Assistant | 智能家居 | 与 Home Assistant 语音助手集成 |
| Mattermost | 团队协作 | 开源团队聊天平台 |
| Matrix | 去中心化 | 开放协议，支持 Element 等客户端 |
| DingTalk（钉钉） | 企业协作 | 阿里钉钉机器人接入 |
| Feishu/Lark（飞书） | 企业协作 | 字节跳动飞书机器人接入 |
| WeCom（企业微信） | 企业协作 | 腾讯企业微信机器人接入 |
| Open WebUI | Web 界面 | 浏览器 Web UI，无需安装客户端 |
| Webhooks | 开发者 | 接收外部事件并自动处理 |
快速开始
第一步：配置平台
运行配置向导，选择要接入的平台并填写相关 Token：
bash
hermes gateway setup向导会引导你逐步完成每个平台的配置，所有 Token 和密钥保存在 ~/.hermes/.env 中。
第二步：安装为系统服务
将网关安装为后台服务，开机自动启动：
bash
# 用户级服务（推荐）
hermes gateway install
# 系统级服务（需要 root 权限，多用户共享）
sudo hermes gateway install --system第三步：启动网关
bash
hermes gateway start查看运行状态：
bash
hermes gateway status停止网关：
bash
hermes gateway stop网关管理命令
| 命令 | 说明 |
|---|---|
hermes gateway setup | 交互式配置向导 |
hermes gateway install | 安装为用户级系统服务 |
hermes gateway install --system | 安装为系统级服务（需 sudo） |
hermes gateway start | 启动网关 |
hermes gateway stop | 停止网关 |
hermes gateway status | 查看网关状态 |
聊天内置命令
所有平台均支持以下聊天内置命令（在聊天窗口中直接发送）：
| 命令 | 说明 |
|---|---|
/new | 开始一个新的对话会话（清除上下文） |
/reset | 重置当前会话，清除历史记录 |
/model | 切换 AI 模型 |
/voice | 切换语音回复模式（开启/关闭） |
/background | 将当前任务转为后台执行（长时间任务） |
/reload-mcp | 重新加载 MCP 服务器配置 |
/help | 显示所有可用命令列表 |
用户授权
默认拒绝策略
Hermes 网关采用默认拒绝安全策略：只有明确授权的用户才能与 Agent 交互，防止未授权访问。
配置允许用户
在 ~/.hermes/.env 中设置允许的用户 ID（不同平台的变量名不同）：
bash
# Telegram：填写用户数字 ID
TELEGRAM_ALLOWED_USERS=123456789,987654321
# Discord：填写用户数字 ID
DISCORD_ALLOWED_USERS=123456789012345678
# Slack：填写用户 ID（格式如 U01XXXXXXX）
SLACK_ALLOWED_USERS=U01ABC123,U01DEF456通过 DM 配对授权
部分平台（如 Telegram）支持动态配对授权：
- 用户向机器人发起私聊并发送配对请求
- 管理员运行
hermes pairing approve <请求ID>批准 - 该用户即获得访问权限
撤销已授权用户：
bash
hermes pairing revoke <用户ID>多平台同时运行
网关支持同时运行多个平台。所有平台共享同一个 Hermes Agent 实例，会话和记忆在平台间独立隔离（每个平台用户有独立的对话上下文）。
系统服务说明
用户级服务（推荐）
bash
hermes gateway install- 服务以当前用户身份运行
- 使用 systemd user service（Linux）或 launchd（macOS）
- 不需要 root 权限
- 仅在用户登录时运行
系统级服务
bash
sudo hermes gateway install --system- 服务以系统身份运行，开机自动启动
- 适合服务器部署场景
- 需要确保配置文件和环境变量对服务账户可访问
查看服务日志
bash
# Linux（systemd）
journalctl --user -u hermes-gateway -f
# macOS
tail -f ~/Library/Logs/hermes-gateway.log