快速入门

本指南会带你完成 Hermes Agent 的安装、提供商配置和首次对话。走完这一页后，你就能理解它最核心的工作方式，也知道下一步该往哪里深入。

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   # or source ~/.zshrc

2. 设置提供者

安装脚本会自动引导你配置 LLM 提供商。后续如果想修改，可使用以下命令：

hermes model       # Choose your LLM provider and model
hermes tools       # Configure which tools are enabled
hermes setup       # Or configure everything at once

hermes model 将引导你选择推理提供者：

提供商	说明	如何设置
Nous Portal	订阅制，零配置	通过 `hermes model` 进行 OAuth 登录
OpenAI Codex	ChatGPT OAuth，使用 Codex 模型	通过 `hermes model` 进行设备码认证
Anthropic	直接调用 Claude 模型（Pro/Max 或 API 密钥）	使用 `hermes model` 进行 Claude 代码认证，或输入 Anthropic API 密钥
OpenRouter	跨多个模型的统一提供商路由	输入你的 API 密钥
Z.AI	GLM / Zhipu 托管模型	设置 `GLM_API_KEY` / `ZAI_API_KEY`
Kimi / Moonshot	Moonshot 托管的编程与聊天模型	设置 `KIMI_API_KEY`
Kimi / Moonshot 中国区	中国区域的 Moonshot 服务端点	设置 `KIMI_CN_API_KEY`
Arcee AI	Trinity 模型	设置 `ARCEEAI_API_KEY`
MiniMax	国际版 MiniMax 服务端点	设置 `MINIMAX_API_KEY`
MiniMax 中国区	中国区域的 MiniMax 服务端点	设置 `MINIMAX_CN_API_KEY`
阿里云	通过 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 代理后端（启动本地 `copilot` CLI）	使用 `hermes model`（需先安装 `copilot` CLI + `copilot login`）
Vercel AI Gateway	Vercel AI Gateway 路由	设置 `AI_GATEWAY_API_KEY`
自定义端点	VLLM、SGLang、Ollama 或任何 OpenAI 兼容 API	设置基础 URL + API 密钥

最小上下文长度：64K tokens

Hermes Agent 要求模型至少具备 64,000 个 token 的上下文容量。上下文窗口较小的模型无法维持足够的工作记忆以支持多步骤工具调用流程，将在启动时被拒绝。大多数托管模型（Claude、GPT、Gemini、Qwen、DeepSeek）均轻松满足此要求。若运行本地模型，请将其上下文大小设置为至少 64K（例如，llama.cpp 中使用 --ctx-size 65536，或 Ollama 中使用 -c 65536）。

tip

你可以随时通过 hermes model 切换提供商，无需改代码，也不会被绑定在某一家服务上。配置自定义端点时，Hermes 还会提示你输入上下文窗口大小，并尽量自动检测。详情请参阅上下文长度检测。

3. 开始对话

hermes

启动后，你会看到一个欢迎横幅，其中会显示当前模型、可用工具和技能。输入消息并按回车，就可以开始对话。

❯ What can you help me with?

Hermes 已内置网络搜索、文件操作、终端命令等工具能力，开箱即可使用。

4. 体验核心功能

让它使用终端

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

代理将代表你执行终端命令，并显示结果。

使用斜杠命令

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

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

多行输入

按 Alt+Enter 或 Ctrl+J 可添加新行。非常适合粘贴代码或撰写详细提示。

中断代理

如果代理响应太慢，只要直接输入一条新消息并回车，它就会中断当前任务并转去执行你的新指令。Ctrl+C 也可以达到同样效果。

恢复会话

退出时，hermes 会输出一个恢复命令：

hermes --continue    # Resume the most recent session
hermes -c            # Short form

5. 进一步探索

以下是一些你可以尝试的进阶操作：

设置沙盒化终端

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

hermes config set terminal.backend docker    # Docker isolation
hermes config set terminal.backend ssh       # Remote server

连接即时通讯平台

通过 Telegram、Discord、Slack、WhatsApp、Signal、邮件或 Home Assistant 从手机或其他设备与 Hermes 对话：

hermes gateway setup    # Interactive platform configuration

添加语音模式

希望在 CLI 中使用麦克风输入，或在消息应用中收听语音回复？

pip install "hermes-agent[voice]"
# Includes faster-whisper for free local speech-to-text

然后启动 Hermes 并在 CLI 内启用语音模式：

/voice on

按 Ctrl+B 开始录音，或使用 /voice tts 让 Hermes 朗读其回复。详见语音模式，了解 CLI、Telegram、Discord 及 Discord 语音频道中的完整配置。

设置自动化任务

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

代理会通过网关为你自动建立一个 cron 任务，并按计划执行。

浏览并安装技能

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 发现技能。
使用 --force 仅在审查第三方技能后进行。它可以绕过非危险策略限制，但不能覆盖 dangerous 扫描的结论。

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

在编辑器中使用 Hermes（通过 ACP）

Hermes 还可作为 ACP 服务器，集成至 VS Code、Zed、JetBrains 等兼容 ACP 的编辑器：

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

详见 ACP 编辑器集成获取详细设置说明。

尝试 MCP 服务器

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

# Add to ~/.hermes/config.yaml
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`	恢复上次会话

下一步

CLI 指南 — 熟悉终端界面与日常使用方式
配置 — 自定义你的设置
消息网关 — 连接 Telegram、Discord、Slack、WhatsApp、Signal、邮件或 Home Assistant
工具与工具集 — 探索可用功能

1. 安装 Hermes Agent​

2. 设置提供者​

3. 开始对话​

4. 体验核心功能​

让它使用终端​

使用斜杠命令​

多行输入​

中断代理​

恢复会话​

5. 进一步探索​

设置沙盒化终端​

连接即时通讯平台​

添加语音模式​

设置自动化任务​

浏览并安装技能​

在编辑器中使用 Hermes（通过 ACP）​

尝试 MCP 服务器​

快速参考​

下一步​