logo
icon

OpenAB Hermes

Open Agent Broker — 轻量的 Rust 程序，通过 stdio JSON-RPC 将 Discord 和 Slack 桥接到任何 ACP 兼容的 coding CLI。此模板使用 Nous Research 的 Hermes Agent 作为后端 — 一个 multi-provider inference gateway，通过 OAuth 支持 30+ LLM 供应商（xAI Grok、Anthropic、OpenAI、Nous Portal 等）。 来源：https://github.com/openabdev/openab

template cover
部署次数0 次
发布者zeaburZeabur
创建于2026-05-17
源码查看源码
最低配置2 核心4 GB
推荐配置4 核心8 GB
标签
AIDeveloper ToolsDiscordSlack

模版内的服务

service icon

openab

ghcr.io/openabdev/openab-hermes:0.8.3-beta.10

OpenAB Hermes

OpenAB 是一个轻量的开源 Rust 程序，通过 stdio JSON-RPC 将 Discord 和 Slack 桥接到任何支持 Agent Client Protocol 的 coding CLI。

此模板使用 Hermes 变体：以 Nous Research 的 Hermes Agent 为后端。Hermes 本身是一个 multi-provider inference gateway — 内置管理 OAuth token、认证存储、provider 路由，可对接 30+ LLM 供应商（xAI Grok、Anthropic、OpenAI、Nous Portal 等），OpenAB 不需要自行处理供应商认证。

注意事项

  • 镜像标签： 此模板使用固定版本（0.8.3-beta.10）。如需升级，请在 Zeabur Dashboard → 服务 → 设置中更改镜像标签。可用标签：GitHub Packages。
  • 持久化存储： /home/agent 挂载为持久化磁盘。Hermes 认证、plugins、设置、config 会在重启后保留。
  • 认证只能在容器内进行： Hermes 采用各供应商的 OAuth 流程，没有单一 API key 变量。部署完成后请在服务终端执行 hermes auth add <provider> 来绑定要使用的 LLM 供应商。

设置步骤

1. 获取 Discord Bot Token

  1. 前往 https://discord.com/developers/applications，点击 New Application
  2. 进入 Bot 页签 → 点击 Reset Token → 复制 token
  3. 同一页面往下滑，在 Privileged Gateway Intents 下启用 Message Content Intent
  4. 前往 OAuth2 → URL Generator → 勾选 scope bot → 勾选权限：Send Messages、Send Messages in Threads、Create Public Threads、Read Message History、Add Reactions、Manage Messages
  5. 复制生成的 URL，在浏览器中打开以邀请 Bot 到你的服务器

2. 获取 Discord 频道 ID

  1. 打开 Discord → 前往 用户设置（齿轮图标）→ 高级 → 启用 开发者模式
  2. 右键点击你要 Bot 回应的频道 → 复制频道 ID
  3. 多个频道用逗号分隔：123456789012345678,234567890123456789

3. 部署

填入变量后点击部署即可。服务会自动连接到 Discord，但在你完成步骤 4 认证之前，bot 不会产生任何 LLM 回复。

4. 认证 Hermes Provider

服务启动后，在 Zeabur Dashboard → 服务 → Exec 打开容器终端。Hermes 支持多家供应商，以下是两种常见的选择。

选项 A：Nous Portal（最简单）

runuser -u agent -- hermes auth add nous

按照提示打开显示的 URL 完成 OAuth。

选项 B：xAI Grok OAuth（推荐通用）

⚠️ 需要 SuperGrok 付费订阅（$30/月）。 没有订阅时 auth 仍会成功，但 API 返回空字符串 — bot 看似在运行却不会回复任何消息。

xAI OAuth 使用 loopback 重定向到 127.0.0.1:56121。Zeabur 不暴露此端口，请使用「双终端」流程：

终端 1 — 启动 auth listener：

runuser -u agent -- hermes auth add xai-oauth --no-browser

画面会打印含 &state=XXXXX 的授权 URL，并在 http://127.0.0.1:56121/callback 等待。

在你的浏览器 — 打开该授权 URL → 同意授权。浏览器会被重定向到 http://127.0.0.1:56121/callback?code=... 并显示连接失败（这是预期的）。从地址栏复制 code 的值。

终端 2 — 在 Zeabur 再开一个 Exec session，在容器内把 callback 喂回去：

runuser -u agent -- curl "http://127.0.0.1:56121/callback?code=<CODE>&state=<STATE>"

终端 1 应该会打印 Added xai-oauth OAuth credential #1。code 几秒后就会失效，若出现 invalid_grant 请重新执行 hermes auth add xai-oauth 再试。

认证完成后：选择默认 model

用交互式 picker：

runuser -u agent -- hermes model

…或手动把 provider 和 model 分成两个 key 设置（这是 hermes-acp 能读到的格式 — hermes config set 示例中合并成 provider/model 的写法只有 standalone CLI 能识别，openab spawn 的 hermes-acp 不会生效）：

runuser -u agent -- hermes config set provider xai-oauth
runuser -u agent -- hermes config set model grok-4-latest

设置会写入 /home/agent，重启后仍保留。新的 Discord session 会自动应用新 model，无需重启服务。

其他供应商（Anthropic、OpenAI 等）请参阅 Hermes Agent 文档。

Slack 设置（可选）

OpenAB 支持通过 Socket Mode 连接 Slack，无需公开 URL。

  1. 前往 https://api.slack.com/apps → Create New App → From scratch
  2. Socket Mode → 启用 → 生成 App-Level Token，scope 选 connections:write → 复制 xapp-... token（SLACK_APP_TOKEN）
  3. Event Subscriptions → 启用 → 添加 bot events：app_mention、message.channels、message.groups
  4. OAuth & Permissions → Bot Token Scopes → 添加：app_mentions:read、chat:write、channels:history、groups:history、channels:read、groups:read、reactions:write、files:read、users:read
  5. Install App → 安装到工作区 → 复制 xoxb-... token（SLACK_BOT_TOKEN）
  6. 在每个要使用 Bot 的 Slack 频道执行 /invite @YourAppName

部署前填入 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN 变量。Discord 和 Slack 可同时运行。

添加通讯平台（Telegram / LINE / 飞书 / Google Chat / MS Teams / 企业微信）

若要桥接 Telegram、LINE、飞书/Lark、Google Chat、MS Teams 或企业微信（WeCom），请在同一个 Zeabur 项目中部署 OpenAB Gateway 模板，然后在此服务上设置以下环境变量：

  • GATEWAY_URL = ws://openab-gateway:8080/ws
  • GATEWAY_PLATFORM = telegram、line、feishu、googlechat、teams 或 wecom 之一

重启服务。启动脚本会自动将 [gateway] 块注入 config.toml。

使用方式

  • 在允许的 Discord 或 Slack 频道中 @mention Bot 即可开始对话
  • OpenAB 会自动创建 thread 进行多轮对话 — 后续消息不需要再 @mention
  • 每个 thread 对应一个持久的 Hermes session（默认 24 小时 TTL）

自定义设置

文件说明
/home/agent/.config/openab/config.tomlOpenAB 设置（sessions、reactions、STT 等）
/home/agent/.config/hermes/Hermes 认证与 provider 设置（由 hermes auth / hermes model 管理）

config.toml 在首次启动时从内建模板创建。之后请直接编辑文件，环境变量仅用于初始设置。要恢复默认值请删除后重启：rm /home/agent/.config/openab/config.toml

OpenAB 设置选项请参阅 OpenAB 文档。Hermes provider 选项请参阅 Hermes 文档。

停用

部署时将 Discord Bot Token 和 SLACK_BOT_TOKEN 都留空即可。服务会进入 sleep 状态，不会崩溃。

链接