Hermes Agent 保姆级安装使用教程

这是一篇面向新手的 Hermes Agent 全流程教程，涵盖从零到一安装、配置、使用和常见问题解决，跟着操作即可拥有一个属于自己的“会自进化”的AI智能体。

⚠️ 什么是 Hermes Agent？ Hermes Agent 是由 Nous Research 于 2026 年 2 月推出的开源自主 AI 智能体框架，主打自学习闭环和持久化记忆——它能在完成任务后自动总结经验、沉淀为可复用技能，跨会话也能记住你的偏好和历史对话，真正做到“越用越聪明”。

一、安装前准备

1.1 系统要求

项目	要求
操作系统	Linux（推荐）、macOS、Windows WSL2（不支持原生Windows）、Android Termux
Python	3.10+（推荐 3.11）
内存	最低 1GB，推荐 4GB+
磁盘空间	约 2GB
网络	能访问 GitHub 和所选 LLM 的 API 服务

💡 Windows 用户必看：Hermes Agent 不支持原生 Windows 环境，需要先安装 WSL2。安装方法：在 PowerShell 中以管理员身份运行 wsl --install，重启电脑后从 Microsoft Store 安装 Ubuntu，然后所有后续操作在 WSL2 终端内完成。

1.2 准备工作

安装 Hermes Agent 之前，你只需要确认两件事：

Git 已安装——安装脚本会自动处理其余所有依赖
准备好一个大模型 API Key——后续配置时需要用到

二、三种安装方式

Hermes Agent 提供了多种安装路径，按推荐程度排序：

✅ 方式一：本地一键安装（适合个人电脑）

这是最推荐的安装方式，一条命令搞定全部。

第 1 步：执行一键安装脚本

打开终端（Windows 用户请在 WSL2 终端中操作），输入以下命令：

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

这个脚本会自动完成：克隆仓库、安装 Python 依赖、创建虚拟环境、注册 hermes 命令。

第 2 步：刷新环境变量

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

第 3 步：验证安装

hermes --version

如果看到类似 hermes v0.8.0 的版本信息，说明安装成功。

🚀 方式二：阿里云轻量应用服务器部署（新手首选）

如果你不想在本地折腾环境，或者希望 Agent 24 小时在线，这是最佳选择。

第 1 步：选购服务器

登录阿里云轻量应用服务器控制台，在创建实例时选择“应用镜像”分类下的 Hermes Agent 官方镜像，内存至少 2GiB。

第 2 步：配置 API Key

进入实例详情页，点击“应用详情”→“配置 Hermes”→“初始化配置百炼 API Key”，填入从阿里云百炼平台获取的 API Key。

第 3 步：启动使用

部署完成后，可通过 Workbench 远程连接服务器，输入 hermes 命令即可开始对话，或通过 WebUI 面板进行管理。

🐳 方式三：Docker 部署（适合服务器/NAS）

如果你有 Docker 环境，可以一行命令启动：

docker run -d --name hermes -v hermes-data:/opt/data nousresearch/hermes-agent:latest gateway run

随后进入容器运行 hermes setup 完成配置向导。

三、配置大模型（配置“大脑”）

安装完成后，Hermes Agent 还需要接入一个大模型 API 才能拥有“思考能力”。这一步骤非常简单，执行以下命令：

hermes setup

这个交互式配置向导会引导你完成以下步骤：

选择 LLM 提供商——国内用户推荐选择 OpenRouter（聚合 200+ 模型，一个密钥通吃）或阿里云百炼
输入 API Key——填入你获取的 API 密钥
选择默认模型——按提示选择一个模型作为默认
配置工具——决定启用哪些内置工具模块（文件操作、Shell 执行、浏览器自动化等）
配置消息网关（可选）——接入 Telegram、飞书等平台

配置完成后，输入 hermes 即可进入对话窗口。

四、接入消息平台（让 Agent 为你打工）

Hermes Agent 最强大的功能之一是可以接入微信、飞书、Telegram 等平台，成为随时在线的数字助手。

📱 接入飞书（详细步骤）

第 1 步：飞书开放平台配置

访问 https://open.feishu.cn/，登录后进入开发者后台
点击“创建企业自建应用”，输入应用名称和描述
添加机器人能力，配置必要权限：im:message 和 im:resource
在“凭证与基础信息”中获取 App ID 和 App Secret

第 2 步：Hermes Agent 配置

hermes gateway setup

在渠道列表中选择“飞书（Feishu）”，按提示依次填入 App ID、App Secret 等信息。

第 3 步：启动网关

hermes gateway start

网关启动成功后，在飞书内找到机器人发送消息测试即可。

💬 接入微信

接入微信需要在配置向导中选择相应的选项，或通过配置文件手动设置。Hermes Agent 已原生支持个人微信接入，配置流程与飞书类似。

五、常用管理命令速查

命令	说明
`hermes`	在终端中直接与 Hermes Agent 聊天（TUI 界面）
`hermes gateway start`	启动后台网关服务
`hermes gateway stop`	停止后台网关服务
`hermes gateway status`	查看网关服务状态
`hermes setup`	重新运行配置向导
`hermes model`	切换当前使用的模型
`hermes doctor`	诊断配置问题
`hermes update`	更新到最新版本
`hermes config list`	查看当前所有配置
`hermes dashboard`	打开官方 WebUI 管理面板

📌 核心命令详解可参考阿里云官方文章。

六、WebUI 可视化面板

如果你不喜欢纯终端操作，Hermes Agent 提供了网页管理面板：

hermes dashboard

运行后会自动打开浏览器，面板支持：查看版本、网关状态、历史对话（含思考过程和工具调用）、Token 统计、技能管理和配置修改等，右上角可切换为中文。

七、国内网络环境常见问题与解决方案

在国内安装 Hermes Agent 时，可能会遇到几个常见的网络问题，下面逐一提供解决方案。

🔴 问题 1：git clone 超时

官方安装脚本第一步是 git clone，国内直连 GitHub 大概率卡死。

解决方案（任选其一）：

方案 A：使用 GitCode 镜像（推荐）
```
git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git ~/.hermes/hermes-agent
```
这是国内最稳定的 GitHub 镜像之一，速度快、无需代理。

方案 B：使用 GitHub 代理加速站

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

其他可用镜像：ghproxy.cn、mirror.ghproxy.com 等。

方案 C：配置 Git 全局代理（如果你有代理工具）

git config --global http.proxy http://127.0.0.1:7890
git config --global https.proxy http://127.0.0.1:7890

🔴 问题 2：pip/uv 依赖安装失败

PyPI 官方源在国内速度慢，容易超时。

解决方案：配置国内镜像源

pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

或临时使用：

pip install -i https://pypi.tuna.tsinghua.edu.cn/simple -r requirements.txt

🔴 问题 3：Playwright 浏览器下载失败

Playwright 需要从国外服务器下载 Chromium 浏览器，国内网络容易失败。

解决方案：使用国内 CDN 镜像

export PLAYWRIGHT_DOWNLOAD_HOST=https://npmmirror.com/mirrors/playwright/
playwright install chromium

🔴 问题 4：模型 API 在国内的可用性

如果直接调用 OpenAI 等国外 API 不稳定，有以下替代方案：

使用 阿里云百炼——国内服务，稳定可靠，新用户可领取超 7000 万 Tokens 免费额度
使用 OpenRouter——聚合 200+ 模型，一个密钥通吃，国内部分地区可访问
使用 本地模型——通过 Ollama 运行 Hermes 3、Qwen 等本地模型，完全离线

📦 离线安装方案

如果你的环境完全无法联网，可以提前下载离线安装包：

获取包含 install.sh、源码 zip、uv 二进制及 Python 3.11 的离线包，解压后修改脚本跳过 git clone，直接安装即可。

八、从 OpenClaw 迁移

如果你之前在使用 OpenClaw（另一个知名的 AI Agent 工具），Hermes Agent v0.10.0 内置了迁移命令：

hermes claw migrate

它会自动检测 ~/.openclaw 目录，将人设文件、跨会话记忆、用户自建技能、API Key 和消息渠道配置全部导入，且不会删除原有数据，迁移后两个工具可以同时保留。

九、进阶玩法

📋 定时任务（Cron 调度）

Hermes Agent 内置调度器，支持用自然语言定义定时任务：

hermes schedule "每天早上 8 点，汇总我的邮件并发送到飞书"

🛠️ 技能创建与复用

Hermes Agent 最核心的特性是自动学习——当你完成一个复杂的多步骤任务后，它会自动将经验提炼为可复用的技能文件。后续遇到类似任务时，可以直接调用这些技能，效率大幅提升。

十、常见问题 FAQ

Q：Windows 怎么安装？
A：需要先安装 WSL2，然后在 WSL2 的 Linux 子系统中安装。

Q：安装后 hermes 命令找不到？
A：尝试执行 source ~/.bashrc 或重新打开终端。

Q：需要收费吗？
A：Hermes Agent 本身是 MIT 协议的开源项目，完全免费。调用大模型 API 会产生费用，但可通过本地模型（Ollama）免费使用。

Q：内存不够怎么办？
A：可使用云服务器部署，阿里云轻量应用服务器最低 38 元/年，或使用 Docker 部署在较低配置的机器上（最低 1GB 内存）。

Q：安装后如何更新？
A：执行 hermes update 即可一键更新到最新版本。