#Hermes Agent 安装与使用

本章带你完成安装、初始化配置，并完成第一次对话。

#系统要求

• 操作系统：Linux、macOS、WSL2，或 Android 上的 Termux
• 网络：能访问所选 LLM Provider（Nous Portal / OpenRouter 等）
• 安装脚本会自动准备 uv、Python 3.11、Node.js、ripgrep、ffmpeg、内置 Git（MinGit）

你不需要预先手动安装 Python，一键脚本会处理好运行环境。

#一键安装

Linux / macOS / WSL2 / Termux：

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

Windows（PowerShell）：

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

安装脚本会自动完成：拉取仓库、创建虚拟环境、安装依赖、注册 hermes 命令。

#从源码安装（开发者）

git clone https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
./setup-hermes.sh
./hermes

手动等价步骤：

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]"

#初始化配置：hermes setup

安装完成后，运行配置向导：

hermes setup

向导会逐步引导你完成：

1. 选择模型 Provider（Nous Portal / OpenRouter / 本地 vLLM / 自定义端点）
2. 填写凭据（OAuth 登录或 API Key）
3. 选择默认模型
4. 挑选要启用的工具
5. （可选）配置消息网关

如果只想单独做某一步，也可以用细分命令：

hermes model            # 选择 LLM Provider 与模型
hermes tools            # 配置启用的工具
hermes config set <键> <值>   # 设置单个配置项
hermes gateway setup    # 配置消息平台

#第一次对话

直接运行 hermes 进入交互式终端 UI：

hermes

你会看到一个对话界面，试着输入：

你好，请做个自我介绍，并告诉我你能帮我做什么。

随后可以让它执行真实任务，例如：

帮我在当前目录建一个名为 notes 的文件夹，并写一个 README.md 说明用途。

Hermes 会请求执行相应工具（如写文件、运行命令），并在你批准后执行。

#常用 CLI 命令速查

#更新与诊断

hermes update     # 升级到最新版
hermes doctor     # 自检：环境、依赖、配置问题

遇到问题时，先跑 hermes doctor，它会检查运行环境、依赖与配置并给出建议。

#从 OpenClaw 迁移

若你此前使用 OpenClaw，可一键迁移人设、记忆、技能与密钥：

hermes claw migrate                    # 完整迁移
hermes claw migrate --dry-run          # 仅预览将发生的变更
hermes claw migrate --preset user-data # 不含密钥，仅迁移用户数据
hermes claw migrate --overwrite        # 覆盖冲突项

#下一步

• 配置模型 — 接入并切换你的 LLM
• 斜杠 / 命令 — 对话中的快捷命令
• 上手实战 — 从零搭一个个人助理