Hermes Agent 第1天跑通基础对话极简上手路线【教程】

目标很明确：今天就让 Hermes Agent 在你的电脑上开口说话，不装虚拟机、不改配置文件、不碰那些烦人的 YAML。只用终端敲几行命令，10 分钟内收到第一句结构化 AI 回复——这事儿完全可行，而且必须从最干净的安装路径开始。

第一步：确认环境并执行一键安装

先检查 Python 版本是否 ≥3.10：运行 python3 --version，若输出类似 Python 3.11.9 即合格；低于此版本请先升级。macOS / Linux / WSL2 用户直接执行安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash。该脚本会自动安装 Python 依赖、Node.js、Git，并创建 ~/.hermes/ 目录。Windows 用户必须使用 WSL2，不能在 CMD 或 PowerShell 中运行此命令。

安装完成后立即加载新环境变量：source ~/.bashrc（若用 zsh，则改用 source ~/.zshrc）。这一步漏掉会导致后续所有 hermes 命令报“command not found”。

第二步：启动交互终端并完成首次对话

在终端中输入 hermes，等待约 5–8 秒，看到 Hermes> 提示符后，直接输入 你好 并回车。

若返回内容包含欢迎语、当前模型标识（如 Model: MiMo V2 Pro）及基础能力说明（如“支持网页浏览、文件解析、Shell 执行”），即表示通信链路已通。此时无需任何 API Key、无需配置模型——Hermes 默认启用了本地轻量模型兜底机制，专为这一刻准备。

第三步：运行快速配置向导补全模型接入

保持在 Hermes> 环境中，输入斜杠命令：/setup（或退出后在普通终端运行 hermes setup）。

方法一：选择 Quick setup — provider, model & messaging (recommended) → 按方向键选中后回车 → 依次操作：

① 服务商选 OpenRouter（免费额度高，无需注册即可用）；

② API Key 处直接留空并回车（OpenRouter 允许匿名调用部分模型）；

③ 模型选 qwen3.5:cloud（响应快、中文强、免密可用）；

④ 聊天通道选 Skip for now，不启用网关，专注终端交互。

向导结束后，系统自动生成 ~/.hermes/config.yaml 并初始化记忆模块。此时不用重启终端，直接输入 /model list 可看到当前已激活模型列表。

第四步：用真实问题触发一次完整工具链响应

回到 Hermes> 提示符下，输入：请帮我查一下今天北京的天气，并用表格形式返回温度、湿度、风速三项。

如果 Hermes 自动调用联网搜索工具、解析结果、生成 Markdown 表格并返回，说明模型+工具+记忆三层链路全部就绪。若提示“未启用工具”，则退回上一步，在 setup 中开启 Shell 和 Web 工具开关；若卡在“正在思考…”超 30 秒，说明当前模型响应慢，可临时切到本地模型：/model ollama/gemma4（需提前 ollama pull gemma4）。