跳转到主要内容
Hermes Agent 是 Nous Research 出的多供应商 AI Agent 框架,支持 OAuth、API key、自定义 endpoint 等多种接入方式,可以接 Telegram / Discord / Slack / WhatsApp / Signal 等通讯平台。 在俄罗斯用 RuAPI 比 Nous Portal 方便在哪、不用境外银行卡怎么付模型费用,简要说明见 www.ruapi.ai/hermes-agent-v-rossii;下面是具体设置步骤。 对接 RuAPI 有两种方式:装 RuAPI 插件(推荐,已收录进 Hermes 官方插件目录),或者用 Hermes 自带的 “Custom endpoint”(OpenAI 兼容)模式。

前置条件

1

RuAPI 账号 + API key

控制台 → 令牌管理 创建一把 sk-...。
2

操作系统

Linux、WSL2、Windows 10/11 和 Apple Silicon 的 macOS 都在 Hermes 的第一档支持(Tier 1)里。Windows 和 Apple Silicon 的 macOS 另有带桌面应用的 Hermes Desktop 安装包。

安装 Hermes

一行安装:
装完新开一个终端窗口,或者重新加载 shell 配置:zsh(macOS 默认)用 source ~/.zshrc,bash 用 source ~/.bashrc。
验证:
如果有东西跑不起来,运行 hermes doctor,它会列出缺了哪些组件、怎么修。

方式一:装 RuAPI 插件(推荐)

RuAPI 插件已收录进 Hermes 官方插件目录,需要 Hermes 0.21.5 或更新版本。装上后会多出两个 provider,共用一把 key:
  • ruapi:Claude 系列,走 Anthropic 原生接口,Hermes 的提示缓存和思考设置都能用上;
  • ruapi-openai:GPT、Gemini、DeepSeek、Qwen、GLM、Kimi 等其他模型,走 OpenAI 兼容接口。
1

安装插件

2

填 API key

也可以跑 hermes setup,向导里会问 RUAPI_API_KEY。
3

选模型

跑 hermes model,选 RuAPI(Claude)或 RuAPI (OpenAI-compatible)(其他模型),再选具体模型。也可以启动时直接指定:
模型列表按你账号能用的模型自动生成,图片和视频模型不列。插件源码:RuAPI-ai/hermes-provider-ruapi。

方式二:不装插件,用 Custom endpoint

跑配置向导:
按下面顺序选:
1

选 'Custom endpoint'

向导会列出所有内置 provider(Nous Portal / OpenRouter / Anthropic / OpenAI / ……)。下拉到底部,选 Custom endpoint (self-hosted / VLLM / etc.)。
2

填 base URL

因为走的是 OpenAI 兼容协议,末尾 必须 带 /v1。
3

填 API key

粘贴你的 RuAPI 令牌 sk-...。Hermes 会把它存到 ~/.hermes/.env。
4

给这个连接起个名

比如 RuAPI。Hermes 会自动建一个对应的 credential pool。
5

选模型

向导会问要默认用哪个 model。常用:
  • GPT 系列(OpenAI 系)
  • Claude 系列(Anthropic 系,OpenAI 兼容协议下也能调)
  • DeepSeek、Kimi、GLM 等
具体可用名以价格页为准,完整列表在 价格页。
向导写完会自动把配置存到 ~/.hermes/config.yaml:

第一次验证

启动 CLI:
进交互界面后随便问一句:
正常拿到回复 + RuAPI 控制台 → 使用日志 有对应记录 = 成功。

切换模型

会话内:
或者退出会话,重跑 hermes model 改默认。 日常对话和智能体的例行任务,用 deepseek-flash 就够了,价格只有 Claude Sonnet 的几分之一;Hermes 每次请求常常带着很长的历史,省下的更明显。装了 RuAPI 插件就这样启动:hermes --provider ruapi-openai --model deepseek-flash(用 Custom endpoint 的话是 /model custom:deepseek-flash)。碰到难活再换成 Claude:/model claude-sonnet-5-5(用 Custom endpoint 的话是 /model custom:claude-sonnet-5-5)。装了插件、想让 Claude 走原生的 RuAPI 提供方(有缓存和 thinking),在 hermes model 里选它。

配置 Telegram / Discord 等渠道

模型对接完之后,跑 gateway 设置:
按向导填 Telegram Bot Token 等,gateway 跑起来后,发消息就会用 RuAPI 处理。详见 Hermes Messaging Gateway 文档。

常见问题

  • 确认 ~/.hermes/.env 里那一行 API key 是你的 RuAPI 令牌,没拼错。
  • 控制台 → 令牌管理 看 key 状态。
  • 模型 ID 没在 RuAPI 上线。去 价格页 看可用列表。
  • base_url 末尾要带 /v1。
Hermes 内置的 Anthropic 走 OAuth + Claude Max 订阅,对接第三方 Anthropic 兼容网关需要额外的 base URL 覆盖、不一定稳。Custom endpoint(OpenAI 兼容) 在 RuAPI 上是最直接的路径,Claude 系列模型同样可用。
Hermes 支持多 provider 共存。再跑 hermes model 加一个就行,会话内 /model 切换。
OpenAI 兼容协议下,function calling 完整透传。如果某个工具调用失败,先检查模型本身是否支持 tool use(GPT、Claude 系列都能可靠地做工具调用——见函数调用)。

进阶

  • Auxiliary models:Hermes 的 vision / web search / MoA 用辅助模型,默认跟主模型走,要省钱可单独换便宜模型,参考 Auxiliary Models。
  • Credential pools:多 key 轮询、自动 failover,配置见 Credential Pools。