快速入门

本指南将引导您完成安装 Hermes Agent、设置提供商并进行第一次对话。最后，您将了解关键功能以及如何进一步探索。

1. 安装 Hermes Agent

运行一键安装程序：

bash

# 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：

bash

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

2. 设置提供商

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

bash

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 密钥）	使用 Claude Code 认证通过 `hermes model`，或使用 Anthropic API 密钥
OpenRouter	跨多个模型的多提供商路由	输入您的 API 密钥
Z.AI	GLM / Zhipu 托管模型	设置 `GLM_API_KEY` / `ZAI_API_KEY`
Kimi / Moonshot	Moonshot 托管的编码和聊天模型	设置 `KIMI_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 智能体后端（生成本地 `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	设置基础 URL + API 密钥

:::caution 最小上下文：64K 令牌 Hermes Agent 需要至少 64,000 令牌 上下文的模型。上下文窗口较小的模型无法为多步骤工具调用工作流维护足够的工作内存，将在启动时被拒绝。大多数托管模型（Claude、GPT、Gemini、Qwen、DeepSeek）很容易满足此要求。如果您运行本地模型，请将其上下文大小设置为至少 64K（例如 llama.cpp 使用 --ctx-size 65536 或 Ollama 使用 -c 65536）。 :::

提示

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

3. 开始聊天

bash

hermes

就这样！您将看到一个欢迎横幅，显示您的模型、可用工具和技能。输入消息并按回车键。

❯ 你能帮我做什么？

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

4. 尝试关键功能

让它使用终端

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

智能体将代表您运行终端命令并显示结果。

使用斜杠命令

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

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

多行输入

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

中断智能体

如果智能体耗时太长，只需输入新消息并按回车键 —— 它会中断当前任务并切换到您的新指令。Ctrl+C 也有效。

恢复会话

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

bash

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

5. 进一步探索

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

设置沙盒终端

为了安全起见，在 Docker 容器或远程服务器上运行智能体：

bash

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

连接消息平台

通过 Telegram、Discord、Slack、WhatsApp、Signal、Email 或 Home Assistant 从手机或其他界面与 Hermes 聊天：

bash

hermes gateway setup    # 交互式平台配置

添加语音模式

想要在 CLI 中使用麦克风输入或在消息中使用语音回复？

bash

pip install "hermes-agent[voice]"

# 可选但推荐用于免费本地语音转文本
pip install faster-whisper

然后在 Hermes 中启用：

text

/voice on

按 Ctrl+B 录音，或使用 /voice tts 让 Hermes 语音回复。有关 CLI、Telegram、Discord 和 Discord 语音频道的完整设置，请参阅语音模式。

安排自动任务

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

智能体将设置一个 cron 作业，通过网关自动运行。

浏览和安装技能

bash

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 斜杠命令。

通过 ACP 在编辑器中使用 Hermes

Hermes 还可以作为 VS Code、Zed 和 JetBrains 等 ACP 兼容编辑器的 ACP 服务器运行：

bash

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

有关设置详情，请参阅 ACP 编辑器集成。

尝试 MCP 服务器

通过模型上下文协议连接外部工具：

yaml

# 添加到 ~/.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 服务器 ​

快速参考 ​

下一步 ​

快速入门

1. 安装 Hermes Agent

2. 设置提供商

3. 开始聊天

4. 尝试关键功能

让它使用终端

使用斜杠命令

多行输入

中断智能体

恢复会话

5. 进一步探索

设置沙盒终端

连接消息平台

添加语音模式

安排自动任务

浏览和安装技能

通过 ACP 在编辑器中使用 Hermes

尝试 MCP 服务器

快速参考

下一步