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

如果你正在寻找一个能真正理解你、能持续学习、能跨平台工作，并且能帮你自动化处理各种任务的 AI 助手，而不是一个只会单次对话的聊天机器人，那么 Hermes Agent 可能是你目前能找到的最接近“智能伙伴”形态的开源项目。

它不仅仅是一个调用大模型的壳子。它的核心在于一个“内置的学习循环”——它能从经验中创建技能，在使用中改进技能，主动提醒自己保存知识，搜索过去的对话，并随着时间推移，构建一个关于你的、不断深化的模型。这意味着你用得越久，它就越懂你，越能帮你处理那些重复、复杂或需要上下文记忆的任务。无论是通过 Telegram 远程让它帮你处理云服务器上的工作，还是在本地的终端里让它帮你写代码、整理文件，它都能无缝衔接。

然而，一个功能如此强大的项目，其安装和配置过程也往往伴随着各种“坑”。从环境依赖、模型配置，到与各种消息平台的集成，每一步都可能让新手望而却步。本文的目标，就是为你提供一个从零到一的“保姆级”指南，结合官方文档和社区实践经验，帮你避开 99% 的常见问题，让你快速上手，真正体验到 Hermes Agent 带来的效率革命。

1. Hermes Agent 究竟是什么？它能解决什么痛点？

在深入安装步骤之前，我们必须先搞清楚 Hermes Agent 的定位。它不是一个简单的 ChatGPT 命令行客户端，而是一个具备自主学习和记忆能力的 AI 代理框架。理解这一点，是决定你是否需要它的关键。

传统 AI 工具的痛点：

1. 无状态：每次对话都是新的开始，你需要反复解释上下文和需求。
2. 被动响应：你问，它答。它不会主动提醒你，也不会基于历史经验优化回答。
3. 平台割裂：你可能需要在网页、手机 App、命令行等多个工具间切换。
4. 技能固化：功能由开发者预先定义，用户很难教会它处理自己特有的工作流。

Hermes Agent 的核心解法：

1. 闭环学习循环：这是它最核心的差异点。完成一个复杂任务后，它能自动将过程总结成一个可复用的“技能”（Skill）。下次遇到类似任务，它可以直接调用或改进这个技能，效率呈指数级提升。
2. 跨会话记忆：它使用 FTS5 全文搜索和 LLM 摘要来索引过去的对话。你可以问“上周我们讨论的那个 Python 脚本优化方案是什么？”，它能快速定位并给出答案。
3. 统一接入层：一个后台进程（Gateway）即可同时支持 Telegram、Discord、Slack、WhatsApp、Signal、Email 以及原生 CLI/TUI。你在 Telegram 上开始的对话，可以在电脑终端上继续。
4. 强大的工具集与扩展性：内置 40+ 工具（文件操作、网络搜索、代码执行等），支持 MCP（Model Context Protocol）协议接入外部工具，并能通过“技能系统”无限扩展。
5. 灵活的部署：从你 5 美元的 VPS，到 GPU 集群，再到按需付费、闲置时几乎零成本的 Serverless 环境（如 Modal, Daytona），它都能运行。你的 Agent 不必绑死在你的笔记本电脑上。

所以，谁最适合使用 Hermes Agent？

• 开发者：自动化代码审查、生成测试、管理服务器、处理 CI/CD 通知。
• 运维/DevOps 工程师：通过自然语言进行日志查询、服务状态监控、定时备份报告。
• 研究者/学生：管理文献、自动整理实验数据、辅助写作和思考。
• 效率追求者：统一处理来自多个通讯平台的消息，设置智能提醒，管理个人知识库。

如果你对上述任何一个场景有共鸣，那么继续往下看，我们将手把手带你搭建属于你自己的 Hermes Agent。

2. 环境准备与安装：避开第一个大坑

安装是第一步，也是最容易出问题的一步。Hermes Agent 官方提供了一键安装脚本，看似简单，但不同操作系统和环境下的细节决定了成败。

2.1 系统要求与前置确认

在运行安装命令前，请先确认以下几点：

• 操作系统：官方支持 Linux, macOS, Windows (原生或 WSL2), Android (Termux)。本文将以Linux/macOS和Windows 原生为主要环境进行说明。
• Python：需要 Python 3.11 或更高版本。安装脚本会通过uv（一个 Rust 写的快速 Python 包管理器）自动处理，但如果你系统已有 Python，最好先确认版本。
• 网络：安装过程需要从 GitHub 等源下载资源，请确保网络通畅，必要时配置合适的网络环境。

2.2 Linux / macOS / WSL2 安装

对于大多数开发者，这是最推荐的环境。打开你的终端，执行以下命令：

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

这个命令会：

1. 下载安装脚本并执行。
2. 自动安装uv、Python 3.11、Node.js、ripgrep、ffmpeg 等所有依赖。
3. 将 Hermes 安装到~/.hermes目录下。
4. 将hermes命令添加到你的 shell 环境变量中。

安装完成后，必须执行一步操作，否则hermes命令会找不到：

source ~/.bashrc # 如果你使用的是 zsh，则执行： # source ~/.zshrc

然后，你可以通过一个简单的命令验证安装是否成功：

hermes --version

如果输出版本号（如hermes 0.18.0），则说明安装成功。

2.3 Windows 原生安装（无需 WSL）

这是 Hermes Agent 的一大亮点，它提供了完整的原生 Windows 支持。请注意，以下操作需要在 PowerShell（管理员身份）中执行。

打开 PowerShell，运行：

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

这个 PowerShell 脚本会：

1. 在%LOCALAPPDATA%\hermes（通常是C:\Users\<你的用户名>\AppData\Local\hermes）目录下安装所有组件。
2. 自动安装uv、Python 3.11、Node.js、ripgrep、ffmpeg。
3. 关键点：如果系统没有 Git，它会下载一个约 45MB 的便携版 MinGit，放在%LOCALAPPDATA%\hermes\git，完全独立，不干扰系统 Git。如果已安装 Git，则会直接使用。
4. 将hermes命令添加到当前用户的 PATH 环境变量。

安装完成后，重新启动一个 PowerShell 窗口，然后运行hermes --version验证。

2.4 安装过程可能遇到的“坑”与解决方案

坑点一：Windows Defender 或杀毒软件报毒这是目前 Windows 用户遇到最多的问题。安装脚本下载的uv.exe（Astral 出品的 Python 包管理器）可能会被误报为病毒。

原因：一些基于机器学习的杀毒引擎会对未签名的、能下载和执行代码的 Rust 二进制文件产生误报。

解决方案：

1. 临时恢复文件：从杀毒软件的隔离区恢复%LOCALAPPDATA%\hermes\bin\uv.exe。
2. 添加排除项（推荐）：
   • Windows Defender：以管理员身份运行 PowerShell，执行：

     Add-MpPreference -ExclusionPath "$env:LOCALAPPDATA\hermes\bin"

   • 其他杀软：如 Bitdefender，需要在软件设置中找到“管理例外”或“排除项”，添加上述目录。
   • 重要：请排除整个bin文件夹，而不是单个文件哈希，因为uv会随版本更新。

坑点二：安装后hermes命令未找到

• Linux/macOS：确保执行了source ~/.bashrc或source ~/.zshrc。你也可以尝试完全关闭终端再重新打开。
• Windows：确保安装后开启了新的 PowerShell 窗口。如果仍不行，检查用户环境变量 PATH 是否包含了%LOCALAPPDATA%\hermes\bin。

坑点三：网络问题导致安装失败安装脚本需要从 GitHub、Python Package Index 等源下载。如果遇到超时或连接失败：

• 尝试使用更稳定的网络环境。
• 对于uv的安装，可以尝试先手动安装uv，再运行 Hermes 安装脚本（但官方一键脚本是最省心的方式）。

3. 首次配置与核心概念解析

安装成功只是拿到了工具，接下来需要进行初始化配置，让 Hermes Agent 真正“活”起来。这里涉及几个核心概念，理解它们对后续使用至关重要。

3.1 运行设置向导

最推荐新手的启动方式是使用hermes setup命令。它会以交互式向导的方式，引导你完成所有必要配置。

hermes setup

向导会依次询问你：

1. 选择模型提供商：如 OpenAI, Anthropic, Nous (Portal), OpenRouter, 或你自己的自定义端点。
2. 输入 API 密钥：对于选择的提供商，需要输入对应的 API Key。
3. 配置工具：询问你是否启用网络搜索、图像生成等工具，并引导你配置相应的 API Key（如 Serper, Tavily 用于搜索）。
4. 配置消息网关：询问你是否要设置 Telegram, Discord 等平台，并引导你创建 Bot、获取 Token。

这个过程非常直观。但对于想快速体验的用户，Hermes 提供了一个更便捷的选项：Nous Portal。

3.2 快速通道：使用 Nous Portal 一站式配置

如果你不想为模型、搜索、图像生成、TTS 等分别申请和管理多个 API Key，Nous Portal 提供了一个统一的订阅服务，覆盖了 300+ 模型和多个工具网关。

只需一条命令：

hermes setup --portal

这条命令会：

1. 通过 OAuth 引导你登录 Nous Portal 账户。
2. 自动将模型提供商设置为 Nous。
3. 为你开启“工具网关”，一次性接入 Web 搜索（Firecrawl）、图像生成（FAL）、文本转语音（OpenAI）、云浏览器（Browser Use）等服务。

完成后，你可以随时用hermes portal info查看已连接的服务。注意：Nous Portal 是付费订阅服务，但它极大地简化了初始配置的复杂度。

3.3 核心概念：模型、工具、技能、网关

在配置过程中，你会反复遇到这些词，这里做一个清晰的解释：

3.4 基础配置检查与常用命令

完成setup后，你可以用以下命令检查状态和进行基础操作：

# 检查当前使用的模型 hermes model # 列出所有可用的工具 hermes tools list # 查看完整的配置（配置文件位于 ~/.hermes/config.yaml） hermes config show # 诊断环境问题（非常有用！） hermes doctor # 更新 Hermes Agent 到最新版本 hermes update

现在，你的 Hermes Agent 已经就绪，可以开始对话了。

4. 初体验：两种核心交互模式

Hermes Agent 提供了两种主要的交互入口：命令行界面 (CLI/TUI)和消息网关 (Messaging Gateway)。理解这两种模式的区别和适用场景，能让你更好地使用它。

4.1 模式一：终端交互 (CLI/TUI)

这是最直接、功能最全的交互方式。在终端中直接输入：

hermes

你会进入一个功能丰富的文本用户界面 (TUI)。这个界面支持：

• 多行编辑：方便输入长指令。
• 命令自动补全：输入/后按 Tab 键，会提示所有可用的斜杠命令。
• 对话历史：上下箭头翻阅历史消息。
• 流式输出：工具执行和模型思考过程会实时流式显示。

常用斜杠命令（在 TUI 中输入）：

一个简单的终端会话示例：

你： /model openai:gpt-4o Hermes: Model switched to openai:gpt-4o. 你： 帮我查看当前目录下有哪些.py文件，并统计行数。 Hermes: （思考）我将使用 `list_files` 和 `shell` 工具来完成这个任务。 > 运行 `list_files` 工具，路径为 `.`，过滤 `.py`。 > 找到文件：main.py, utils.py, test.py。 > 运行 `shell` 工具，命令：`wc -l main.py utils.py test.py`。 > 输出： 120 main.py 85 utils.py 45 test.py 总计 250 行。 当前目录下有 3 个 .py 文件，总计 250 行代码。

4.2 模式二：消息网关 (Gateway) - 跨平台交互

这是 Hermes 的“杀手级”功能之一。你可以让 Hermes 作为一个后台服务运行，然后通过 Telegram、Discord 等日常通讯工具与它交互。

配置 Telegram Bot（以 Telegram 为例）：

1. 在 Telegram 中搜索@BotFather，发送/newbot指令，按提示创建机器人，获取Bot Token。
2. 在终端运行配置向导：

   hermes gateway setup telegram

3. 向导会提示你输入刚才获取的 Bot Token。
4. 配置允许使用此 Bot 的用户 ID（你的 Telegram User ID，可以通过@userinfobot获取）。
5. 启动网关服务：

   hermes gateway start

6. 在 Telegram 中与你创建的 Bot 对话，发送/start。现在，你就可以在手机上远程指挥你的 Hermes Agent 了！

网关模式的优势：

• 随时随地：在通勤路上用手机就能让 Agent 开始处理服务器上的任务。
• 通知推送：Agent 可以主动通过 Telegram 向你发送定时报告、任务完成通知或警报。
• 多平台统一：所有对话历史在 Hermes 侧是统一的，你在 Telegram 上问过的问题，在 CLI 里也能看到上下文。

两种模式的核心命令对比表：

5. 核心功能实战：技能创建与自动化任务

理解了基本交互，我们来探索 Hermes Agent 最强大的两个特性：技能系统和定时任务。这才是让它从“好用的工具”变为“智能伙伴”的关键。

5.1 技能系统：让 Agent 真正学会做事

技能是 Hermes Agent 学习循环的产物。当 Agent 完成一个多步骤的复杂任务后，它可以（或在你的提示下）将这个任务流程保存为一个技能。下次遇到类似需求，直接调用技能名即可。

场景：你经常需要从某个 API 获取数据，清洗后保存为 CSV 文件。

传统方式：每次都要一步步告诉 Agent：“用 requests 库获取这个 URL，解析 JSON，提取 A、B、C 字段，转换成 DataFrame，保存为 CSV。”

Hermes 技能方式：

1. 第一次，手动引导：

   你： 请帮我从这个API端点获取数据：https://api.example.com/data， 提取 `id`, `name`, `value` 字段，保存到 `output.csv`。 Hermes: （经过一系列工具调用，完成任务）

2. 技能创建：任务完成后，Hermes 可能会主动提示，或者你可以输入：

   你： /skill_save fetch_and_save_data

   Hermes 会将刚才的工具调用序列、使用的参数、以及你的意图描述，封装成一个名为fetch_and_save_data的技能，保存在~/.hermes/skills/目录下。
3. 后续使用：

   你： /fetch_and_save_data https://api.example.com/v2/users output_users.csv

   Agent 会直接运行封装好的技能，无需重新思考步骤，速度极快且可靠。

手动编写技能：技能本质上是 YAML 文件，你也可以手动创建。一个简单的技能文件~/.hermes/skills/hello_world.yaml可能如下：

# ~/.hermes/skills/hello_world.yaml name: hello_world description: 向指定的人问好 parameters: - name: person description: 要问候的人名 required: true steps: - type: llm prompt: | 向 {{ person }} 说一句友好的问候。

调用方式：/hello_world person=张三

5.2 定时任务：内置的 Cron 调度器

Hermes 内置了一个 Cron 调度器，允许你用自然语言创建定时任务，并将结果发送到任何已连接的平台（如 Telegram）。

场景：每天早上 9 点，让 Agent 检查服务器状态并发送报告到 Telegram。

配置步骤：

1. 创建一个 Cron 任务。你可以直接编辑配置文件，但更简单的方式是使用 TUI 或命令。
2. 在 CLI 中，你可以这样创建：

   # 进入hermes TUI hermes # 在TUI中输入 /cron_add "0 9 * * *" "检查服务器负载和磁盘使用情况，并总结成报告。"

   或者，直接通过命令（需要先配置好模型）：

   echo "检查服务器负载和磁盘使用情况，并总结成报告。" | hermes cron add --schedule "0 9 * * *" --platform telegram

3. 确保你的网关正在运行 (hermes gateway start)，并且 Telegram 已配置好。
4. 每天上午 9 点，你就会在 Telegram 上收到 Agent 发来的服务器状态报告。

Cron 任务的强大之处在于，任务内容可以是任何 Agent 能理解的自然语言指令。它可以调用任何已启用的工具，执行复杂的多步操作。

6. 高级配置与集成

为了让 Hermes Agent 更加强大，你需要了解如何管理它的工具、记忆以及如何与外部系统集成。

6.1 工具集管理

Hermes 拥有超过 40 个内置工具，但出于安全和性能考虑，并非所有工具都默认开启。你可以通过hermes tools命令进行管理。

# 查看所有工具及其状态（启用/禁用） hermes tools list # 启用某个工具，例如 `web_search`（需要先配置 Serper 或 Tavily API Key） hermes tools enable web_search # 禁用某个工具，例如 `execute_code`（出于安全考虑） hermes tools disable execute_code # 查看某个工具的详细信息和所需配置 hermes tools info shell

安全建议：在生产环境或开放给他人使用的 Agent 中，务必仔细审查execute_code、shell、filesystem_write这类高权限工具，并考虑使用command_approval（命令审批）功能，或将其限制在安全的 Docker 容器中运行。

6.2 记忆系统

Hermes 的记忆分为几种类型：

• 会话记忆：当前对话的上下文。
• 长期记忆：存储在~/.hermes/memory/下的 Markdown 文件，如FACTS.md（事实）、USER.md（用户信息）。
• 向量记忆：通过嵌入模型存储和检索的语义化记忆。

你可以通过与 Agent 对话来管理记忆：

你： /memory_add FACTS 我的服务器IP是 192.168.1.100。 你： /memory_search 服务器IP Hermes: 在FACTS记忆中找到了：我的服务器IP是 192.168.1.100。

Agent 也会在对话中自动识别重要信息，并询问你是否要存入记忆。

6.3 MCP 集成：无限扩展能力

MCP（Model Context Protocol）是一个新兴的协议，允许 AI 应用安全地连接到各种数据源和工具。Hermes 原生支持 MCP，这意味着你可以为它接入数据库、云服务、内部系统等。

示例：连接一个 SQLite 数据库

1. 你需要一个 MCP 服务器。例如，可以使用sqlite-mcp服务器。
2. 在 Hermes 配置文件中 (~/.hermes/config.yaml) 添加 MCP 服务器配置：

   mcp_servers: sqlite: command: npx args: - -y - @modelcontextprotocol/server-sqlite - /path/to/your/database.db

3. 重启 Hermes 或网关进程。之后，Agent 就可以通过自然语言查询和操作你的数据库了。

   你： 查询一下 users 表里最近注册的10个用户。 Hermes: （通过 MCP 调用 SQLite 工具）这是查询结果...

7. 部署方案：从本地到云端

Hermes Agent 的设计初衷就是“随处运行”。你可以根据需求选择不同的部署方式。

在 VPS 上部署的简要步骤（以 Ubuntu 为例）：

1. SSH 连接到你的 VPS。
2. 同样使用一键安装脚本：curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
3. 运行hermes setup进行配置。
4. 使用systemd或tmux等工具让hermes gateway start在后台持续运行。
5. 在你的个人电脑或手机上，通过 Telegram Bot 与 VPS 上的 Agent 交互。

使用 Docker Compose 运行：Hermes 项目提供了docker-compose.yml文件，可以快速启动包含网关和所有依赖的完整服务。

# 克隆仓库（可选，docker-compose.yml 也可单独下载） git clone https://github.com/NousResearch/hermes-agent.git cd hermes-agent # 复制环境变量示例文件并编辑，填入你的 API Keys 等配置 cp .env.example .env nano .env # 启动服务 docker-compose up -d

8. 常见问题与故障排查清单

即使按照教程操作，你也可能会遇到一些问题。以下是常见问题的排查思路。

当遇到问题时，hermes doctor命令是你的第一道防线，它能诊断出大部分环境配置问题。

9. 最佳实践与安全建议

将 Hermes Agent 用于生产或处理敏感任务时，请务必遵循以下最佳实践。

1. 最小权限原则：

   • 在配置shell、execute_code、filesystem_write等工具时，使用command_approval功能，要求人工确认危险操作。
   • 考虑在 Docker 容器或具有严格权限限制的用户环境中运行 Hermes。

2. 配置管理：

   • 主配置文件是~/.hermes/config.yaml。建议对其进行版本控制（但务必排除其中的 API Key 等秘密信息）。
   • 将秘密信息（API Keys）存储在环境变量中，在配置文件中引用，如api_key: ${OPENAI_API_KEY}。

3. 模型选择与成本控制：

   • 对于简单的日常任务，可以使用成本更低的模型（如openai:gpt-3.5-turbo）。
   • 对于复杂推理或编程任务，再切换到更强的模型（如openai:gpt-4o或anthropic:claude-3-5-sonnet）。
   • 关注各模型提供商的 Token 使用量和费用。

4. 技能工程：

   • 为常用工作流创建技能，这是提升效率的核心。
   • 技能描述要清晰、具体，包含明确的输入参数和预期输出。
   • 定期回顾和优化你的技能库。

5. 记忆管理：

   • 不要指望 Agent 记住所有事情。重要的、结构化的信息（如服务器地址、项目规范）应手动添加到FACTS.md或USER.md。
   • 定期清理~/.hermes/memory/目录，避免无关信息干扰检索。

6. 备份：

   • 定期备份~/.hermes/目录，尤其是skills/和memory/子目录。这是你训练 Agent 的宝贵资产。

7. 社区与更新：

   • Hermes Agent 迭代迅速。定期运行hermes update获取新功能和修复。
   • 遇到问题或有好想法，可以到 GitHub Issues 或 Discord 社区寻求帮助或贡献。

从安装配置到核心功能实战，再到高级集成与安全部署，我们希望这篇指南能为你扫清使用 Hermes Agent 道路上的绝大多数障碍。它不仅仅是一个工具，更是一个可以不断成长、适应你个人工作流的智能伙伴。现在，就从运行hermes开始，给你的数字生活配上一个得力的助手吧。

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