Hermes Agent 安装与使用指南:从模型配置到首次对话

这是Hermes Agent深度剖析系列文章第十篇

Hermes Agent 的安装思路很直接：先把运行环境装好，再配置模型供应商，最后进入 CLI/TUI 或 Gateway。官方安装文档给出的最快方式是一行命令，适用于 Linux、macOS、WSL2 和 Android Termux；原生 Windows 不支持，建议先安装 WSL2。

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

官方文档说明，安装器会自动处理依赖，包括 uv、Python 3.11、Node.js v22、ripgrep 和 ffmpeg，并完成仓库克隆、虚拟环境、全局 hermes 命令和模型配置。普通用户安装时，代码通常位于 ~/.hermes/hermes-agent/，命令链接位于 ~/.local/bin/hermes，数据目录位于 ~/.hermes/。

步骤	命令	目的
安装	`curl ...	bash`
启动	`hermes` 或 `hermes --tui`	进入交互会话
配模型	`hermes model`	选择供应商和模型
配工具	`hermes tools`	启用或禁用工具集
配网关	`hermes gateway setup`	接入消息平台
全量设置	`hermes setup`	运行配置向导
诊断	`hermes doctor`	排查环境问题

安装后第一件事不是急着启用所有功能，而是先让一次普通对话跑通。官方 Quickstart 建议先选择 provider，再验证 Hermes 能正常响应，并能在需要时调用终端、文件读取或 Web 搜索等工具。初学者可直接运行 hermes setup，如果已知道模型供应商，则用 hermes model 配置即可。

Hermes 的模型选择很丰富，包括 Nous Portal、OpenAI Codex、Anthropic、OpenRouter、Z.AI、Kimi/Moonshot、MiniMax、Alibaba Cloud、Hugging Face、DeepSeek、NVIDIA NIM、GitHub Copilot、Vercel AI Gateway 和自定义 OpenAI-compatible endpoint 等。需要注意的是，Hermes 要求模型至少有 64K token 上下文窗口，原因是多步工具调用需要足够工作记忆。

配置存储也值得理解。Hermes 会把 secrets 和 tokens 放在 ~/.hermes/.env，把普通配置放在 ~/.hermes/config.yaml。例如可以用如下命令设置模型或 API Key：

hermes config set model anthropic/claude-opus-4.6hermes config set terminal.backend dockerhermes config set OPENROUTER_API_KEY sk-or-...

第一次对话时，可以使用 hermes 启动经典 CLI，也可以用 hermes --tui 启动现代 TUI。TUI 与 CLI 共享会话、斜杠命令和配置。常用斜杠命令包括 /help、/tools、/model、/usage、/compress、/new、/retry 和 /undo。

如果你想把 Hermes 变成团队机器人，下一步是运行 hermes gateway setup，接入 Telegram、Discord、Slack 或其他平台。若要做定时任务，再启用 Cron；若要沉淀复杂流程，再学习 Skills。最好的路径是“先跑通一个聊天，再逐层开启能力”。

如果你从 OpenClaw 迁移而来，还可以使用 hermes claw migrate。Hermes 支持导入 persona、memory、skills、命令 allowlist、消息平台配置、部分 API Key、TTS 资产和工作区指令。建议迁移前先执行 dry-run 预览冲突，迁移后再用 hermes doctor 检查环境，并用一次简单对话验证模型、工具和会话保存都正常。

本章小结：Hermes Agent 的安装并不复杂，关键是遵循顺序：先安装，后配模型，再验证基础对话，最后逐步启用工具、Gateway、Cron 和 Skills。它的优势不在安装命令本身，而在安装后立即拥有一个可扩展的 Agent 工作环境。对新用户来说，先用 hermes setup 和 hermes doctor 建立稳定基础，是最稳妥的开始。