如何用Hermes Desktop连接12大模型供应商从OpenRouter到本地Ollama的完整教程【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktopHermes Desktop 是 Hermes Agent 的桌面伴侣应用帮你一键连接 12 种以上大模型供应商——从 OpenRouter、OpenAI、Anthropic 到本地 Ollama全部在一个图形界面里完成。本文带你用最简单的步骤完成供应商配置不再折腾命令行。先认识 Hermes Desktop 的模型体系Hermes Desktop 把模型接入分成了三层你只需要知道它们分别解决什么问题官方卡片供应商OpenRouter、OpenAI、Anthropic、Google、Ollama Cloud、Alibaba DashScope 等每张卡片对应一个品牌填好 API Key 即可用OpenAI 兼容预设Groq、DeepSeek、Together、Cerebras、Mistral 等通过 Local/Remote 预设芯片一键填入地址本地推理Ollama、vLLM、llama.cpp 等跑在你自己的电脑上完全免费所有供应商列表都由数据驱动的常量表定义想确认支持哪些可以直接看 src/renderer/src/constants.ts 中的PROVIDERS.setup和 LOCAL_PRESETS。第一步打开 Providers 页面安装并启动 Hermes Desktop 后在左侧边栏点击Providers进入供应商管理页。页面顶部是「LLM Providers」区域已经配置好的供应商会以卡片形式展示未配置的通过Add provider添加。这一屏的渲染逻辑在 src/renderer/src/components/ProviderKeysSection.tsx页面整体在 src/renderer/src/screens/Providers/Providers.tsx。 首次使用时应用会先展示一个 Setup 引导页让你选择第一个供应商并填入凭据之后所有操作都可以在 Providers 页面完成。连接 OpenRouter一个 Key 用上 200 模型OpenRouter 是最推荐的起点——一张 Key 就能访问 200 多个模型。在 Add provider 弹窗中搜索并选中OpenRouter粘贴你的 API Key格式类似sk-or-v1-...保存后卡片上的状态徽章会通过实时模型发现验证 Key 是否有效——显示「Connected · key verified」即代表连通成功OpenRouter 卡片在 PROVIDERS.setup 中定义Base URL 已自动填好为https://openrouter.ai/api/v1你不需要手动输入任何地址。其他主流云端供应商填 Key 即用以下供应商同样在官方卡片中流程与 OpenRouter 完全一致供应商API Key 环境变量说明OpenAIOPENAI_API_KEY直连 GPT 系列模型AnthropicANTHROPIC_API_KEY直连 Claude 系列模型GoogleGOOGLE_API_KEYGemini 系列模型Alibaba DashScopeDASHSCOPE_API_KEY支持选择国内/国际端点Ollama CloudOLLAMA_API_KEYOllama 云端模型xAI / 小米 MiMoXAI_API_KEY/XIAOMI_API_KEYGrok 与 MiMo 模型每个供应商卡片的配置弹窗会自动做「模型发现」如果供应商开放了模型列表接口保存的 Key 一旦验证通过卡片状态行会立即显示验证结果状态行逻辑见 src/renderer/src/hooks/useDiscoveredModels.ts。API Key 会自动按域名推导即使你使用 OpenAI 兼容端点Hermes Desktop 也能自动识别该用哪个环境变量——例如api.groq.com会自动对应GROQ_API_KEY。这套「URL → Key 变量」的映射表在 src/shared/url-key-map.ts。连接 8 个 OpenAI 兼容供应商Remote 预设Groq、DeepSeek、Together、Fireworks、Cerebras、Mistral、AtlasCloud、AIML 等兼容端点不需要手动敲 Base URL打开Local卡片或 Add provider 选择 Local点击对应的预设芯片如Groq或DeepSeekBase URL 自动填入粘贴 API Key 并保存预设列表完整定义在 LOCAL_PRESETS每个预设都带有专属的 Key 环境变量名互不冲突。连接本地 Ollama免费跑自己的模型想在本地推理零成本、数据不出机器Hermes Desktop 内置了三个本地预设Ollamahttp://localhost:11434/v1vLLMhttp://localhost:8000/v1llama.cpphttp://localhost:8080/v1步骤先在电脑上安装并启动 Ollama拉取一个模型如ollama pull llama3.3在 Hermes Desktop 的 Local 卡片中点选Ollama预设本地服务不需要 API Key直接保存即可之后在聊天输入框底部的模型选择器里就能切换到本地模型。给供应商添加模型并设为默认供应商配置好后模型管理直接在每张供应商卡片内进行点开供应商卡片在底部的模型区域点击 Add model ID输入框支持自动补全来自实时模型发现回车即保存回到 Providers 页顶部的MODEL区域点Change在弹窗中选择供应商 模型确认即成为默认模型添加的模型会写入模型库并立即出现在聊天页面的模型选择器中同一模型 ID 也可以同时挂在多个供应商下面。常见问题速查Q保存后状态显示 Couldnt verify key 怎么办Key 本身已保存但模型列表接口验证失败。检查 Key 是否复制完整、账户是否有余额或删除该 Key 重新粘贴一次。Q切换供应商后报错或无响应应用在激活模型时会自动修正传输协议api_mode确保不同协议供应商之间切换不出错相关处理在 src/main/config.ts 的setModelConfig。如果仍异常尝试删除并重新添加该供应商。Q想在终端和桌面之间共享供应商配置Hermes Desktop 会与 Agent 的config.yaml双向同步命名供应商——在桌面添加的供应商hermes model命令也能看到反之亦然。同步机制详见 lat.md/provider-setup.md 的「Agent config sync」章节。Q可以添加官方卡片之外的兼容端点吗可以。Add provider 弹窗底部的Custom provider选项支持任意 OpenAI 兼容端点可添加多个各自拥有独立的名称、Base URL 和 API Key且不会互相覆盖。总结需求推荐方案快速上手多模型OpenRouter一个 Key 200 模型用旗舰模型OpenAI / Anthropic 官方卡片高性价比推理DeepSeek、Groq、Cerebras 等 Remote 预设免费本地推理Ollama 本地预设配置完成供应商后打开 Chat 页面就能直接用默认模型对话了。更多供应商与模型体系的内部文档参考 lat.md/provider-setup.md。【免费下载链接】hermes-desktopDesktop Companion for Hermes Agent项目地址: https://gitcode.com/gh_mirrors/her/hermes-desktop创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考