Hermes Agent 使用教程：安装、下载、应用与 API 连接

这篇文章写给想把 AI Agent 用到医学知识管理、科室资料整理、临床培训和个人效率工具中的医生朋友。Hermes Agent 是 Nous Research 开源的 AI Agent 框架，可以运行在终端、桌面端、Web 管理后台、消息平台，也可以通过 OpenAI 兼容 API 接入 Open WebUI、LobeChat、LibreChat 等前端。

一句话理解：普通大模型主要负责“回答”；Hermes Agent 更像“会使用工具的助手”，它可以结合模型、知识、工具、记忆和规则，完成检索资料、整理文件、调用终端、生成文档、定时任务等工作。

一、适合医生的典型应用场景

• 个人知识库问答：把指南、课件、制度、笔记整理成可检索资料。
• 术前评估提纲：根据病情资料生成结构化评估清单，供医生复核。
• 科室制度问答：把 SOP、培训材料、值班制度变成内部问答助手。
• 论文和指南整理：快速提取重点、生成表格和汇报提纲。
• 自动化任务：定时抓取资料、整理文件、生成周报或培训素材。

二、下载地址

官方地址：

• 官方网站：https://hermes-agent.nousresearch.com/
• 官方文档：https://hermes-agent.nousresearch.com/docs/
• GitHub 项目：https://github.com/NousResearch/hermes-agent
• 最新发布版本：v2026.7.7.2

本站备用下载，方便国内医生先保存安装脚本：

• 下载 Hermes Agent Linux/macOS/WSL/Termux 安装脚本

说明：Hermes Agent 更新较快，建议优先使用官方安装命令；本站附件主要作为安装脚本备份，便于国内网络环境下保存和转发。

三、安装 Hermes Agent

1. Linux / macOS / WSL2 / Android Termux

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

如果已经下载了本站备用安装脚本，也可以：

bash hermes-agent-install-20260711.sh

2. Windows 原生 PowerShell

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

3. 通过 Python 包安装

pip install hermes-agent
# 或者
uv pip install hermes-agent

安装完成后，打开终端输入：

hermes

第一次运行建议执行初始化向导：

hermes setup
hermes model
hermes doctor

四、配置模型供应商

Hermes 支持 OpenRouter、OpenAI、Anthropic、Google Gemini、DeepSeek、通义千问、Moonshot/Kimi、xAI、Hugging Face、本地模型等多种供应商。

常用命令：

hermes model          # 交互式选择模型和供应商
hermes config         # 查看配置
hermes config edit    # 编辑配置文件
hermes doctor         # 检查依赖和配置

医生个人使用时，我建议先从 OpenRouter、DeepSeek、通义或 Kimi 这类较容易获取的模型供应商开始。涉及患者隐私的资料，不建议直接上传到不受控的公网模型；如用于临床场景，应尽量做脱敏、内网部署和人工复核。

五、基本使用方法

1. 进入交互式对话

hermes

2. 直接问一个问题

hermes chat -q "请帮我整理一份老年髋部骨折患者术前麻醉评估清单"

3. 指定模型

hermes chat -m anthropic/claude-sonnet-4 -q "总结这份指南的核心推荐"

4. 使用技能 Skills

Skills 可以理解为“可复用的工作流程”。例如你经常让 AI 整理指南、写培训提纲、做代码审查，可以把成熟步骤保存为技能，下一次自动加载。

hermes skills list
hermes skills browse
hermes skills install <skill-id>

5. 定时任务 Cron

例如每天早晨自动生成一个医学资讯简报：

hermes cron create "0 8 * * *"

六、把 Hermes 接入 Open WebUI

Hermes 可以开启 OpenAI 兼容 API Server，然后让 Open WebUI 把 Hermes 当作一个“模型后端”。这样你就可以在手机或浏览器里使用 Open WebUI 界面，同时后端仍然是具备工具调用能力的 Hermes Agent。

1. 开启 Hermes API Server

hermes config set API_SERVER_ENABLED true
hermes config set API_SERVER_KEY your-secret-key

如果网关已经在运行，重启网关：

hermes gateway stop
hermes gateway

看到类似提示即可：

[API Server] API server listening on http://127.0.0.1:8642

2. 验证 API 是否可用

curl -s http://127.0.0.1:8642/health
curl -s -H "Authorization: Bearer your-secret-key" http://127.0.0.1:8642/v1/models

3. Open WebUI Docker 启动示例

docker run -d -p 3000:8080   -e OPENAI_API_BASE_URL=http://host.docker.internal:8642/v1   -e OPENAI_API_KEY=your-secret-key   -e ENABLE_OLLAMA_API=false   --add-host=host.docker.internal:host-gateway   -v open-webui:/app/backend/data   --name open-webui   --restart always   ghcr.io/open-webui/open-webui:main

然后打开：

http://localhost:3000

首次创建管理员账号后，在模型列表中选择 Hermes Agent 即可。

4. 在 Open WebUI 后台手动添加连接

如果你已经有 Open WebUI，也可以在后台配置：

• 进入 Open WebUI 管理后台
• 打开 Admin Settings → Connections
• 在 OpenAI API 中添加连接
• URL 填：http://你的服务器IP:8642/v1
• API Key 填：your-secret-key

七、常见 API 链接

调用示例：

curl http://127.0.0.1:8642/v1/chat/completions   -H "Authorization: Bearer your-secret-key"   -H "Content-Type: application/json"   -d '{
    "model": "hermes-agent",
    "messages": [
      {"role": "user", "content": "请用表格整理术前访视要点"}
    ]
  }'

八、做成手机上的“私人 AI App”

如果已经部署了 Open WebUI，例如我的私人 AI 地址是：

https://ai.medclub.tech/

最简单的方法是用手机浏览器打开这个地址，然后添加到主屏幕：

• iPhone：Safari 打开网页 → 分享 → 添加到主屏幕。
• Android：Chrome 打开网页 → 右上角菜单 → 添加到主屏幕或安装应用。

这样桌面上会出现一个类似 App 的图标，适合个人或科室内部使用。如果需要真正的 APK，可以用 WebView 把 Open WebUI 地址封装成 App。

九、医疗使用时的安全边界

• AI 结果只能作为资料整理和思路辅助，不能替代医生诊断、麻醉决策或处方行为。
• 涉及患者资料时，应先脱敏，避免姓名、身份证号、住院号、电话等敏感信息外传。
• 科室内部应用建议部署在 NAS、院内服务器或可信云环境，并设置账号权限。
• 所有用于临床的输出，都应由具备资质的医生最终审核。

十、推荐的医生个人部署结构

NAS / 服务器
├── Hermes Agent
├── Open WebUI
├── Dify 或个人知识库
├── Ollama / vLLM / 云模型 API
├── Nginx 反向代理
└── HTTPS 域名

手机、电脑和平板只负责访问网页或 App 壳，真正的数据、知识库和工具调用都在自己的服务器上完成。这样更容易维护，也更符合医生个人知识管理和科室内部应用的实际需求。

小结

Hermes Agent 的价值不只是“聊天”，而是把大模型、知识库、工具、记忆和工作流连接起来。对医生来说，它更适合做“知识管理助手”和“工作流助手”：帮助我们更快检索资料、组织思路、生成初稿，但最终判断仍然必须回到专业人员手中。

参考资料：Hermes Agent 官方文档。