快速入门

本指南会带你完成安装 Hermes Agent、配置大模型提供商，并开始第一次对话。完成后，你还可以继续尝试终端工具、斜杠命令、会话恢复、消息网关、技能和 MCP 等能力。

前置条件

操作系统：Linux、macOS 或 WSL2 (Windows)。
模型：建议使用支持长上下文窗口的 LLM。
API Key：准备好你所选模型提供商的 API Key，或一个 OpenAI 兼容端点。

1. 安装

Linux / macOS / WSL2

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

然后重新加载 shell：

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

Windows

Windows 用户更推荐先安装 WSL2，然后在 Ubuntu/WSL 终端中运行 Linux 安装命令。WSL2 可以理解为 Windows 里的 Linux 终端环境，后续安装依赖、运行工具和调试项目会更接近 Hermes 的默认工作方式。

2. 配置

安装程序会引导你配置 LLM 提供商。后续也可以随时重新运行：

hermes model       # 选择大语言模型提供商和模型
hermes tools       # 配置启用哪些工具
hermes setup       # 一次性完成全部配置

hermes model 会引导你选择模型接入方式：OAuth 登录、API Key，或自定义 OpenAI 兼容端点。配置自定义端点时，按提示填写 Base URL、API Key、模型名和上下文窗口即可。你可以随时再次运行 hermes model 切换模型，不需要改代码。

3. 开始对话

hermes

启动后会看到包含模型、可用工具和技能的欢迎信息。直接输入消息并按 Enter：

❯ 你现在能帮我做什么？

Hermes 默认具备网络搜索、文件操作、终端命令等工具能力，适合直接处理真实任务。

4. 尝试核心功能

让 Hermes 使用终端

❯ 帮我看看磁盘空间占用情况，并列出最大的 5 个目录。

Hermes 会代表你执行终端命令，解释结果，并在需要时继续追问。

使用斜杠命令

在对话中输入 / 可以查看命令补全。常用命令：

命令	功能
`/help`	显示所有可用命令
`/tools`	列出可用工具
`/model`	交互式切换模型
`/skills`	查看或管理技能
`/save`	保存当前对话

多行输入

按 Alt+Enter 或 Ctrl+J 换行，适合粘贴代码、日志或较长的任务说明。

中断任务

如果 Hermes 正在执行一个耗时任务，你可以直接输入新消息并按 Enter，它会中断当前任务并切换到新指令。Ctrl+C 也可以中断。

恢复会话

退出时，Hermes 会打印恢复命令。之后可以运行：

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

5. 进一步探索

设置沙箱终端

为了隔离风险，可以让 Hermes 在 Docker 容器或远程服务器中执行命令：

hermes config set terminal.backend docker
hermes config set terminal.backend ssh

连接消息平台

通过消息网关，你可以从微信、飞书、QQ、Discord、WhatsApp、Signal、邮件或 Home Assistant 等平台与 Hermes 对话：

hermes gateway setup

启用语音模式

pip install "hermes-agent[voice]"
pip install faster-whisper    # 可选：本地语音转文字

然后在 Hermes CLI 中启用：

/voice on

按 Ctrl+B 开始录音，或使用 /voice tts 让 Hermes 朗读回复。

浏览并安装技能

hermes skills search kubernetes
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills install openai/skills/k8s

也可以在聊天中使用 /skills 管理技能。安装第三方技能前建议先阅读其内容，确认它会访问哪些工具和数据。

在编辑器中使用 Hermes

Hermes 可以作为 ACP 服务器运行，接入兼容 ACP 的编辑器：

pip install -e '.[acp]'
hermes acp

连接 MCP 服务器

把外部工具接入 Hermes，可以在 ~/.hermes/config.yaml 中添加 MCP 配置：

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

快速参考

命令	描述
`hermes`	开始聊天
`hermes model`	选择 LLM 提供商和模型
`hermes tools`	配置启用哪些工具
`hermes setup`	运行完整设置向导
`hermes doctor`	诊断安装和配置问题
`hermes update`	更新到最新版本
`hermes gateway`	启动或配置消息网关
`hermes --continue`	恢复上次会话

下一步

查看安装指南了解更多安装方式、Windows/WSL 注意事项和运行时后端。
阅读功能介绍了解学习闭环、技能系统、MCP、消息网关和定时自动化。
访问 agentskills.io 探索社区技能。