2. 安装与一键部署

两条安装路径

Hermes Agent 当前最新稳定版 v2026.7.20 提供两种安装入口：

1. 桌面安装器（推荐）：从官网下载 Hermes Desktop 安装包，一键装好命令行工具和桌面应用。macOS 和 Windows 都支持。
2. 纯命令行安装：跑一行脚本，只装命令行工具，不装桌面应用。适合服务器、VPS 或者你只想要 CLI 的场景。

下面主要讲命令行安装，因为它是跨平台通用的基础方式。桌面安装器本质上也是在底层帮你跑这套流程。

一行命令搞定：Linux / macOS / WSL2 / Termux

在 Linux、macOS、WSL2 或者 Android 的 Termux 里，打开终端，跑这一行：

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

装完之后，重新加载一下 shell 配置：

source ~/.bashrc    # 或者 source ~/.zshrc

然后直接敲：

hermes              # 开始聊天！

就这么简单。这一行脚本会自动处理所有依赖。

Windows 原生安装：PowerShell

Windows 不用装 WSL 也能跑 Hermes Agent。原生 Windows 完整支持 CLI、网关、TUI 和工具。

在 PowerShell 里跑：

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

这个脚本会帮你装好一切：uv、Python 3.11、Node.js、ripgrep、ffmpeg，外加一个便携版 Git Bash（MinGit，解压到 %LOCALAPPDATA%\hermes\git，不需要管理员权限，完全隔离于系统 Git）。

Hermes 用这个内置的 Git Bash 来执行 shell 命令。如果你机器上已经有 Git，安装器会检测到并直接用你已有的，不会重复装。

安装器到底帮你做了什么

很多人装完就用了，不太清楚安装器背后干了啥。这里捋一下，出问题的时候你才知道去哪查。

安装器自动完成这些事：

• 装 uv（快速的 Python 包管理器）
• 装 Python 3.11（通过 uv，不需要 sudo）
• 装 Node.js v22（浏览器自动化和 WhatsApp 桥接要用）
• 装 ripgrep（快速文件搜索）
• 装 ffmpeg（TTS 音频格式转换要用）
• 克隆代码仓库，创建虚拟环境
• 设置全局 hermes 命令
• 引导你配置 LLM 提供商

也就是说，你不需要手动装 Python、Node.js 这些。安装器会检测缺什么就补什么。你唯一要确保有的是 Git（非 Windows 平台）和 curl + xz-utils（Linux 平台）。

git --version                    # 确认 Git 在
sudo apt install curl xz-utils   # Debian/Ubuntu 确保 curl 和 xz 在

装完文件都在哪

了解安装目录结构，后续排查问题、手动改配置都用得上。

普通用户安装

内容	路径
代码仓库	~/.hermes/hermes-agent/
hermes 命令	~/.local/bin/hermes（符号链接）
数据目录	~/.hermes/

Root 模式安装（sudo curl … | sudo bash）

内容	路径
代码仓库	/usr/local/lib/hermes-agent/
hermes 命令	/usr/local/bin/hermes
数据目录	/root/.hermes/（或 $HERMES_HOME）

Root 模式用的是 FHS 标准布局（/usr/local/lib/…、/usr/local/bin/hermes），和 Linux 上其他系统级开发工具放的位置一致。适合共享服务器上做一个系统级安装，服务所有用户。不过每个用户的配置（认证、技能、会话）仍然存在各自用户目录下的 ~/.hermes/ 里。

首次启动：跑通第一次对话

装完之后，按这个顺序来：

1. 选模型提供商（最重要的一步）：

hermes model

这会进入交互式选择，让你挑 LLM 提供商和模型。

2. 开始对话：

hermes              # 经典 CLI
hermes --tui        # 现代 TUI（推荐）

你会看到一个欢迎横幅，显示当前模型、可用工具和技能。试试这种容易验证的提示词：

看看我当前目录，告诉我哪个像是主项目文件。

成功的标志是：横幅显示你选的模型、Hermes 正常回复、需要时会调用工具（读文件、跑命令）、对话能持续多轮。

3. 验证会话能恢复：

hermes --continue    # 恢复最近一次会话
hermes -c            # 简写

如果这条命令能把你带回刚才的会话，说明会话存储正常。这很重要，后面你会在多个环境或机器之间切换，会话恢复是基础。

安装模式自动检测

Hermes 会自动检测它是通过哪种方式装的（git 安装器、Docker、还是 NixOS），然后 hermes update 会给出对应的更新命令。不需要手动设环境变量，检测基于安装目录布局来做。hermes doctor 也会在环境摘要里显示检测到的安装方式。

常见安装问题

症状	原因	解决
hermes: command not found	shell 没重载	跑 source ~/.bashrc，或检查 PATH
API key not set	没配提供商	跑 hermes model 配置，或 hermes config set OPENROUTER_API_KEY 你的key
更新后配置丢失	配置格式变了	跑 hermes config check 再 hermes config migrate

出问题了怎么办

感觉哪里不对的时候，按这个顺序排查：

1. hermes doctor — 诊断问题，告诉你缺什么、怎么修
2. hermes model — 重新确认提供商、模型、认证
3. hermes setup — 跑完整设置向导
4. hermes sessions list — 查会话列表
5. hermes --continue — 恢复会话
6. hermes gateway status — 查网关状态

这一套组合拳能帮你从「感觉哪里坏了」快速回到正常状态。

下一章我们聊 Hermes Agent 的运行形态—它不只能跑在终端里，还有桌面版、Docker、Web 仪表盘等多种形态。