🚀 30+款热门AI模型一站整合，DeepSeek/GLM/Qwen 随心用，限时 5 折。 👉 点击领海量免费额度

1. 先搞清楚 Hermes Agent 到底能帮你做什么

如果你刚接触 AI Agent，看到 Hermes Agent 这个名字，第一反应可能是“又一个 AI 助手”。但 Hermes 的核心价值不在于“又一个”，而在于它把“自我进化”和“随处运行”这两件事做成了开箱即用的工程化产品。简单说，它解决的核心问题是：如何让一个 AI 助手不仅能执行任务，还能从任务中学习、沉淀经验，并且能稳定地跑在你的任何一台设备上，而不是仅仅停留在演示阶段。

很多 AI 工具要么功能强大但部署复杂，要么部署简单但功能单一。Hermes 试图在两者之间找到一个平衡点。它最值得关注的几个能力是：

• 内置学习循环：这是它区别于很多“一次性”Agent 的关键。它能在执行复杂任务后，自动创建“技能”（Skills），并在后续使用中不断改进这些技能。这意味着你用得越多，它就越懂你的习惯和需求。
• 真正的多平台接入：它不是一个只能通过网页或命令行交互的工具。通过一个统一的“网关”（Gateway）进程，你可以从 Telegram、Discord、Slack、甚至 WhatsApp、Signal 上跟它对话。你在电脑上没干完的活，可以在手机上继续。
• 计划任务与自动化：内置了类似 cron 的调度器，可以用自然语言描述任务（比如“每晚备份我的笔记”），然后它就能在后台自动执行，并把结果推送到你指定的平台。
• 灵活的运行环境：这是工程上的亮点。它不绑死在你的笔记本电脑上。你可以把它丢到一个每月 5 美元的 VPS 上，也可以部署在带 GPU 的集群里，甚至可以利用 Daytona、Modal 这类 Serverless 基础设施，让它在闲置时几乎不花钱，有任务时再唤醒。

所以，如果你在找的是一个能长期使用、能积累知识、能跨设备服务、并且对部署环境要求不高的 AI 助手，Hermes Agent 值得你花时间研究。它不适合只想“玩一下”的尝鲜者，更适合那些希望将 AI 能力融入日常工作流，并愿意投入一些学习成本的开发者或技术爱好者。

2. 环境准备：从零到一的安装与验证

在开始任何炫酷的功能之前，第一步永远是让它在你的机器上跑起来。Hermes 的安装过程设计得比较友好，但不同系统仍有细节需要注意。不要一上来就追求完美配置，先确保基础命令行版本能正常对话。

2.1 选择你的安装路径

根据你的操作系统，官方推荐了最稳妥的安装方式：

• Linux / macOS / WSL2 (Windows Subsystem for Linux) / Termux (Android)： 这是最顺畅的路径。打开终端，直接运行以下命令：

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

  这个脚本会帮你处理所有依赖，包括 Python 环境管理工具uv、Python 3.11、Node.js 等。

• Windows (原生，非 WSL)： Hermes 原生支持 Windows。以管理员身份打开PowerShell，运行：

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

  关键点：这个安装程序会为你捆绑一个便携版的 Git Bash (MinGit)，放在%LOCALAPPDATA%\hermes\git目录下。Hermes 会用这个来执行 Shell 命令。这样做的好处是完全独立，不会干扰你系统里可能已经安装的 Git。如果系统已安装 Git，安装程序会优先使用系统的。

安装完成后，务必重新加载你的 Shell 配置，让环境变量生效：

# 如果你用 bash source ~/.bashrc # 如果你用 zsh source ~/.zshrc

在 Windows PowerShell 中，通常需要关闭再重新打开一个新的窗口。

2.2 绕过第一个大坑：杀毒软件误报

在 Windows 上，你很可能遇到的第一个问题是：Windows Defender 或其他杀毒软件（如 Bitdefender）将uv.exe识别为病毒并隔离。

uv是 Astral 公司用 Rust 写的 Python 包管理器，Hermes 用它来管理自己的 Python 环境。因为它是一个会下载和执行代码的未签名二进制文件，机器学习引擎的杀毒软件容易产生误报。

这不是病毒。你可以通过官方命令验证其真实性，但更实用的做法是直接将其加入白名单：

• Windows Defender：

  1. 以管理员身份打开 PowerShell。
  2. 运行：Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"这会将整个 Hermes 的 bin 目录加入排除列表。

• Bitdefender 等第三方软件： 通常需要在软件的保护设置里，找到“管理例外”或“排除项”，然后添加上述目录路径：%LOCALAPPDATA%\hermes\bin。

重要提示：建议白名单整个文件夹，而不是单个uv.exe文件。因为 Hermes 更新时，uv的版本和哈希值可能会变，只排除文件哈希会导致更新后再次被拦截。

2.3 运行第一个命令：诊断与启动

安装并处理好环境后，不要急着配置模型和密钥。先运行两个基础命令，确保安装是健康的。

1. 运行医生诊断：

   hermes doctor

   这个命令会检查你的 Python 版本、uv状态、关键依赖等，并给出修复建议。如果这里报错，先根据提示解决，这是后续所有操作的基础。

2. 启动交互式 CLI：

   hermes

   如果一切正常，你会看到一个终端界面，底部有输入提示。这时它可能还没有配置模型，所以无法回复。没关系，我们按Ctrl+C退出。这一步只是为了验证hermes命令本身可以执行，环境是通的。

走到这里，你的 Hermes Agent 骨架已经搭好了。接下来才是赋予它“大脑”和“手脚”的时候。

3. 核心配置：连接大脑（模型）与赋予能力（工具）

一个没有配置的 Hermes 只是一个空壳。它的“大脑”是大型语言模型（LLM），“手脚”是各种工具（Tools）。配置的核心就是告诉它：用哪个“大脑”，以及能用哪些“手脚”。

3.1 模型配置：选择你的 LLM 提供商

Hermes 支持几乎所有主流模型提供商，这是它灵活性的体现。你可以通过hermes model命令来交互式地选择和配置。

• 最省心的选择：Nous Portal如果你不想一个个去申请 OpenAI、Anthropic、OpenRouter 等一大堆 API Key，Hermes 提供了一个集成方案：Nous Portal。它相当于一个聚合订阅，覆盖了模型、网页搜索、图像生成、语音合成等多个后端。 在初次安装后，运行：

  hermes setup --portal

  这个命令会通过 OAuth 引导你登录，自动将 Nous 设置为默认提供商，并启用“工具网关”（Tool Gateway）。之后，你就可以在对话中用/model <模型名>来切换 Portal 内支持的 300 多个模型。

• 自带密钥（BYOK）模式： 如果你已有其他平台的 API Key，或者想使用自己部署的模型端点，可以在运行hermes setup（不带--portal参数）时，按向导一步步配置。你也可以直接编辑配置文件~/.hermes/config.yaml（Linux/macOS）或%USERPROFILE%\.hermes\config.yaml（Windows）。 关键配置项通常在providers和models部分。例如，配置 OpenAI：

  providers: openai: api_key: sk-... # 你的 OpenAI API Key models: gpt-4o: provider: openai model: gpt-4o

建议：新手或想快速体验全部功能，直接用hermes setup --portal。有特定模型偏好或需要控制成本的进阶用户，再研究手动配置。

3.2 工具与技能：它能做什么？

模型决定了“思考”质量，工具决定了“行动”范围。Hermes 内置了 40 多种工具，从文件操作、网络搜索到代码执行。

• 查看和启用工具：

  hermes tools

  这个命令会列出所有可用工具及其状态（启用/禁用）。你可以交互式地选择启用哪些。对于生产环境，出于安全考虑，建议按需启用，而不是全部打开。

• 理解“技能”（Skills）： 这是 Hermes 的精华。“技能”是 Hermes 将一系列工具调用和逻辑封装成的可复用程序。它可以从两种途径获得：

  1. 自动创建：当你完成一个复杂任务（比如“整理这个项目的文档”），Hermes 可能会提议将这个过程保存为一个技能，供以后调用。
  2. 社区获取：Hermes 有一个 Skills Hub，你可以浏览和安装他人分享的技能。 在 CLI 中，输入/skills可以浏览已安装的技能。输入/<技能名>可以直接调用该技能。

• 工具集（Toolsets）与执行后端： Hermes 支持六种终端后端来运行工具：本地（local）、Docker、SSH、Singularity、Modal 和 Daytona。这决定了工具命令在哪里执行。

  • 本地（默认）：命令在你运行 Hermes 的机器上执行。最简单，但安全性最低。
  • Docker：命令在 Docker 容器中执行，提供了很好的隔离性。
  • SSH：命令在远程服务器上执行。
  • Modal/Daytona：Serverless 后端，适合需要弹性计算或希望环境在闲置时“休眠”以节省成本的场景。 你可以在配置文件中指定默认的toolset，也可以在对话中临时指定。

配置顺序建议：先配好模型（确保能“思考”），再按需启用几个核心工具（如文件读写、网络请求），跑通一个简单任务。之后再逐步探索技能和更复杂的工具集配置。

4. 开始对话：CLI 与消息网关实战

配置完成后，你可以通过两种主要方式与 Hermes 交互：命令行界面（CLI）和消息网关（Messaging Gateway）。前者适合在开发机器上深度操作，后者适合移动端和日常沟通。

4.1 使用 CLI 进行深度任务

在终端输入hermes进入交互模式。这里有一些高效使用的核心命令：

• 开始新会话：输入/new或/reset。这很重要，特别是当你切换任务主题时，可以避免上下文混乱。
• 切换模型：/model openai:gpt-4o或/model nous:...。模型切换是即时生效的。
• 设置人格：/personality <name>。Hermes 支持预定义的人格，可以改变其回复风格。
• 使用技能：/skills查看列表，然后/<skill-name>调用。
• 中断任务：如果某个任务执行时间过长或陷入循环，按Ctrl+C。
• 查看资源：/usage查看当前会话的 Token 使用情况，/compress可以尝试压缩上下文以节省 Token。

一个典型的工作流：

1. hermes启动。
2. /model nous:...切换到你想用的模型。
3. 直接描述任务：“帮我查看当前目录下所有.py文件，并统计行数。”
4. Hermes 会思考，可能需要你批准执行ls或wc -l这样的命令（如果启用了命令批准）。
5. 任务完成后，你可以让它“将刚才的步骤保存为一个名为count_py_lines的技能”。
6. 下次遇到类似需求，直接输入/count_py_lines即可。

4.2 配置消息网关实现跨平台使用

消息网关是 Hermes 的“杀手级”功能之一，让你能在 Telegram 等聊天软件里使用它。

1. 初始化网关配置：

   hermes gateway setup

   这个交互式向导会引导你配置想要连接的平台。以 Telegram 为例，你需要：

   • 与@BotFather对话，创建一个新的 Telegram Bot，获取Bot Token。
   • 在向导中填入这个 Token。
   • 获取你的Telegram User ID（可以通过给@userinfobot发消息获得），并把它添加到允许用户列表。

2. 启动网关：

   hermes gateway start

   启动后，网关进程会在后台运行，监听来自已配置平台的消息。

3. 在 Telegram 中对话： 找到你创建的 Bot，开始聊天。大部分 CLI 中的命令在这里同样适用，只需以/开头，例如/new,/model,/status。

   • 关键命令：/sethome <路径>。这可以设置一个远程工作目录。因为网关可能运行在服务器上，你需要告诉它文件操作的基准路径。

网关的优势：

• 持久化：网关进程常驻，你随时可以发送消息。
• 跨设备：在手机、平板、电脑上都能用同一个会话。
• 异步任务：你可以给它一个长任务（如“下载这个系列的所有视频”），然后关掉聊天窗口，任务会在后台继续，完成后再通知你。

注意：运行hermes gateway start后，你的终端会被占用。对于生产部署，你需要使用systemd(Linux)、launchd(macOS) 或nssm(Windows) 等工具将其设为系统服务，或者使用tmux/screen使其在后台运行。

5. 进阶能力：计划任务、记忆与技能开发

当基础对话稳定后，你可以探索 Hermes 更高级的特性，这些才是它被称为“成长型 Agent”的核心。

5.1 计划任务（Cron Scheduling）

Hermes 内置了一个自然语言 cron 解析器。你可以用类似“每 Monday 上午 9 点”这样的句子来创建定时任务。

• 创建计划任务： 在 CLI 或消息中，你可以说：“创建一個计划任务，每週一上午 9 點檢查服務器日誌是否有 ERROR，並將結果發送到 Telegram。” Hermes 会引导你确认时间表达式和任务内容，然后将其加入计划。
• 管理任务：
  • hermes cron list：列出所有计划任务。
  • hermes cron add "schedule expression" "task description"：直接通过命令添加。
  • hermes cron remove <task_id>：删除任务。
• 输出交付：计划任务的结果可以配置为发送到任何已连接的消息平台（如 Telegram），或者写入文件。

5.2 记忆（Memory）与用户建模

Hermes 有持久的记忆系统，不仅仅是会话上下文。

• 记忆类型：
  • 会话记忆：单次对话中的上下文。
  • 程序性记忆：这就是“技能”（Skills），是它学会的操作流程。
  • 陈述性记忆：关于你（用户）的事实和偏好，存储在USER.md等文件中。它会通过对话“润物细无声”地积累这些信息，比如你常做的项目、偏好的工具链等。
• 搜索记忆：你可以让它“搜索我们之前关于 Docker 的对话”，它会利用本地数据库进行全文检索，并用 LLM 总结给你。
• 用户模型：基于 Honcho 框架，Hermes 会逐渐构建一个跨会话的用户模型，使它的建议越来越个性化。

5.3 技能（Skill）的创建与分享

当 Hermes 自动创建一个技能后，你可以在~/.hermes/skills/目录下找到对应的.py文件。你可以手动编辑这些文件来优化它们。

• 技能结构：一个技能通常包含元数据（名称、描述、参数）和run()方法。你可以像写普通 Python 函数一样修改它，加入错误处理、更复杂的逻辑等。
• 分享与获取：社区维护了一个Skills Hub。你可以将自己的技能提交上去，也可以从 Hub 安装他人分享的技能来扩展 Hermes 的能力。这形成了一个生态。
• 技能调用 RPC：技能可以通过 RPC 方式被外部 Python 脚本调用，这意味着你可以将 Hermes 的技能集成到你自己的自动化流水线中。

6. 生产部署考量与故障排查

当你打算长期使用 Hermes 时，就需要考虑稳定性、安全性和资源管理。

6.1 部署模式选择

• 本地开发机：最简单，适合个人学习和轻度使用。注意长时间运行的内存占用。
• 云服务器（VPS）：推荐的方式。选择一台有公网 IP 的 Linux 服务器（如每月 5 美元的套餐），将 Hermes 和消息网关部署在上面。这样你可以 24/7 访问，且不依赖本地电脑开机。
• Serverless (Modal/Daytona)：成本最优解。Hermes 环境在无任务时“休眠”，几乎不产生费用；当有消息（如 Telegram 消息）触发时自动唤醒。适合使用频率不固定、希望极致节省成本的场景。配置相对复杂一些。

6.2 安全最佳实践

1. 命令批准（Command Approval）：在配置中启用require_approval。这样，当 Hermes 试图执行rm,curl | bash等可能有风险的命令时，会先向你请求批准。对于生产环境，这是必须的。
2. 最小化工具权限：不要启用所有工具。只启用当前工作流确实需要的。
3. 使用容器化后端：对于执行不可信代码或操作，配置工具集（Toolset）为docker，提供隔离环境。
4. 网关访问控制：在消息网关配置中，严格限制允许对话的用户 ID（allowed_user_ids）。不要将 Bot Token 泄露。

6.3 常见问题排查清单

当 Hermes 出现问题时，按以下顺序排查：

1. 症状：启动失败或hermes命令未找到

   • 检查：运行hermes doctor。
   • 可能原因：安装脚本未成功，环境变量未加载。重新执行安装步骤，并确认source ~/.bashrc或重启终端。

2. 症状：对话无响应或一直“思考”

   • 检查：运行hermes model确认模型已配置且 API Key 有效。尝试用curl直接测试模型提供商 API。
   • 可能原因：网络问题、API Key 失效、额度用尽、模型名称拼写错误。

3. 症状：工具执行失败（如文件找不到、命令不存在）

   • 检查：确认当前工作目录（/sethome设置是否正确？）。确认该工具已在hermes tools中启用。
   • 可能原因：路径问题、权限问题、工具依赖的系统命令未安装（如git,ffmpeg）。

4. 症状：消息网关收不到消息或无法回复

   • 检查：运行hermes gateway status查看网关进程是否在运行。检查 Telegram Bot 的 Token 和 Webhook 设置（Hermes 网关会自动设置）。查看网关日志（通常有--log-file参数或输出到标准错误）。
   • 可能原因：服务器防火墙阻止了 Webhook 端口、Bot Token 错误、网关进程崩溃。

5. 症状：任务卡住或资源占用高

   • 检查：使用系统监控工具（如htop）查看hermes或python进程的 CPU/内存占用。
   • 可能原因：陷入推理循环、某个工具调用阻塞、处理超大文件。尝试使用/stop或Ctrl+C中断，然后简化任务重试。

最后，也是最重要的建议：对于像 Hermes Agent 这样功能复杂的系统，不要试图一次性配置完美。采用迭代方式：先让最简单的 CLI 对话跑通，然后加上一两个工具，再配置消息网关，最后再研究计划任务和技能开发。每完成一步，都进行充分测试。它的“自我成长”特性意味着，一个稳定、正确配置的起点，会在长期使用中带给你越来越多的回报。

🚀 30+款热门AI模型一站整合，DeepSeek/GLM/Qwen 随心用，限时 5 折。 👉 点击领海量免费额度