知识引擎/Hermes 知识引擎/快速开始 (Quickstart)

返回分馆所属主题：快速入门更新于 2026年4月16日官方来源

本指南将带你完成 Hermes Agent 的安装、Provider 配置，并进行第一次对话。完成后，你将了解核心功能以及如何进一步探索。运行一行安装命令： Android / Termux 如果你在手机上安装，请参阅专门的 Termux 指南，了解经过测试的手动安装路径、支持的扩展组件以及当前 Android 相关

快速开始 (Quickstart)

> 📖 本文档翻译自 Hermes Agent 官方文档 > 最后更新：2026-04-16

本指南将带你完成 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

Android / Termux

如果你在手机上安装，请参阅专门的 Termux 指南，了解经过测试的手动安装路径、支持的扩展组件以及当前 Android 相关的限制。

Windows 用户

请先安装 WSL2，然后在 WSL2 终端中运行上面的命令。

安装完成后，重新加载你的 Shell（终端）：

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

2. 配置 Provider

安装程序会自动配置你的 LLM Provider（提供商）。之后如需更改，可使用以下命令：

hermes model       # 选择你的 LLM Provider 和模型
hermes tools       # 配置启用的工具
hermes setup       # 或一次性配置所有内容

hermes model 会引导你选择一个推理 Provider：

Provider	说明	配置方式
Nous Portal	订阅制，零配置	通过 `hermes model` 进行 OAuth 登录
OpenAI Codex	ChatGPT OAuth，使用 Codex 模型	通过 `hermes model` 进行设备码认证
Anthropic	直接使用 Claude 模型（Pro/Max 或 API Key）	通过 `hermes model` 使用 Claude Code 认证，或使用 Anthropic API Key
OpenRouter	多 Provider 路由，支持多种模型	输入你的 API Key
Z.AI	GLM / 智谱托管模型	设置 `GLM_API_KEY` / `ZAI_API_KEY`
Kimi / Moonshot	Moonshot 托管的编程和聊天模型	设置 `KIMI_API_KEY`
Kimi / Moonshot China	中国区 Moonshot 端点	设置 `KIMI_CN_API_KEY`
Arcee AI	Trinity 模型	设置 `ARCEEAI_API_KEY`
MiniMax	国际版 MiniMax 端点	设置 `MINIMAX_API_KEY`
MiniMax China	中国区 MiniMax 端点	设置 `MINIMAX_CN_API_KEY`
Alibaba Cloud	通过 DashScope 使用 Qwen 模型	设置 `DASHSCOPE_API_KEY`
Hugging Face	通过统一路由访问 20+ 开源模型（Qwen、DeepSeek、Kimi 等）	设置 `HF_TOKEN`
Kilo Code	KiloCode 托管模型	设置 `KILOCODE_API_KEY`
OpenCode Zen	按量付费访问精选模型	设置 `OPENCODE_ZEN_API_KEY`
OpenCode Go	$10/月订阅使用开源模型	设置 `OPENCODE_GO_API_KEY`
DeepSeek	直接 DeepSeek API 访问	设置 `DEEPSEEK_API_KEY`
GitHub Copilot	GitHub Copilot 订阅（GPT-5.x、Claude、Gemini 等）	通过 `hermes model` 进行 OAuth，或设置 `COPILOT_GITHUB_TOKEN` / `GH_TOKEN`
GitHub Copilot ACP	Copilot ACP Agent 后端（启动本地 `copilot` CLI）	通过 `hermes model`（需要 `copilot` CLI + `copilot login`）
Vercel AI Gateway	Vercel AI Gateway 路由	设置 `AI_GATEWAY_API_KEY`
Custom Endpoint	VLLM、SGLang、Ollama 或任何 OpenAI 兼容 API	设置 Base URL + API Key

最低上下文长度要求：64K Token

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

> 💡 提示： 你可以随时通过 hermes model 切换 Provider——无需修改代码，无绑定。配置自定义端点时，Hermes 会提示你输入上下文窗口大小，并在可能时自动检测。详见 Context Length Detection。

3. 开始对话

hermes

就这样！你会看到一个欢迎界面，显示当前模型、可用工具和技能。输入消息并按回车即可。

❯ What can you help me with?

Agent 内置了 Web 搜索、文件操作、终端命令等工具——全部开箱即用。

4. 体验核心功能

让它使用终端

❯ What's my disk usage? Show the top 5 largest directories.

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

使用斜杠命令

输入 / 可以看到所有命令的自动补全列表：

命令	功能
`/help`	显示所有可用命令
`/tools`	列出可用工具
`/model`	交互式切换模型
`/personality pirate`	尝试一个有趣的人格
`/save`	保存对话

多行输入

按 Alt+Enter 或 Ctrl+J 添加新行。适合粘贴代码或编写详细的 Prompt（提示词）。

中断 Agent

如果 Agent 处理时间太长，直接输入新消息并按回车——它会中断当前任务并切换到你的新指令。Ctrl+C 也可以。

恢复会话

退出时，Hermes 会打印恢复命令：

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

5. 进一步探索

以下是一些接下来可以尝试的内容：

设置沙盒终端

为了安全，可以在 Docker 容器或远程服务器上运行 Agent：

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]"
# 包含 faster-whisper，可免费进行本地语音转文字

然后启动 Hermes，在 CLI 中启用语音：

/voice on

按 Ctrl+B 开始录音，或使用 /voice tts 让 Hermes 朗读回复。完整设置请参阅 Voice Mode，覆盖 CLI、Telegram、Discord 和 Discord 语音频道。

设置定时任务

❯ Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

Agent 会设置一个 Cron 任务，通过 Gateway 自动运行。

浏览和安装技能

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 配合文档/站点 URL，从 /.well-known/skills/index.json 发现技能
仅在审查第三方 Skill 后才使用 --force。它可以覆盖非危险策略阻止，但不能覆盖 dangerous 扫描结果

或者在聊天中使用 /skills 斜杠命令。

通过 ACP 在编辑器中使用 Hermes

Hermes 还可以作为 ACP（Agent Communication Protocol）服务器运行，支持 VS Code、Zed 和 JetBrains 等 ACP 兼容编辑器：

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

详见 ACP Editor Integration。

尝试 MCP 服务器

通过 Model Context Protocol（模型上下文协议）连接外部工具：

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

快速参考

命令	说明
`hermes`	开始对话
`hermes model`	选择你的 LLM Provider 和模型
`hermes tools`	配置各平台启用的工具
`hermes setup`	完整设置向导（一次性配置所有内容）
`hermes doctor`	诊断问题
`hermes update`	更新到最新版本
`hermes gateway`	启动消息网关
`hermes --continue`	恢复上次会话

下一步

CLI Guide — 掌握终端界面
Configuration — 自定义你的设置
Messaging Gateway — 连接 Telegram、Discord、Slack、WhatsApp、Signal、Email 或 Home Assistant
Tools & Toolsets — 探索可用能力

Continue Exploring

继续探索

这不是课程式的上一篇下一篇，而是从当前节点向外继续漫游。

快速入门

Android 和 Termux (Android / Termux)

这是通过 Termux 在 Android 手机上直接运行 Hermes Agent 的经过测试的路径。它为你提供手机上可用的本地 CLI，以及目前已知能在 Android 上顺利安装的核心扩展组件。经过测试的 Termux 打包安装以下内容： - Hermes CLI - Cron（定时任务）支持

集成

AI 提供商

This page covers setting up inference providers for Hermes Agent — from cloud APIs like OpenRouter and Anthropic, to self-hosted endpoints like Ollama and vLLM,

核心功能

语音模式 (Voice Mode)

Hermes Agent supports full voice interaction across CLI and messaging platforms. Talk to the agent using your microphone, hear spoken replies, and have live voi

核心功能

ACP 编辑器集成 (ACP Editor Integration)

Hermes Agent 可以作为 ACP 服务器运行，让 ACP 兼容的编辑器通过 stdio 与 Hermes 通信，并渲染： - 聊天消息 - 工具活动 - 文件差异 - 终端命令 - 审批提示 - 流式思考 / 响应片段当你希望 Hermes 像编辑器原生的编程 Agent 一样工作，而不是独立的 CLI 或

使用指南

命令行界面 (CLI Interface)

Hermes Agent 的 CLI 是一个完整的终端用户界面（TUI）——不是 Web UI。它具有多行编辑、斜杠命令自动补全、对话历史、中断重定向和流式工具输出等功能。为生活在终端中的用户而构建。 Hermes CLI 布局的风格化预览，显示横幅、对话区域和固定输入提示。 Hermes CLI 横幅、对话流和固定输

使用指南

配置 (Configuration)

All settings are stored in the /.hermes/ directory for easy access. :::tip ::: Settings are resolved in this order (highest priority first):

Getting Started

快速入门

先建立对 Hermes 的整体感，再完成安装、首轮对话和你的第一条学习路径。

7 篇文档6 个节点

当前节点

快速开始 (Quickstart)

返回分馆回到知识引擎

同主题继续探索

安装指南 (Installation)

通过一行安装命令，不到两分钟即可让 Hermes Agent 运行起来；或者按照手动步骤获得完全控制。 Hermes 现在也提供了 Termux 感知的安装路径：安装程序会自动检测 Termux 并切换到经过测试的 Android 安装流程： - 使用 Termux 的 pkg 安装系统依赖（git、python、n

Android 和 Termux (Android / Termux)

Nix 和 NixOS 安装 (Nix Setup)

Hermes Agent 提供了 Nix Flake（Nix 包管理器的声明式构建定义），包含三个层级的集成：与标准安装的区别 curl bash 安装程序自行管理 Python、Node 和依赖。Nix Flake 替代了所有这些——每个 Python 依赖都是由 uv2nix 构建的 Nix Derivation

更新与卸载 (Updating & Uninstalling)

Update to the latest version with a single command: This pulls the latest code, updates dependencies, and prompts you to configure any new options that were add

学习路线 (Learning Path)

Hermes Agent can do a lot — CLI assistant, Telegram/Discord bot, task automation, RL training, and more. This page helps you figure out where to start and what

快速开始 (Quickstart)

1. 安装 Hermes Agent

2. 配置 Provider

3. 开始对话

4. 体验核心功能

让它使用终端

使用斜杠命令

多行输入

中断 Agent

恢复会话

5. 进一步探索

设置沙盒终端

连接消息平台

添加语音模式

设置定时任务

浏览和安装技能

通过 ACP 在编辑器中使用 Hermes

尝试 MCP 服务器

快速参考

下一步

继续探索

Android 和 Termux (Android / Termux)

AI 提供商

语音模式 (Voice Mode)

ACP 编辑器集成 (ACP Editor Integration)

命令行界面 (CLI Interface)

配置 (Configuration)

快速入门

知识引擎 AI 问答