hermes教程-快速入门

本指南将带你从零开始，完成一个能经受实际使用的 Hermes 配置。安装、选择提供商、验证聊天功能是否正常，并清楚知道当出现问题时该怎么做。

更倾向于观看视频？

Onchain AI Garage 制作了一期大师课，详细讲解了安装、设置和基本命令——如果你更愿意跟着视频学习，本页面是一个很好的补充。更多内容请查看完整的 Hermes Agent 教程与用例 播放列表。

视频： 在 YouTube 上观看

适用人群

• 完全新手，希望以最短路径完成可用配置
• 正在切换提供商，不想因配置错误浪费时间
• 为团队、机器人或始终在线的工作流设置 Hermes
• 厌倦了“安装成功，但什么也没发生”的情况

最快路径

选择与你目标匹配的行：

经验法则： 如果 Hermes 无法完成一次普通聊天，请先不要添加更多功能。先让一次干净的对话正常工作，然后再添加网关、定时任务、技能、语音或路由。

1. 安装 Hermes Agent

使用 Hermes Desktop 安装程序（macOS 或 Windows，推荐）

要轻松安装命令行和桌面应用程序，请从我们的网站下载 Hermes Desktop 安装程序并运行。

不使用 Hermes Desktop：

对于仅命令行安装（无需 Hermes Desktop），请运行：

Linux / macOS / WSL2 / Android (Termux)

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

Windows (原生)

在 PowerShell 中运行：

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

提示 — Android / Termux

如果你在手机上安装，请参阅专门的 Termux 指南，了解经过测试的手动路径、支持的额外功能以及当前 Android 特定的限制。

完成后，重新加载你的 shell：

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

有关详细的安装选项、前提条件和故障排除，请参阅安装指南。

2. 选择提供商

这是最重要的设置步骤。使用 hermes model 以交互方式选择：

hermes model

提示 — 最简单路径：Nous Portal

一个订阅即可覆盖 300+ 模型以及工具网关（网页搜索、图像生成、TTS、云浏览器）。在新安装中：

bashCopy

hermes setup --portal

该命令会登录、将 Nous 设为提供商，并一键启用工具网关。

好的默认选择：

对于大多数首次用户：选择一个提供商，除非你知道为什么要更改，否则接受默认值。完整的提供商目录（包含环境变量和设置步骤）位于提供商页面。

注意 — 最小上下文：64K tokens

Hermes Agent 需要至少 64,000 tokens 上下文的模型。窗口较小的模型无法为多步骤工具调用工作流维持足够的工作记忆，启动时会被拒绝。大多数托管模型（Claude、GPT、Gemini、Qwen、DeepSeek）很容易满足此要求。如果你运行本地模型，请将其上下文大小设置为至少 64K（例如，对于 llama.cpp 使用 --ctx-size 65536，对于 Ollama 使用 -c 65536）。

提示

你可以随时使用 hermes model 切换提供商——没有锁定。有关所有支持的提供商及设置详情，请参阅AI 提供商。

设置如何存储

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

• 密钥和令牌 → ~/.hermes/.env
• 非密钥设置 → ~/.hermes/config.yaml

通过 CLI 设置值是最简单的方法：

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

正确的值会自动写入正确的文件。

3. 运行你的第一次聊天

hermes            # 经典 CLI
hermes --tui      # 现代 TUI（推荐）

你会看到一个欢迎横幅，显示你的模型、可用工具和技能。使用一个具体且易于验证的提示：

提示 — 选择你的界面

Hermes 附带两个终端界面：经典的 prompt_toolkit CLI 和更新的 TUI，后者具有模态覆盖、鼠标选择和非阻塞输入。两者共享相同的会话、斜杠命令和配置——分别用 hermes 和 hermes --tui 试试。

成功的标志：

• 横幅显示你选择的模型/提供商
• Hermes 回复且没有错误
• 如果需要，它可以使用工具（终端、文件读取、网页搜索）
• 对话能正常进行多轮

如果这能工作，你就度过了最困难的部分。

4. 验证会话功能

在继续之前，确保恢复功能正常：

hermes --continue    # 恢复最近的会话
hermes -c            # 简写形式

这应该能让你回到刚才的会话。如果不能，请检查你是否在同一个配置文件中，以及会话是否实际保存了。这在以后当你同时管理多个设置或机器时很重要。

5. 尝试关键功能

使用终端

代理会代表你运行终端命令并显示结果。

斜杠命令

输入 / 查看所有命令的自动补全下拉列表：

多行输入

按 Alt+Enter、Ctrl+J 或 Shift+Enter 添加新行。Shift+Enter 需要终端将其作为独立序列发送（Kitty / foot / WezTerm / Ghostty 默认支持；iTerm2 / Alacritty / VS Code 终端在启用 Kitty 键盘协议后支持）。Alt+Enter 和 Ctrl+J 在所有终端中均有效。

中断代理

如果代理响应时间过长，输入一条新消息并按 Enter——它会中断当前任务并切换到你的新指令。Ctrl+C 也有效。

6. 添加下一层

仅在基础聊天正常工作后进行。选择你需要的：

机器人或共享助手

hermes gateway setup    # 交互式平台配置

连接 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 或 Microsoft Teams。

自动化和工具

• hermes tools — 按平台调整工具访问权限
• hermes skills — 浏览和安装可重用工作流
• 定时任务 — 仅在机器人或 CLI 设置稳定后使用

沙箱终端

为了安全，在 Docker 容器或远程服务器上运行代理：

hermes config set terminal.backend docker    # Docker 隔离
hermes config set terminal.backend ssh       # 远程服务器

语音模式

## 从 Hermes 安装目录（curl 安装程序将其放置在
## Linux/macOS 的 ~/.hermes/hermes-agent 或 Windows 的 %LOCALAPPDATA%\hermes\hermes-agent）：
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"
## 包含免费的本地语音转文本 faster-whisper

然后在 CLI 中：/voice on。按 Ctrl+B 开始录音。请参阅语音模式。

技能

技能是按需提供的指令文档，教会 Hermes 如何执行特定任务——部署到 Kubernetes、打开 GitHub PR、微调模型、搜索 GIF。每个技能是一个 SKILL.md 文件，包含名称、描述和逐步操作流程。代理免费读取简短描述，仅当任务实际需要时才加载技能的完整内容，因此添加技能不会使每个请求变得臃肿。

Hermes 附带一个已安装在 ~/.hermes/skills/ 中的捆绑技能目录。你可以从技能中心添加更多技能，或自己编写。

从中心浏览和安装：

hermes skills browse                      # 列出所有可用技能
hermes skills search kubernetes           # 按关键字查找技能
hermes skills install openai/skills/k8s   # 安装一个（首先运行安全扫描）

安装参数是中心中的 source/path 标识符——openai/skills/k8s 表示来自 OpenAI 目录的 k8s 技能。hermes skills browse 会显示要使用的确切标识符。

使用技能——每个已安装的技能会自动成为斜杠命令：

/k8s deploy the staging manifest          # 使用技能并附带请求
/k8s                                       # 加载技能，让 Hermes 询问你需要什么

这在 CLI 和任何已连接的消息平台中均有效。你不必预先安装所有技能——当任务匹配时，代理会在正常对话中自动选择正确的捆绑技能。

请参阅技能系统了解如何编写自己的技能、外部技能目录以及完整的中心源列表。

MCP 服务器

## 添加到 ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

编辑器集成 (ACP)

ACP 支持随标准 [all] 扩展包一起提供，因此 curl 安装程序已包含它。只需运行：

hermes acp

（如果你没有安装 [all]，请先运行 cd ~/.hermes/hermes-agent && uv pip install -e ".[acp]"。）

请参阅ACP 编辑器集成。

常见故障模式

这些是最浪费时间的常见问题：

恢复工具包

当感觉不对劲时，按此顺序操作：

1. hermes doctor
2. hermes model
3. hermes setup
4. hermes sessions list
5. hermes --continue
6. hermes gateway status

这个序列能让你从“感觉坏了”快速回到已知状态。

快速参考

下一步

• CLI 指南 — 掌握终端界面
• 配置 — 自定义你的设置
• 消息网关 — 连接 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant、Teams 等
• 工具与工具集 — 探索可用能力
• AI 提供商 — 完整提供商列表和设置详情
• 技能系统 — 可重用工作流和知识
• 技巧与最佳实践 — 高级用户技巧