02. 安装与初始化
这一章解决最实际的问题：怎样把 Hermes Agent 安装好、初始化好，并确认它真的可用。
本章目标
- 完成 Hermes Agent 安装
- 理解
~/.hermes目录和关键配置文件 - 完成第一次
hermes setup - 知道开发仓库与普通安装的差别
适用读者
- 新用户
- 准备在本机或服务器上部署 Hermes 的用户
- 准备修改仓库源码的开发者
前置条件
- Linux、macOS 或 WSL2 环境
- 网络可访问安装依赖
- 至少准备一个模型 provider 的 API key 或 OAuth 登录方式
核心概念
Hermes 的默认家目录
默认情况下，Hermes 的配置和状态文件都在 ~/.hermes/ 下。最常见的文件是：
~/.hermes/config.yaml~/.hermes/.env~/.hermes/SOUL.md~/.hermes/skills/~/.hermes/sessions/
如果你使用 profile 或设置了 HERMES_HOME，这些路径会被隔离到对应目录。
安装和开发是两条路径
- 普通使用者：用官方安装脚本最快
- 仓库开发者：在仓库里建虚拟环境并安装
.[all,dev]
操作步骤
方式一：官方安装脚本
这是最简单的路径：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
安装完成后，重新加载 shell：
source ~/.bashrc
# 或者
source ~/.zshrc
然后直接启动：
hermes
方式二：开发者从仓库安装
如果你要修改这个仓库本身，建议使用下面的流程：
git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all,dev]"
如果你就在本仓库里工作，请记住 AGENTS.md 给出的开发约束：运行 Python 相关命令前应先执行：
source venv/bin/activate
第一次执行 setup
安装后建议立刻运行：
hermes setup
你也可以分模块执行：
hermes setup model
hermes setup terminal
hermes setup gateway
hermes setup tools
hermes setup agent
hermes setup 主要帮助你完成这些事情：
- 选择 provider 和默认模型
- 配置 terminal backend
- 配置 gateway 平台
- 配置工具
- 初始化 agent 行为设置
准备 .env
Hermes 会从 ~/.hermes/.env 读取大量环境变量。最基础的是模型 provider：
OPENROUTER_API_KEY=your_key_here
其他能力如 web、browser、TTS、Gateway、MCP 往往也需要额外变量。后面在配置章节会集中展开。
验证安装是否成功
推荐依次跑下面几个命令：
hermes version
hermes doctor
hermes status
hermes
如果你能进入 CLI，并正常发出一条消息，说明基础安装已经通了。
常见场景
场景 1：在自己电脑上做本地助手
最常见组合是：
- 官方安装脚本
- 默认
~/.hermes - 只先配置一个 provider
- 暂时不启用 Gateway
场景 2：在服务器上长期运行
更常见的组合是：
- 安装后先配好
hermes gateway - 设置 allowlist
- 配置 home channel
- 再逐步加 cron 和 MCP
场景 3：准备参与仓库开发
你应该优先用仓库安装方式，并且在运行测试、脚本和 Python 命令前先激活 venv。
常见问题与排错
Windows 能直接用吗
官方不支持原生 Windows。推荐使用 WSL2。
hermes 命令找不到
通常是安装后没有重新加载 shell，或者 PATH 没更新。先尝试重新打开终端，或者 source ~/.bashrc / source ~/.zshrc。
hermes doctor 报 provider 未配置
这通常不是安装失败，而是还没有可用的模型凭据。先配置 ~/.hermes/.env，或者运行 hermes model / hermes auth 完成认证。
我什么时候应该开始用 profile
如果你已经知道自己会同时维护“工作助手”“私人助手”“机器人实例”这类多个隔离环境，那么在一开始就用 profile 会比后面迁移更省事。
本章总结
安装 Hermes 并不难，真正重要的是把配置目录、初始化流程和 provider 凭据这三件事弄清楚。只要这一步稳住，后面 CLI、Gateway、工具和自动化就容易很多。
下一步建议
继续看 首次运行与 CLI 基础，把第一次真实使用跑通。
Top comments (0)