Hermes Agent 配置指南:一键安装 + 自主配置模型

配置指南2026.08

不用纠结选哪个模型

Hermes Agent 完全配置指南

一键安装 + 自主配置

10 分钟装好 · 4 条命令接入任意模型

Hermes Agent · 晴天 AI

教程配置

📦 8 Parts

👉 滑动

PART 01安装3 种方式

PART 02查看模型hermes provider

PART 03配置模型4 条命令

PART 04内置 Provider一键配置

PART 05配置 Kimikimi-k3

PART 06本地模型Ollama

PART 07常见问题排错指南

PART 08写在最后总结建议

01 PART

安装 Hermes Agent · 3 种方式

方式一：一键安装（推荐）

...

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

方式二：Homebrew 安装

bash

brew install nousresearch/tap/hermes-agent

方式三：源码安装

bash

git clone https://github.com/NousResearch/hermes-agent.git

cd hermes-agent

pip install -e .

安装完成后启动：

bash

hermes

02 PART

查看可用模型· 内置插件

Hermes 内置了多个模型提供商插件，安装后自动可用。查看支持的模型：

bash

hermes provider list

03 PART

配置模型（4 条命令） · Agnes 示例

以 Agnes 为例：

...

# 1. 选择提供商

hermes config set model.provider custom

# 2. 设置 API 地址

hermes config set model.base_url https://api.agnes-ai.cn/v1

# 3. 设置 API Key

hermes config set model.api_key YOUR_API_KEY

# 4. 选择模型

hermes config set model.default agnes-2.5-flash

一键执行：

bash

hermes config set model.provider custom && \

hermes config set model.base_url https://api.agnes-ai.cn/v1 && \

hermes config set model.api_key YOUR_API_KEY && \

hermes config set model.default agnes-2.5-flash

04 PART

内置一键配置 · 无需手动配 URL

Hermes 内置的 provider 不需要手动设置 base_url，直接可用：

DeepSeek：

bash

hermes config set model.provider deepseek

hermes config set model.api_key YOUR_KEY

hermes config set model.default deepseek-v4-flash

通义千问：

bash

hermes config set model.provider alibaba

hermes config set model.api_key YOUR_KEY

hermes config set model.default qwen-plus

智谱 GLM：

bash

hermes config set model.provider zai

hermes config set model.api_key YOUR_KEY

hermes config set model.default glm-4.5-flash

05 PART

配置 Kimi· 手动配置 base_url

Kimi 需要手动配置 base_url：

bash

hermes config set model.provider custom

hermes config set model.base_url https://api.moonshot.cn/v1

hermes config set model.api_key YOUR_KEY

hermes config set model.default kimi-k3

提示：Kimi K3 支持 1M token 上下文和原生视觉理解（文本、图片、视频）。

06 PART

配置本地模型（Ollama） · 数据完全可控

本地模型适合隐私敏感、不想付 API 费用的用户。无需联网、数据完全可控，但需要一定的硬件配置。

硬件配置要求

配置级别	内存	可运行模型	适合场景
最低配置	8GB	phi3.5（2.5GB）	简单对话、代码补全
推荐配置	16GB + 8GB 显存	qwen2.5:7b	代码生成、文档整理
流畅配置	32GB + 12GB 显存	deepseek-r1:7b	推理、复杂任务

Mac 用户注意：M 系列芯片，16GB 可跑 7B 模型，32GB 可跑 14B 模型。Intel 芯片需同时具备 8GB 显存 + 32GB 内存。

安装 Ollama

bash

# macOS

brew install ollama

# Linux

curl -fsSL https://ollama.com/install.sh | sh

# Windows：下载运行安装程序

下载并测试模型

bash

ollama serve

ollama pull qwen2.5:7b

ollama run qwen2.5:7b

配置 Hermes 使用本地模型

bash

hermes config set model.provider openai

hermes config set model.base_url http://localhost:11434/v1

hermes config set model.api_key ollama

hermes config set model.default qwen2.5:7b

07 PART

常见问题

问题一：API Key 认证失败解决方法：1. 重新复制 API Key（别手打）2. 确认账户余额充足3. 确认 model.provider 已设置

问题二：Base URL 写错了解决方法：/v1 就够了，不要写 /v1/chat/completions

问题三：本地模型跑不起来解决方法：

bash

# 查看已下载模型

ollama list

# 测试运行

ollama run qwen2.5:7b

显存不足就下载更小的模型（如 phi3.5）。

08 PART

写在最后 · 我的建议

Hermes Agent 的强大之处在于自进化学习闭环——从经验中创建技能，在使用中改进技能，主动持久化知识，搜索过往对话，并在跨会话中逐步构建对你的深度理解。

我的建议：

普通用户先用 Agnes → 开发者用 DeepSeek → 隐私敏感本地 Qwen2.5根据场景选择最适合的方案

配置好之后，你就可以让 Hermes 帮你写代码、调试、整理文档、跑自动化任务了。

🟢 互动区你用的是云端还是本地模型？有什么配置问题，评论区聊聊 👇

如果觉得有用，欢迎点赞、在看、转发给同样需要的朋友。

参考链接：

- [Hermes Agent 文档](https://hermes-agent.nousresearch.com/docs)

- [Hermes GitHub](https://github.com/NousResearch/hermes-agent)

- [Agnes AI](https://platform.agnes-ai.com)

- [DeepSeek](https://platform.deepseek.com)

- [Ollama](https://ollama.com)