夜雨聆风这是一篇面向新手的 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 之前，你只需要确认两件事：
1. Git 已安装——安装脚本会自动处理其余所有依赖
2. 准备好一个大模型 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 # 如果使用 bashsource ~/.zshrc # 如果使用 zsh
第 3 步：验证安装
hermes --version如果看到类似
hermes v0.8.0的版本信息，说明安装成功。
🚀 方式二：阿里云轻量应用服务器部署（新手首选）
如果你不想在本地折腾环境，或者希望 Agent 24 小时在线，这是最佳选择。
第 1 步：选购服务器
登录阿里云轻量应用服务器控制台，在创建实例时选择“应用镜像”分类下的 Hermes Agent 官方镜像，内存至少 2GiB。
> 💰 价格参考：2核2G配置约 38 元/年，2核4G约 199 元/年。
第 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这个交互式配置向导会引导你完成以下步骤：
1. 选择 LLM 提供商——国内用户推荐选择 OpenRouter（聚合 200+ 模型，一个密钥通吃）或阿里云百炼
2. 输入 API Key——填入你获取的 API 密钥
3. 选择默认模型——按提示选择一个模型作为默认
4. 配置工具——决定启用哪些内置工具模块（文件操作、Shell 执行、浏览器自动化等）
5. 配置消息网关（可选）——接入 Telegram、飞书等平台
配置完成后，输入
hermes即可进入对话窗口。
四、接入消息平台（让 Agent 为你打工）
Hermes Agent 最强大的功能之一是可以接入微信、飞书、Telegram 等平台，成为随时在线的数字助手。
📱 接入飞书（详细步骤）
第 1 步：飞书开放平台配置
1. 访问 https://open.feishu.cn/，登录后进入开发者后台
2. 点击“创建企业自建应用”，输入应用名称和描述
3. 添加机器人能力，配置必要权限：
im:message和
im:resource4. 在“凭证与基础信息”中获取 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- 方案 C：配置 Git 全局代理**（如果你有代理工具）
git config --global http.proxy http://127.0.0.1:7890git 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：执行 `hermes update` 即可一键更新到最新版本。
