快速开始

本指南将带你完成 Hermes Agent 的安装、provider 设置，以及第一次对话。完成后，你将了解它的关键功能，并知道如何进一步探索。

1. 安装 Hermes Agent

运行单行安装命令：

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

:::tip Android / Termux 如果你是在手机上安装，请查看专门的 Termux guide，了解经过验证的手动安装路径、支持的 extras，以及当前 Android 平台的特定限制。 :::

:::tip Windows 用户 请先安装 WSL2，然后在 WSL2 终端中运行上述命令。 :::

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

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

2. 设置 Provider

安装器会自动配置你的 LLM provider。如果你之后想修改它，可以使用以下命令之一：

hermes model       # 选择你的 LLM provider 和 model
hermes tools       # 配置启用哪些工具
hermes setup       # 或一次性完成全部配置

hermes model 会引导你选择 inference provider：

3. 开始聊天

hermes

就是这么简单！你会看到一个欢迎横幅，其中显示当前 model、可用工具以及 skills。输入一条消息并按 Enter 即可。

❯ 你能帮我做什么？

这个 agent 开箱即用，已具备 web search、文件操作、终端命令等多种工具能力。

4. 体验关键功能

让它使用终端

❯ 我的磁盘使用情况如何？请显示最大的 5 个目录。

agent 会代表你运行终端命令，并展示结果。

使用斜杠命令

输入 / 可看到所有命令的自动补全下拉菜单：

多行输入

按 Alt+Enter 或 Ctrl+J 可插入新的一行。非常适合粘贴代码或编写详细 prompt。

中断 agent

如果 agent 处理得太久，你只需输入一条新消息并按 Enter——它会中断当前任务，并切换到你的新指令。Ctrl+C 也可以。

恢复会话

退出时，hermes 会打印一条恢复命令：

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

5. 继续探索

下面是一些下一步可以尝试的内容：

设置沙箱终端

为了安全起见，可以让 agent 运行在 Docker 容器中，或远程服务器上：

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

连接消息平台

通过 Telegram、Discord、Slack、WhatsApp、Signal、Email 或 Home Assistant，你可以在手机或其他界面上与 Hermes 对话：

hermes gateway setup    # 交互式平台配置

添加语音模式

想在 CLI 中使用麦克风输入，或在消息平台中启用语音回复？

pip install "hermes-agent[voice]"
# 可选但推荐，用于免费的本地 speech-to-text
pip install faster-whisper

然后启动 Hermes，并在 CLI 中启用它：

/voice on

按 Ctrl+B 开始录音，或者使用 /voice tts 让 Hermes 朗读它的回复。完整的 CLI、Telegram、Discord 和 Discord voice channels 配置方式，请参阅 Voice Mode。

安排自动化任务

❯ 每天早上 9 点，检查 Hacker News 上的 AI 新闻，并通过 Telegram 发我一份摘要。

agent 会通过 gateway 自动设置并运行 cron job。

浏览和安装 skills

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
hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force

提示：

• 使用 --source skills-sh 可搜索公开的 skills.sh 目录。
• 使用 --source well-known 配合 docs / site URL，可从 /.well-known/skills/index.json 发现 skills。
• 只有在审查过第三方 skill 之后才使用 --force。它可以覆盖非危险性的策略拦截，但不能覆盖 dangerous 扫描结论。

你也可以在聊天中使用 /skills 斜杠命令。

通过 ACP 在编辑器中使用 Hermes

Hermes 也可以作为 ACP server 运行，用于兼容 ACP 的编辑器，例如 VS Code、Zed 和 JetBrains：

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

配置详情请参阅 ACP Editor Integration。

试用 MCP servers

通过 Model Context Protocol 连接外部工具：

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

快速参考