前置条件
1
RuAPI 账号 + API key
控制台 → 令牌管理 创建一把
sk-...。2
操作系统
Linux、WSL2、Windows 10/11 和 Apple Silicon 的 macOS 都在 Hermes 的第一档支持(Tier 1)里。Windows 和 Apple Silicon 的 macOS 另有带桌面应用的 Hermes Desktop 安装包。
安装 Hermes
- Linux / macOS / WSL2
- Windows (PowerShell)
一行安装:装完新开一个终端窗口,或者重新加载 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)(其他模型),再选具体模型。也可以启动时直接指定:方式二:不装插件,用 Custom endpoint
跑配置向导:1
选 'Custom endpoint'
向导会列出所有内置 provider(Nous Portal / OpenRouter / Anthropic / OpenAI / ……)。下拉到底部,选 Custom endpoint (self-hosted / VLLM / etc.)。
2
填 base URL
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:切换模型
会话内: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 设置:常见问题
找不到模型(503)或 404
找不到模型(503)或 404
- 模型 ID 没在 RuAPI 上线。去 价格页 看可用列表。
base_url末尾要带/v1。
为什么不用 Hermes 的 'Anthropic' 内置 provider?
为什么不用 Hermes 的 'Anthropic' 内置 provider?
Hermes 内置的 Anthropic 走 OAuth + Claude Max 订阅,对接第三方 Anthropic 兼容网关需要额外的 base URL 覆盖、不一定稳。Custom endpoint(OpenAI 兼容) 在 RuAPI 上是最直接的路径,Claude 系列模型同样可用。
想同时用 Nous Portal + RuAPI
想同时用 Nous Portal + RuAPI
Hermes 支持多 provider 共存。再跑
hermes model 加一个就行,会话内 /model 切换。Tools / function calling 不工作
Tools / function calling 不工作
OpenAI 兼容协议下,function calling 完整透传。如果某个工具调用失败,先检查模型本身是否支持 tool use(GPT、Claude 系列都能可靠地做工具调用——见函数调用)。
进阶
- Auxiliary models:Hermes 的 vision / web search / MoA 用辅助模型,默认跟主模型走,要省钱可单独换便宜模型,参考 Auxiliary Models。
- Credential pools:多 key 轮询、自动 failover,配置见 Credential Pools。