更多平台

除主要平台外，Hermes 还支持以下平台的接入。所有平台均通过 hermes gateway setup 配置，通过 hermes gateway start 统一启动。

---

Signal

Signal 是注重隐私的加密通讯平台，适合对安全性有较高要求的使用场景。

配置要求：

• 需要一个专用手机号注册 Signal 账号
• 通过 signal-cli 或 signal-cli-rest-api 作为桥接层

环境变量：

SIGNAL_PHONE_NUMBER=+8613812345678
SIGNAL_ALLOWED_USERS=+8613900139000

---

SMS（Twilio）

通过 Twilio 短信服务，让普通手机号也能与 Hermes 对话，无需安装任何 App。

配置要求：

• 注册 Twilio 账号并购买一个电话号码
• 配置 Twilio Webhook 指向 Hermes 网关

环境变量：

TWILIO_ACCOUNT_SID=ACxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_AUTH_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
TWILIO_PHONE_NUMBER=+1234567890
TWILIO_ALLOWED_USERS=+8613812345678

适用场景： 无智能手机或不便安装 App 的用户；通过短信触达非技术用户。

---

Email

通过电子邮件与 Hermes 交互，发送邮件即可提问，回复会发回你的邮箱。

配置要求：

• 一个专用邮箱账号（Gmail、Outlook 或自建邮件服务器）
• 配置 SMTP（发信）和 IMAP（收信）

环境变量：

EMAIL_ADDRESS=hermes-bot@example.com
EMAIL_PASSWORD=your-app-password
EMAIL_SMTP_HOST=smtp.gmail.com
EMAIL_SMTP_PORT=587
EMAIL_IMAP_HOST=imap.gmail.com
EMAIL_IMAP_PORT=993
EMAIL_ALLOWED_SENDERS=you@example.com,colleague@example.com

使用提示： Gmail 需要开启「应用专用密码」，不能使用账号主密码。

---

Home Assistant

与开源智能家居平台 Home Assistant 集成，通过语音助手或自动化流程触发 Hermes。

配置要求：

• 运行中的 Home Assistant 实例
• Home Assistant 的长期访问令牌（Long-lived Access Token）

环境变量：

HOME_ASSISTANT_URL=http://192.168.1.100:8123
HOME_ASSISTANT_TOKEN=eyJhbGciOiJIUzI1NiJ9...

使用场景：

• 通过语音助手（如 Assist）对话
• 在自动化中调用 Hermes 分析传感器数据
• 家居控制与 AI 对话结合

---

Mattermost

Mattermost 是开源的团队聊天平台，可自建部署，适合对数据主权有要求的团队。

配置要求：

• Mattermost 服务器（v7.0+）
• Bot 账号的访问令牌

环境变量：

MATTERMOST_URL=https://mattermost.your-company.com
MATTERMOST_TOKEN=xxxxxxxxxxxxxxxxxxxxxxxx
MATTERMOST_ALLOWED_USERS=username1,username2

---

Matrix

Matrix 是去中心化、端对端加密的开放通讯协议，支持 Element、Cinny 等多种客户端。

配置要求：

• Matrix 账号（可在 matrix.org 注册，或自建 Homeserver）
• Bot 账号的访问令牌

环境变量：

MATRIX_HOMESERVER=https://matrix.org
MATRIX_USER_ID=@hermes-bot:matrix.org
MATRIX_ACCESS_TOKEN=syt_xxxxxxxxxxxxxxxxxx
MATRIX_ALLOWED_USERS=@you:matrix.org

---

DingTalk（钉钉）

阿里巴巴钉钉企业协作平台，广泛用于中国企业内部沟通。

配置要求：

• 钉钉开放平台企业内部应用
• 机器人 AppKey 和 AppSecret

环境变量：

DINGTALK_APP_KEY=dingxxxxxxxxxxxxxxxx
DINGTALK_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
DINGTALK_ALLOWED_USERS=user1,user2

配置步骤：

1. 登录钉钉开放平台
2. 创建企业内部应用
3. 开通消息收发权限
4. 获取 AppKey 和 AppSecret

---

Feishu/Lark（飞书）

字节跳动飞书（国内）/ Lark（海外）企业协作平台。

配置要求：

• 飞书开放平台自建应用
• App ID 和 App Secret

环境变量：

FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
FEISHU_ALLOWED_USERS=ou_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

配置步骤：

1. 登录飞书开放平台
2. 创建企业自建应用
3. 开通「接收消息」和「发送消息」权限
4. 配置事件订阅（消息事件）

---

WeCom（企业微信）

腾讯企业微信，广泛用于中国企业内部沟通与协作。

配置要求：

• 企业微信应用（在企业微信管理后台创建）
• Corp ID、AgentID 和 Secret

环境变量：

WECOM_CORP_ID=ww_xxxxxxxxxxxxxxxx
WECOM_AGENT_ID=1000000
WECOM_SECRET=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
WECOM_TOKEN=xxxxxxxx
WECOM_ENCODING_AES_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

---

Open WebUI

通过浏览器 Web 界面使用 Hermes，无需安装任何客户端 App。

配置要求：

• Hermes 网关运行中
• 浏览器可访问网关地址

访问方式：

# 启动网关后，浏览器访问
http://localhost:8765

Open WebUI 提供与 ChatGPT 类似的界面，支持：

• 多会话管理
• 文件上传
• 对话历史浏览
• Markdown 渲染

---

Webhook 订阅

Webhook 允许外部服务（如 GitHub、Jira、监控系统）向 Hermes 推送事件，自动触发 AI 处理。

创建 Webhook 订阅

hermes webhook subscribe \
  --prompt "分析这个 GitHub Push 事件，总结代码变更内容" \
  --events "push,pull_request,issues" \
  --description "GitHub 代码仓库事件处理" \
  --skills "code-review" \
  --deliver chat \
  --deliver-chat-id 123456789 \
  --secret my-webhook-secret

选项说明

选项	说明
--prompt	收到事件时发送给 Agent 的处理提示词
--events	订阅的事件类型（逗号分隔）
--description	Webhook 用途描述
--skills	处理时加载的技能列表
--deliver	结果投递方式（chat / email）
--deliver-chat-id	投递目标的聊天 ID（Telegram 用户 ID 等）
--secret	用于验证 Webhook 签名的密钥

Webhook 端点

创建订阅后，Hermes 会返回一个 Webhook URL：

https://your-server.example.com/webhook/abc123def456

将此 URL 配置到外部服务（如 GitHub Repository Settings -> Webhooks）即可。

使用场景示例

场景	配置
GitHub PR 自动审查	订阅 pull_request 事件，提示词设为代码审查任务
服务器告警分析	监控系统推送告警，Hermes 自动分析并发送诊断建议
每日数据报表	结合 hermes cron 定时触发数据分析任务
CI/CD 构建通知	订阅构建失败事件，自动分析错误日志