快速入门

本指南旨在帮助你从零开始搭建一个能够投入实战的 Hermes 环境。包括安装、选择服务商、验证聊天功能，以及在出现问题时明确处理方案。

适用人群

• 新手：希望以最短路径完成安装。

• 更换服务商用户：不想在配置错误上浪费时间。

• 进阶用户：正在为团队、机器人或常驻工作流配置 Hermes。

• 挫败者：厌倦了“安装成功但无法运行”的窘境。

最快路径

根据你的目标选择第一步：

目标	第一步	第二步
只想在本地运行	执行 hermes setup	进行一次真实对话并验证回复
已知服务商	执行 hermes model	保存配置后开始聊天
设置机器人/常驻流	执行 hermes gateway setup	在 CLI 调通后连接 Telegram/Discord 等
使用本地/自建模型	hermes model → 自定义端点	验证端点、模型名及上下文长度
多服务商故障切换	先配置 hermes model	基础功能调通后再添加路由和回退

准则： 如果 Hermes 连基本的聊天都无法完成，请不要急于添加更多功能。先搞定一次干净的对话，然后再叠加网关（Gateway）、定时任务（Cron）、技能（Skills）、语音或路由功能。

---

1. 安装 Hermes Agent

执行一键安装脚本：

Bash

# Linux / macOS / WSL2 / Android (Termux)
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

• Android / Termux：请参考专门的 Termux 指南 进行手动安装及查看限制。

• Windows 用户：请先安装 WSL2，然后在 WSL2 终端内运行上述命令。

安装完成后，重载你的 Shell：

Bash

source ~/.bashrc   # 或 source ~/.zshrc

---

2. 选择服务商

这是最关键的一步。使用交互式命令进行选择：

Bash

hermes model

推荐路径：

• 最省心：Nous Portal 或 OpenRouter

• 已有 Claude/OpenAI 账号：Anthropic 或 OpenAI Codex

• 本地/私有推理：Ollama 或任何兼容 OpenAI 的端点

• 多服务商路由：OpenRouter

[重要] 最小上下文限制：64K Tokens

Hermes 需要模型至少支持 64,000 tokens 的上下文。由于多步工具调用需要大量工作记忆，窗口过小的模型将被拒绝启动。本地运行（如 llama.cpp 或 Ollama）时，请务必设置 --ctx-size 65536。

设置存储方式

Hermes 将密钥与普通配置分开存放：

• 密钥与 Token → ~/.hermes/.env

• 普通设置 → ~/.hermes/config.yaml

建议直接使用 CLI 进行设置，系统会自动归类：

Bash

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

---

3. 运行首次聊天

Bash

hermes            # 经典命令行界面
hermes --tui      # 现代终端界面 (推荐)

测试建议：

1. 总结当前仓库并找出主入口。

2. 检查当前目录并识别核心项目文件。

3. 让它帮你创建一个 GitHub PR 工作流。

成功标准：

• 横幅显示了正确的模型/服务商。

• 回复无报错且能正常使用工具（如读取文件、搜索）。

• 对话可以持续多轮。

---

4. 验证会话恢复

确保断点续传功能正常：

Bash

hermes --continue    # 或简写 hermes -c

如果能回到刚才的对话，说明配置成功。