快速入门

本指南将引导你完成安装 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   # 或者 source ~/.zshrc

2. 设置提供商

安装程序自动配置你的 LLM 提供商。以后要更改，请使用以下命令之一：

hermes model       # 选择你的 LLM 提供商和模型
hermes tools       # 配置启用哪些工具
hermes setup       # 或者一次性配置一切

hermes model 会引导你选择推理提供商：

提供商	是什么	如何设置
Nous Portal	基于订阅，零配置	通过 `hermes model` 进行 OAuth 登录
OpenAI Codex	ChatGPT OAuth，使用 Codex 模型	通过 `hermes model` 进行设备代码认证
Anthropic	直接使用 Claude 模型（Pro/Max 或 API 密钥）	通过 `hermes model` 进行 Claude Code 认证，或使用 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 tokens 上下文的模型。上下文窗口较小的模型无法为多步骤工具调用工作流维持足够的工作内存，将被拒绝启动。大多数托管模型（Claude、GPT、Gemini、Qwen、DeepSeek）很容易满足此要求。如果你在运行本地模型，将其上下文大小设置为至少 64K（例如，对于 llama.cpp 使用 --ctx-size 65536，对于 Ollama 使用 -c 65536）。

提示

你可以随时通过 hermes model 切换提供商——无需更改代码，无锁定。配置自定义端点时，Hermes 会提示输入上下文窗口大小，并在可能时自动检测。参阅上下文长度检测了解更多详情。

3. 开始聊天

hermes

就这样！你会看到欢迎横幅，显示你的模型、可用的工具和技能。输入一条消息并按 Enter。

❯ What can you help me with?

代理可以访问用于网络搜索、文件操作、终端命令等工具——开箱即用。

4. 尝试关键功能

让它使用终端

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

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

使用斜杠命令

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

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

多行输入

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

中断代理

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

恢复会话

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

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

5. 进一步探索

以下是接下来可以尝试的事项：

设置沙盒终端

为了安全起见，在 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]"
# 包括用于免费本地语音转文字的 faster-whisper

然后启动 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 配合 docs/site URL 来发现 /.well-known/skills/index.json 中的技能。
只有在查看第三方技能后才使用 --force。它可以覆盖非危险策略阻止，但不能覆盖 dangerous 扫描裁决。

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

通过 ACP 在编辑器中使用 Hermes

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

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

请参阅 ACP 编辑器集成了解设置详情。

尝试 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 提供商和模型
`hermes tools`	配置每个平台启用哪些工具
`hermes setup`	完整设置向导（一次配置一切）
`hermes doctor`	诊断问题
`hermes update`	更新到最新版本
`hermes gateway`	启动消息网关
`hermes --continue`	恢复上一个会话

下一步

CLI 指南——掌握终端界面
配置——自定义你的设置
消息网关——连接 Telegram、Discord、Slack、WhatsApp、Signal、Email 或 Home Assistant
工具和工具集——探索可用功能

1. 安装 Hermes Agent​

2. 设置提供商​

3. 开始聊天​

4. 尝试关键功能​

让它使用终端​

使用斜杠命令​

多行输入​

中断代理​

恢复会话​

5. 进一步探索​

设置沙盒终端​

连接消息平台​

添加语音模式​

安排自动化任务​

浏览和安装技能​

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

尝试 MCP 服务器​

快速参考​

下一步​