🦀 Hermes Agent（爱马仕智能体）安装教程

Nous Research 出品 · MIT 开源 · 全球 22万+ star

💡 Hermes Agent 是什么？
Hermes Agent 是 AI 研究机构 Nous Research 开发的开源自主 AI 智能体（爱马仕智能体），支持 macOS / Linux / Windows / 手机。它能像助手一样替你干活：写代码、处理文件、查资料、定时任务、接入微信/Telegram 远程指挥。特点是越用越聪明——它会把经验固化成技能，长期记住你的偏好。完全免费、MIT 开源。

✅ 本页安装命令已与官方文档逐一核实

📋 安装前：确认你的系统

先看下表，找对适合你的安装方式：

你的系统	推荐安装方式
Windows 10/11	Hermes Desktop 桌面版（双击安装）
macOS	Hermes Desktop 桌面版或命令行脚本
Linux / 云服务器 / WSL2	一行命令脚本（最推荐）
手机 Android	Termux 终端（功能略少）

⚠️ 重要提醒
Hermes 命令行版不支持原生 Windows（官方明确说明）。Windows 用户二选一：
① 用 Hermes Desktop 桌面版（最简单）
② 先装 WSL2（Windows 里的 Linux 环境），再在 WSL2 里用命令行装

📥 方案 A：桌面版安装（Windows / macOS，新手最推荐）

1下载安装包

打开官方下载页：

https://hermes-agent.nousresearch.com/

点击 Download，下载对应系统的安装包（Windows 为 .exe，macOS 为 .dmg）。

2安装并启动

双击安装包，按提示点「下一步」完成安装
打开 Hermes 桌面程序
启动时按向导登录、配置即可

3（可选）让桌面版同时装命令行工具

桌面版自带命令行，如果想单独启用命令行模式，终端里输入：

hermes desktop

💻 方案 B：命令行一键安装（Linux / macOS / WSL2）

1确认系统有 Git

打开终端，输入：

git --version

显示版本号 = 已装好，直接进入第 2 步
提示找不到命令 = 先装 Git：
Ubuntu/Debian：sudo apt update && sudo apt install git curl xz-utils
macOS：xcode-select --install

2运行官方一键安装脚本

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

这行命令会自动完成所有事（约 2-3 分钟，不用手动装任何东西）：

安装 uv（Python 包管理工具）
安装 Python 3.11（无需管理员权限）
安装 Node.js v22（浏览器自动化 + WhatsApp 桥接用）
安装 ripgrep（快速搜索）、ffmpeg（音频处理）
克隆官方代码到 ~/.hermes/hermes-agent/
创建 hermes 命令

3刷新终端并验证

source ~/.bashrc
hermes doctor

✅ 显示环境检查正常 = 安装成功
如果提示 hermes: command not found，说明 PATH 没刷新，重新运行 source ~/.bashrc（用 zsh 就执行 source ~/.zshrc）。

🖥️ 方案 C：Windows 原生 PowerShell 安装

如果你的 Windows 环境已准备好，在 PowerShell 里运行：

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

官方对 Windows 更推荐桌面版或 WSL2，此方式适合有经验的用户。

🧠 接入大模型（必做）

Hermes 本身不带模型，必须接入一个大模型才能对话。四种方式任选其一：

方式 1：Nous Portal（官方推荐，最省事）

hermes setup --portal

自动打开浏览器登录 Nous 账号
一个账号用 300+ 模型，还附带工具网关（搜索/图片/语音/浏览器）

方式 2：OpenRouter（一个 Key 用 200+ 模型）

hermes model

选 OpenRouter，粘贴 openrouter.ai 申请的 Key，再选一个模型即可。

方式 3：官方厂商 Key（OpenAI / Anthropic / DeepSeek）

hermes model

选对应厂商，粘贴平台申请的 API Key。国内用户推荐 DeepSeek（直连、便宜）。

方式 4：完全本地免费（Ollama）

hermes model

选 Ollama，全程本地运行、不联网、数据不出电脑。缺点是复杂任务表现一般。

🚀 开始使用

在终端输入：

hermes

进入对话界面，像聊天一样指挥它干活。

常用配置命令：

hermes tools — 开关工具（文件、浏览器、代码等）
hermes gateway setup — 接入微信/Telegram/Discord，手机远程指挥
hermes config set — 修改单项配置
hermes update — 更新到最新版
hermes gateway install — 开机自启（服务器场景）

❓ 常见问题

Q: hermes: command not found？

A: 运行 source ~/.bashrc 刷新终端，或检查 PATH。

Q: API key not set？

A: 运行 hermes model 重新配置模型。

Q: 更新后配置丢失？

A: 运行 hermes config check 然后 hermes config migrate。

Q: 浏览器工具用不了？

A: 需要 Chromium 依赖库，运行 sudo npx playwright install-deps chromium。

Q: 我的数据安全吗？

A: 所有数据（记忆、技能、会话）都存本地 ~/.hermes/，无遥测、无追踪，只有发给大模型的内容会出网（本地 Ollama 则完全不出网）。

🔗 官方资源

官方文档：https://hermes-agent.nousresearch.com/docs
官方 GitHub：https://github.com/NousResearch/hermes-agent
官方下载：https://hermes-agent.nousresearch.com
社区 Discord：discord.gg/NousResearch

📞 需要帮助？

如果安装过程中遇到问题，可以：

添加微信人工协助安装（微信号 AABS00）
访问学习站首页查看更多教程