Hermes Agent 保姆级安装教程:从零打造你的本地 AI 助手,全平台覆盖!

10万星开源项目、OpenClaw 平滑迁移、支持 6 大平台消息通道

——这就是目前最值得部署的 AI Agent

📖 一、什么是 Hermes Agent？

Hermes Agent 是由 Nous Research 开发的开源 AI Agent 项目，在 GitHub 上已斩获 103,000+ ⭐ Star，是当前最热门的开源 AI 助手框架之一。

它最大的特点是——内置学习闭环：

✅ 技能自我进化——从使用经验中自动创建技能，边用边成长
✅ 记忆持久化——FTS5 会话搜索 + LLM 摘要，跨会话记忆无缝衔接
✅ 用户画像构建——通过 Honcho dialectic 用户建模，深度了解你的偏好和习惯
✅ 定时自动化——内置 cron 调度器，用自然语言设置每日报告、每周提醒
✅ 子 Agent 并行——拆分复杂任务，多线程并行执行，降本增效
✅ 支持 6 大终端后端——本地、Docker、SSH、Daytona、Singularity、Modal

更厉害的是，Hermes Agent 不绑定你的电脑——装在云端 VPS 上，通过 Telegram、Discord、Slack、WhatsApp、Signal 等平台远程操控，真正的"随身 AI 助手"。

💡 一句话总结：Hermes Agent 是一个「会成长的 AI 助手」——你用它越多，它越懂你，越能帮你干活。

🔌 支持的模型生态

Hermes Agent 采用开放式模型架构，一行命令切换任意 LLM：

Nous Portal / OpenRouter（200+ 模型）
NVIDIA NIM（Nemotron）/ Xiaomi MiMo
z.ai/GLM / Kimi/Moonshot / MiniMax
Hugging Face / OpenAI / Anthropic
或任何兼容 OpenAI 格式的自定义端点

📡 支持的消息平台

一个进程搞定所有消息入口：

Telegram	Discord	Slack	WhatsApp	Signal	Email
✅	✅	✅	✅	✅	✅

⚔️ 二、Hermes Agent vs OpenClaw — 核心对比

很多朋友已经在用 OpenClaw 了，Hermes Agent 有什么不同？值不值得迁移？一张表说清楚：

对比维度	Hermes Agent	OpenClaw
GitHub Stars	103,000+ ⭐	企业级闭源 / 开源
开源协议	✅ MIT 开源	部分开源
内置学习闭环	✅ 自动创建技能 + 自优化	技能需手动编写
记忆系统	✅ FTS5 + LLM 摘要 + Honcho	✅ MEMORY.md 持久化
定时任务	✅ 内置 cron + 多平台投递	✅ Cron 技能
消息通道	T/D/S/Wa/Si/Email	T/D/S/Wa/Signal/Q/WeChat
子 Agent 并行	✅ 原生支持 RPC 调用	✅ subagent 工具
模型灵活性	✅ 200+ 模型 OpenRouter	支持主流模型
安装难度	⚠️ 需 WSL2（Windows）	✅ 原生 Windows 支持
OpenClaw 迁移	✅ 一键迁移脚本	—
适合人群	开发者 / 技术爱好者 / 自托管党	全栈用户 / 企业 / 小白

💡 选 Hermes Agent：如果你追求开源、自托管、学习型 Agent、喜欢折腾技术细节
选 OpenClaw：如果你需要开箱即用、原生 Windows 支持、微信渠道、偏向小白友好

好消息是——Hermes Agent 内置了 OpenClaw 迁移工具，可以一键导入你的 SOUL.md、记忆、技能、API Key 等，零成本切换，无需从头配置！

🛠️ 三、安装前的准备工作

Hermes Agent 依赖 Python 3.11+ 和 uv 包管理器。无论你用哪个系统，先确保以下条件满足：

📋 通用准备清单

准备项	说明	必须
LLM API Key	OpenRouter / OpenAI / Nous Portal 等任选其一	⚠️ 必需
Python 3.11+	检查：python --version	✅ 必需
uv 包管理器	安装脚本会自动安装	✅ 自动
Git	用于克隆仓库 / 开发者模式	🔶 推荐
稳定的网络	GitHub 访问 / 模型 API 连接	⚠️ 必需

🪟 四、Windows 系统安装（WSL2 方案）

⚠️ 重要提示：Hermes Agent 暂不支持原生 Windows 安装，需通过 WSL2（Windows Subsystem for Linux 2）运行 Linux 环境来安装。好在这并不复杂！

📌 步骤 1：安装 WSL2（如果没有）

以管理员身份打开 PowerShell 或命令提示符，执行：

# 一键安装 WSL2 + Ubuntu（需要重启电脑）
wsl --install

# 如果提示需要重启，重启后会自动继续
wsl --status

# 确认 WSL2 默认版本
wsl --set-default-version 2

安装完成后，会自动打开 Ubuntu 终端，让你创建 Linux 用户名和密码。完成后你会进入一个 Linux 终端界面（如 `yuanweiwei@DESKTOP-XXX:~$`）。

📌 步骤 2：安装 Hermes Agent

在 Ubuntu 终端中粘贴并运行以下命令（一键安装脚本）：

# 一键安装脚本（自动安装 Python、uv 及所有依赖）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装过程大约需要 2-5 分钟（取决于网速），会自动完成：

✅ 检测系统环境
✅ 安装 Python 3.11+（如未安装）
✅ 安装 uv 包管理器
✅ 创建 Python 虚拟环境
✅ 安装 Hermes Agent 及全部依赖
✅ 配置命令行快捷方式

📌 步骤 3：激活环境并启动

# 重新加载 shell 配置
source ~/.bashrc

# 启动 Hermes Agent！
hermes

首次运行会自动进入引导设置向导（`hermes setup`），配置你的 LLM API Key、消息平台等。建议运行：

hermes setup # 全量设置向导
hermes model # 选择 LLM 提供商和模型
hermes tools # 配置启用的工具
hermes doctor # 诊断问题

📌 步骤 4：配置 LLM API Key

首次使用需要配置一个 LLM API Key。这里以 OpenRouter 为例（支持 200+ 模型，含 Claude/GPT/国产模型）：

hermes config set openrouter_api_key your_api_key_here

# 选择使用 OpenRouter + 推荐模型
hermes model openrouter:anthropic/claude-3-haiku

💡 小贴士：OpenRouter 有免费额度，新用户赠送 $1，可试用 Claude Haiku 等模型。官网：openrouter.ai

🍎 五、macOS 系统安装

macOS 原生支持，比 Windows 简单很多！打开终端（Terminal.app）直接执行：

# 一键安装脚本（macOS 原生支持）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

📌 方式二：从源码安装（开发者推荐）

如果你想参与开发或自定义修改，推荐从源码安装：

# 克隆仓库
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent

# 自动安装脚本（推荐）
./setup-hermes.sh

# 或者手动安装（等价命令）
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"

📌 启动与配置

# 激活虚拟环境
source venv/bin/activate

# 启动
./hermes # 直接运行（自动检测虚拟环境）
hermes setup # 完整设置向导

🐧 六、Linux 系统安装

Linux 平台和 macOS 类似，终端直接执行：

# 一键安装（Ubuntu / Debian / Fedora / Arch 等通用）
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

📌 云服务器部署（VPS / 云主机）

Hermes Agent 的一大亮点——可以部署在 $5/月的低配 VPS 上，7×24 小时运行，通过 Telegram 远程控制：

推荐配置：1核1GB RAM 起，SSD 20GB+
推荐系统：Ubuntu 22.04 LTS
可选平台：DigitalOcean / Vultr / 阿里云国际版 / 腾讯云轻量

# SSH 登录服务器后执行
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 配置 Telegram Bot（需要先 @BotFather 创建）
hermes config set telegram_bot_token your_telegram_bot_token
hermes gateway start

💡 推荐搭配 Daytona / Modal：这两个平台提供 Serverless 持久化——Agent 空闲时自动休眠（几乎零成本），收到消息时自动唤醒，非常适合低频使用场景。

🔄 七、从 OpenClaw 平滑迁移

这是 Hermes Agent 最有诚意的功能之一——一键导入 OpenClaw 全部配置，包括：

✅ SOUL.md — 人格设定文件
✅ 记忆文件 — MEMORY.md 和 USER.md
✅ 自定义技能 — 导入到 ~/.hermes/skills/openclaw-imports/
✅ API Keys — Telegram / OpenRouter / OpenAI / Anthropic 等
✅ 消息平台配置 — 平台设置和权限白名单
✅ 工作区指令 — AGENTS.md 等

📌 迁移方式一：首次安装引导

首次运行 `hermes setup` 时，安装向导会自动检测 `~/.openclaw` 目录，在配置开始前主动询问是否迁移，零门槛。

📌 迁移方式二：命令行迁移（任选时机）

# 交互式迁移（含预览确认）
hermes claw migrate

# 预览模式：查看会迁移哪些内容（不实际执行）
hermes claw migrate --dry-run

# 仅迁移用户数据（不含 API Key）
hermes claw migrate --preset user-data

# 覆盖已有冲突项
hermes claw migrate --overwrite

💡 安全提示：迁移 API Key 时会经过 allowlist 确认，如需排除特定密钥，使用 `--preset user-data` 模式跳过敏感信息。

❓ 八、常见问题 FAQ

Q1：安装后提示 command not found？

确保运行了 source ~/.bashrc（或 source ~/.zshrc），或者重启终端窗口。

Q2：Windows 上 WSL2 安装失败？

确保在 BIOS 中启用了虚拟化（Intel VT-x / AMD-V），并以管理员身份运行 PowerShell。参考：微软官方 WSL2 安装指南

Q3：如何更新到最新版本？

hermes update

Q4：Hermes Agent 和 OpenClaw 可以同时运行吗？

可以！两者相互独立，互不干扰。你可以在同一台机器上同时运行，享受各自的优势。社区也开发了 HermesClaw 桥接工具，可以同时在微信上使用两个 Agent。

Q5：Termux 安卓手机上可以用吗？

可以！参考 Termux 部署指南，安装 .[termux] 专用依赖包。

🚀 写在最后

Hermes Agent 代表了开源 AI Agent 的新高度——会学习、会成长、会在使用中变得越来越懂你。结合 OpenClaw 的平滑迁移方案，你可以零成本体验这个学习型 Agent 的魅力。

不管你是想在手机上随时召唤 AI 助手，还是想在VPS 上跑一个 7×24 小时的私人助理，又或者想让 AI 在后台自动完成周期性任务——Hermes Agent 都是一个值得尝试的选择。

安装只需一行命令，从今天开始，让你的 AI 助手真正"成长"起来吧。

📌 GitHub：github.com/NousResearch/hermes-agent（103K+ ⭐）

📌 官方文档：hermes-agent.nousresearch.com/docs

📌 Discord 社区：discord.gg/NousResearch

📌 Skills Hub：agentskills.io