Hermes Agent 从零安装保姆级教程:5 分钟一行命令跑通你的第一个自我进化 AI Agent

Hermes Agent 从零安装保姆级教程：5 分钟一行命令跑通你的第一个自我进化 AI Agent

（支持 Win/Mac/Linux/WSL）

2026 年开源 AI Agent 领域最受关注的项目之一，就是 Nous Research 出品的 Hermes Agent —— 一个真正“会随着使用成长”的自改进 AI Agent。

它最大的亮点在于内置闭环学习机制：在实际任务中，它会从经验中自动创建和迭代技能、持久化记忆、搜索历史对话，并逐步构建对你的偏好和项目的深入理解。

不同于传统聊天机器人或简单工具调用型 Agent，Hermes Agent 被设计成一个能长期陪伴、越用越聪明的“数字员工”。它支持在 $5 VPS、GPU 集群 或闲置时几乎零成本的 serverless 环境运行，还能通过 Telegram、Discord 等多平台随时指挥。

很多朋友看到“自我进化”就心动，但安装和上手往往是第一道门槛。

特别说明： 本文严格基于官方 GitHub（https://github.com/NousResearch/hermes-agent）和官方文档，提供保姆级、零杜撰的从零安装流程，覆盖 Windows（WSL）、macOS、Linux 全平台。跟着操作，绝大多数用户能在 5 分钟内跑通第一个 Agent。

💡 为什么选择 Hermes Agent？

• 自改进闭环：完成任务后自动提炼经验为可复用技能，记忆跨会话持久化（基于 SQLite + FTS5 + LLM 总结，以及 Honcho 用户建模）。
• 多平台接入：支持 Telegram、Discord、Slack 等，通过 Gateway 实现手机随时指挥 24/7 运行的 Agent。
• 灵活部署：一行命令安装，支持本地 Ollama、本地模型或云 API（如 OpenAI/Anthropic）。
• 社区活跃：GitHub 上有大量 Stars，配套 awesome-hermes-agent 技能列表、WebUI 等生态。

适合人群： 开发者、内容创作者、个人生产力爱好者，以及想搭建长期 AI 助手的朋友。

🛠️ 前提准备（1 分钟检查）

Hermes Agent 官方支持以下平台：

• Linux / macOS（原生最佳）
• Windows：强烈推荐启用 WSL2（Windows Subsystem for Linux），安装 Ubuntu 等发行版。原生 Windows 不支持。
• Android Termux：有专用路径（本文暂不展开，可查官方 Termux 指南）。

硬件/环境建议：

• Python 3.11+（安装脚本会自动处理）
• 网络通畅（用于拉取代码和依赖）
• 至少几 GB 磁盘空间

⚠️ Windows 用户必做步骤：

1. 打开“启用或关闭 Windows 功能”，勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”。
2. 重启电脑后，在 Microsoft Store 搜索安装 Ubuntu（或任意 WSL 发行版）。
3. 打开 Ubuntu 终端，运行 wsl --update 更新内核。
4. 更新系统：sudo apt update && sudo apt upgrade -y。

macOS / Linux 用户直接打开终端即可。

🚀 步骤 1：一行命令安装（最快路径，2-3 分钟）

官方提供一键安装脚本，会自动检测系统、安装 uv（快速 Python 包管理器）、Python 3.11、Node.js v22（用于浏览器自动化等）、ripgrep、ffmpeg，以及克隆仓库、创建虚拟环境、安装依赖，并添加全局 hermes 命令。

在终端（WSL/Ubuntu/macOS/Linux）中，直接复制粘贴运行：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装过程中会发生什么（透明说明）：

• 下载并执行 install.sh 脚本。
• 自动安装缺失的系统依赖。
• 使用 uv 创建虚拟环境。
• git clone https://github.com/NousResearch/hermes-agent.git。
• 安装核心依赖（包括 [all,dev] extras）。
• 创建 ~/.local/bin/hermes 软链接，让你在任意终端直接输入 hermes 命令。

验证安装：安装完成后，建议重启终端或手动执行环境刷新。输入以下命令验证：

hermes --version

或直接输入 hermes，看到帮助信息即成功。

⚙️ 步骤 2：初始化配置（hermes setup，1-2 分钟）

安装成功后，运行初始化向导：

hermes setup

向导会引导你：

• 配置 Provider（模型后端）：支持 OpenAI、Anthropic、Ollama（本地模型）、vLLM 等。你可以先选择一个免费/已有的 API Key，或本地 Ollama（需提前安装 Ollama 并拉取模型，如 ollama run llama3）。
• 设置基本 Profile：多实例支持，后续可建工作/生活不同配置。
• 选择默认工具集等。

推荐新手配置：

• 完全本地私密：提前安装 Ollama，运行 ollama pull 一个合适模型，然后在 setup 中选择 Ollama provider 并指向本地地址。
• 云 API 用户：准备好 OpenAI 或 Anthropic Key，填入即可。

🤖 步骤 3：运行你的第一个 Agent 并测试（1 分钟）

直接启动交互模式：

hermes

或指定模式：

hermes chat

输入一个简单指令测试，例如：

• “你好，介绍一下你自己。”
• “帮我列出当前目录文件，并总结今天日期。”
• “搜索一下最新 AI Agent 新闻并总结。”（如果配置了网页搜索工具）

第一个真实任务建议：让它执行一个带工具的任务，例如“用终端命令检查系统信息，并用 markdown 格式总结”，观察工具调用过程。

🔍 常见问题排查（严谨避坑）

1. 命令未找到（command not found）：重启终端，或手动 source ~/.bashrc / source ~/.zshrc；检查 ~/.local/bin 是否在 PATH 中（echo $PATH）。
2. 依赖安装失败：确保有足够磁盘空间和网络；可尝试进入仓库目录运行 uv sync。
3. WSL 特定问题：确保 WSL2（wsl -l -v 查看版本），文件系统权限正常，避免 Windows 路径混用。
4. 模型连接失败：检查 API Key 是否正确、Ollama 服务是否运行（ollama serve）。
5. 内存/技能相关：首次使用记忆和技能创建需要几次任务积累，后续会自动优化。

更多资源：
• 官方文档：https://hermes-agent.nousresearch.com/docs/
• GitHub Issues：https://github.com/NousResearch/hermes-agent/issues

🗺️ 安装完成后下一步建议

• 接入 Telegram：创建 BotFather 机器人，获取 Token，然后在 Hermes 配置中添加 Gateway，即可手机指挥。
• 部署到 VPS：推荐 $5 级云服务器（如 Ubuntu），同样跑一行安装命令，即可 24/7 运行。
• 探索核心功能：尝试复杂任务，观察它如何自动生成技能并在下次更快执行。
• 社区资源：加入 Nous Research Discord，查看 awesome-hermes-agent 仓库获取现成技能。

✍️ 结语

通过这篇保姆级教程，你已经成功跑通了 Hermes Agent —— 一个真正会“自我进化”的开源 AI Agent。5 分钟安装不是噱头，而是官方脚本带来的极致便利。接下来，随着使用，它会越来越懂你，成为你的长期生产力伙伴。

Hermes Agent 系列教程正在持续更新，下一期我们将深入配置多平台接入 + 第一个完整工作流实战。

欢迎点赞、收藏、转发给需要的朋友，也欢迎在评论区分享你的安装体验或遇到的问题，我会尽量解答。

喜欢就点个在看，我们下篇见！如果你已经跑通了，评论区打个“已安装”让我知道～