首页/国产平台接入

国产平台接入指南

Hermes Agent 原生支持微信、企业微信、钉钉、飞书等国产平台。以下是详细的接入教程。

💡 通用前提

  • 已完成 Hermes Agent 安装（参考安装教程）
  • 所有平台配置都写入 ~/.hermes/.env 文件
  • 配置完成后运行 hermes gateway run 启动网关
  • 可以同时启用多个平台，它们共享同一个 Gateway 进程
💬

微信

通过微信个人号或公众号与 Hermes Agent 对话

配置步骤

  1. 获取微信接入 Token（需要第三方桥接服务）
  2. 在 ~/.hermes/.env 中配置 WEIXIN_TOKEN
  3. 运行 hermes gateway setup 选择启用微信
  4. 启动 Gateway：hermes gateway run

环境变量配置

.env
# 微信接入配置 WEIXIN_TOKEN=your_weixin_token # 或使用 Account ID 方式 WEIXIN_ACCOUNT_ID=your_account_id # 可选配置 WEIXIN_BASE_URL= # 自定义服务地址 WEIXIN_CDN_BASE_URL= # CDN 地址 WEIXIN_DM_POLICY= # 私聊策略 WEIXIN_GROUP_POLICY= # 群聊策略 WEIXIN_ALLOWED_USERS= # 允许的用户（逗号分隔） WEIXIN_HOME_CHANNEL= # 默认频道

⚠ 微信接入需要第三方桥接服务支持，官方未直接提供 API。建议使用 WeChatFerry 等开源方案。

🏢

企业微信 (WeCom)

支持两种接入模式：WebSocket 模式和回调模式

配置步骤

  1. 登录企业微信管理后台 (work.weixin.qq.com)
  2. 创建自建应用，获取 Corp ID 和 Secret
  3. 配置应用可见范围和权限
  4. 在 ~/.hermes/.env 中填入对应配置
  5. 启动 Gateway 测试连接

环境变量配置

.env
# === 方式一：WebSocket 模式 === WECOM_BOT_ID=your_bot_id WECOM_SECRET=your_secret # 可选 WECOM_WEBSOCKET_URL= # WebSocket 地址 WECOM_HOME_CHANNEL= # 默认频道 # === 方式二：回调模式 === WECOM_CALLBACK_CORP_ID=your_corp_id WECOM_CALLBACK_CORP_SECRET=your_corp_secret # 可选 WECOM_CALLBACK_AGENT_ID= # 应用 Agent ID WECOM_CALLBACK_TOKEN= # 回调 Token WECOM_CALLBACK_ENCODING_AES_KEY= # 加密 Key WECOM_CALLBACK_HOST=0.0.0.0 # 监听地址 WECOM_CALLBACK_PORT=8645 # 监听端口

⚠ WebSocket 模式更简单，回调模式需要公网可访问的服务器地址。

📌

钉钉 (DingTalk)

通过钉钉机器人与 Hermes Agent 对话

配置步骤

  1. 登录钉钉开放平台 (open.dingtalk.com)
  2. 创建企业内部应用或机器人
  3. 获取 Client ID（AppKey）
  4. 配置机器人回调地址（如需要）
  5. 在 ~/.hermes/.env 中配置 DINGTALK_CLIENT_ID
  6. 启动 Gateway 测试连接

环境变量配置

.env
# 钉钉接入配置 DINGTALK_CLIENT_ID=your_client_id

⚠ 钉钉配置相对简单，只需要 Client ID 即可。建议先在测试群中调试。

🪶

飞书 (Feishu / Lark)

支持飞书国内版和 Lark 国际版，WebSocket 和 Webhook 两种连接方式

配置步骤

  1. 登录飞书开放平台 (open.feishu.cn)
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret
  4. 配置机器人能力，开启消息接收
  5. 添加所需权限（消息读写等）
  6. 在 ~/.hermes/.env 中配置环境变量
  7. 选择连接方式：WebSocket（推荐）或 Webhook
  8. 启动 Gateway 测试连接

环境变量配置

.env
# 飞书接入配置 FEISHU_APP_ID=your_app_id FEISHU_APP_SECRET=your_app_secret # 可选配置 FEISHU_DOMAIN=feishu # feishu（国内）或 lark（国际） FEISHU_CONNECTION_MODE=websocket # websocket 或 webhook FEISHU_ENCRYPT_KEY= # 加密 Key（Webhook 模式需要） FEISHU_VERIFICATION_TOKEN= # 验证 Token（Webhook 模式需要） FEISHU_HOME_CHANNEL= # 默认频道 ID

⚠ WebSocket 模式无需公网服务器，推荐首选。Lark 国际版将 FEISHU_DOMAIN 设为 lark 即可。

§ 启动 Gateway

配置完环境变量后，启动 Gateway 即可连接所有已配置的平台：

bash
# 交互式配置（首次使用推荐） hermes gateway setup # 前台运行（可以看到实时日志） hermes gateway run # Linux/macOS 后台服务 hermes gateway start # 查看状态 hermes gateway status

⚠ Windows 注意：Gateway 后台服务管理（start/stop/install）不支持 Windows。Windows 上只能用 hermes gateway run 前台运行，或通过 WSL2。

其他国际平台

除国产平台外，Hermes Agent 还支持以下国际平台，配置方法请参考官方文档：

Telegram
Discord
Slack
WhatsApp
Signal
Email
Matrix
Mattermost
SMS
Home Assistant
BlueBubbles
Webhook