§ 环境要求
| 操作系统 | Linux、macOS、WSL2、Android (Termux) |
| Python | 3.11+（安装脚本会自动处理） |
| Windows | ⚠ 不支持原生 Windows，请使用 WSL2 |
§ Windows 用户：先安装 WSL2
如果你使用 Windows，需要先安装 WSL2 (Windows Subsystem for Linux)。这是微软官方的 Linux 兼容层，性能接近原生。
1. 以管理员身份打开 PowerShell，执行：
bash
wsl --install
这会安装 WSL2 和默认的 Ubuntu 发行版。安装完成后需要重启电脑。
2. 重启后，打开 Ubuntu 终端，设置用户名和密码
3. 更新系统（建议换国内源加速）：
bash
# 换清华源（可选，加速下载）
sudo sed -i 's|archive.ubuntu.com|mirrors.tuna.tsinghua.edu.cn|g' /etc/apt/sources.list
sudo apt update && sudo apt upgrade -y
§ 一键安装
关于 uv
Hermes Agent 使用 uv 作为底层安装工具。 uv 是 Astral 团队用 Rust 开发的 Python 包管理器，集 pip + pyenv + virtualenv 于一体，速度比 pip 快 10-100 倍。 安装脚本会自动安装 uv，无需手动操作。
方式一：国内加速安装（推荐）
bash
curl -fsSL https://ghfast.top/https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
通过 ghfast.top 代理加速 GitHub 访问，自动安装 uv → Python 3.11 → 克隆仓库 → 安装依赖。
💡 如果 ghfast.top 不可用
GitHub 代理站可能会变化，你也可以：
- 先设置代理再运行官方命令：
export https_proxy=http://127.0.0.1:7890 - 替换为其他镜像前缀（如
https://mirror.ghproxy.com/） - 使用下方的手动安装方法
方式二：官方命令（可直连 GitHub 时）
bash
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
需能访问 raw.githubusercontent.com。自动安装 uv → Python 3.11 → 克隆仓库 → 安装依赖。
方式三：uv tool install（已有 uv 的用户）
bash
# 如果你已经安装了 uv，可以直接从 PyPI 安装：
uv tool install "hermes-agent[cron,cli,pty,mcp]" --python 3.11
uv 会自动创建隔离环境，hermes 命令自动加入 PATH。 国内可加清华镜像：--index-url https://pypi.tuna.tsinghua.edu.cn/simple。 升级用 uv tool upgrade hermes-agent。
方式四：手动安装（完全自主控制）
bash
# 1. 安装 uv（Python 包管理器）
curl -LsSf https://astral.sh/uv/install.sh | sh
source ~/.bashrc
# 2. 克隆仓库（国内可替换为镜像地址）
git clone https://ghfast.top/https://github.com/NousResearch/hermes-agent.git ~/.hermes/agent
cd ~/.hermes/agent
# 3. 创建虚拟环境并安装
uv venv venv --python 3.11
source venv/bin/activate
uv pip install -e ".[all]"
# 4. 添加到 PATH
echo 'export PATH="$HOME/.hermes/agent/venv/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc
安装完成后验证
bash
source ~/.bashrc # 重新加载 shell
hermes --version # 应显示版本号
§ 初始配置
运行交互式设置向导
bash
hermes setup
向导会引导你选择 LLM 提供商和模型。国内用户推荐选择：
| 提供商 | 推荐模型 | 说明 |
|---|---|---|
| 智谱 AI | glm-4-plus | 国产首选，中文能力强 |
| Kimi | moonshot-v1-128k | 超长上下文，适合文档处理 |
| MiniMax | abab6.5s-chat | 国内版和国际版均可 |
| OpenRouter | claude-3.5-sonnet | 200+ 模型，需翻墙 |
§ 开始使用
启动交互式对话
bash
hermes
这会打开完整的终端界面 (TUI)，支持多行编辑、斜杠命令自动补全、对话历史和流式工具输出。
常用命令速查
| hermes | 启动交互式对话 |
| hermes model | 选择/切换 LLM 模型 |
| hermes tools | 管理启用的工具集 |
| hermes config set | 修改配置项 |
| hermes gateway setup | 配置消息平台网关 |
| hermes gateway run | 启动消息网关（前台） |
| hermes skills browse | 浏览可用技能 |
| hermes update | 更新到最新版本 |
| hermes doctor | 诊断问题 |
§ 对话中的斜杠命令
在 CLI 或消息平台中，你可以使用以下斜杠命令控制 Agent：
| /new 或 /reset | 开始新对话 |
| /model [模型名] | 切换模型 |
| /personality [名称] | 设置个性 |
| /retry | 重新生成上一条回复 |
| /undo | 撤销上一轮对话 |
| /compress | 压缩上下文（节省 token） |
| /usage | 查看 token 使用情况 |
| /skills | 浏览技能列表 |
| /stop | 中断当前任务 |