跳到主要内容

安装后的配置教程

这是一篇给中文用户准备的 Hermes Agent 配置向导（Setup Wizard）胎教级别教程。

适用环境

本教程以 Ubuntu 系统为例，同样适用于 Windows 原生 PowerShell、Windows WSL2 及 Linux 服务器上的安装场景；如果你使用 Windows 原生安装，直接在 PowerShell 中运行同名 hermes 命令即可。

开始之前
  • 前置条件：你已经通过中文社区的安装指令完成了 Hermes Agent 的安装。如果还没有，请先看 安装教程
  • 预计耗时：约 10 分钟
  • 你需要准备：一个大模型提供商的账号（本教程以 DeepSeek 开放平台 的 deepseek-v4-flash 模型为例，价格低廉、性能优秀）；一个 飞书 账号（用于配置消息平台）

整个配置分为三大步：选择模型提供商 → 选择终端后端 → 配置消息平台（可选）。下面一步步来。

第一步：进入配置向导​

安装完成界面

如果你已经看到了类似上图的界面，说明 Hermes Agent 已经安装完成了。

在这个界面输入 1 并按回车，进入快速设置模式。

第二步：选择模型提供商​

模型提供商选择

接下来会出现模型提供商选择界面。模型提供商就是为 Hermes 提供 AI 大脑的服务商，你需要选一个来驱动 Hermes。

不知道选哪个？

国内用户推荐选 16. DeepSeek——注册简单、价格便宜、国内直连不需要翻墙。本教程以 DeepSeek 为例。

使用方向键 ↑↓ 移动光标到你想要的提供商上，按回车确认。

完整提供商列表及中文对照（点击展开）
原文中文翻译
1. Nous Portal (Nous Research subscription)1. Nous Portal（Nous Research 官方订阅服务）
2. OpenRouter (100+ models, pay-per-use)2. OpenRouter 中转站（100+ 模型，按量付费）
3. NovitaAI (AI-native cloud: Model API, Agent Sandbox, GPU Cloud)3. NovitaAI（AI 原生云：模型 API、Agent 沙箱、GPU 云）
4. LM Studio (local desktop app with built-in model server)4. LM Studio（本地桌面应用，内置模型服务器）
5. Anthropic (Claude models — API key or Claude Code)5. Anthropic（Claude 模型 —— 使用 API 密钥或 Claude Code）
6. OpenAI Codex6. OpenAI Codex
7. Qwen Cloud / DashScope Coding (Qwen + multi-provider)7. 通义千问云 / DashScope Coding（Qwen + 多提供商能力）
8. Xiaomi MiMo (MiMo-V2.5 and V2 models — pro, omni, flash)8. 小米 MiMo（MiMo-V2.5 及 V2 系列模型 —— pro、omni、flash）
9. Tencent TokenHub (Hy3 Preview — direct API via tokenhub.tencentmaas.com)9. 腾讯 TokenHub（混元 Hy3 预览版 —— 通过 tokenhub.tencentmaas.com 直连）
10. NVIDIA NIM (Nemotron models — build.nvidia.com or local NIM)10. NVIDIA NIM（Nemotron 模型 —— build.nvidia.com 或本地 NIM）
11. GitHub Copilot (uses GITHUB_TOKEN or gh auth token)11. GitHub Copilot（使用 GITHUB_TOKEN 或 gh 登录 token）
12. GitHub Copilot ACP (spawns copilot --acp --stdio)12. GitHub Copilot ACP（启动 copilot --acp --stdio）
13. Hugging Face Inference Providers (20+ open models)13. Hugging Face Inference Providers（20+ 开源模型）
14. Google AI Studio (Gemini models — native Gemini API)14. Google AI Studio（Gemini 模型 —— 原生 Gemini API）
15. Google Gemini via OAuth + Code Assist (free tier supported; no API key needed)15. Google Gemini OAuth + Code Assist（支持免费额度，无需 API 密钥）
16. DeepSeek (DeepSeek-V3, R1, coder — direct API)16. DeepSeek（DeepSeek-V3、R1、Coder —— 官方直连 API）
17. xAI (Grok models — direct API)17. xAI（Grok 模型 —— 官方直连 API）
18. Z.AI / GLM (Zhipu AI direct API)18. Z.AI / GLM（智谱 AI 官方直连 API）
19. Kimi Coding Plan (api.kimi.com) & Moonshot API19. Kimi Coding Plan（api.kimi.com）& Moonshot API
20. Kimi / Moonshot China (Moonshot CN direct API)20. Kimi / Moonshot China（Moonshot 中国区官方直连 API）
21. StepFun Step Plan (agent/coding models via Step Plan API)21. 阶跃星辰 StepFun Step Plan（通过 Step Plan API 使用 agent/coding 模型）
22. MiniMax (global direct API)22. MiniMax（国际版官方直连 API）
23. MiniMax via OAuth browser login (Coding Plan, minimax.io)23. MiniMax OAuth 浏览器登录（Coding Plan，minimax.io）
24. MiniMax China (domestic direct API)24. MiniMax China（国内版官方直连 API）
25. Ollama Cloud (cloud-hosted open models — ollama.com)25. Ollama Cloud（云托管开源模型 —— ollama.com）
26. Arcee AI (Trinity models — direct API)26. Arcee AI（Trinity 系列模型 —— 官方直连 API）
27. GMI Cloud (multi-model direct API)27. GMI Cloud（多模型直连 API）
28. Kilo Code (Kilo Gateway API)28. Kilo Code（Kilo Gateway API）
29. OpenCode Zen (35+ curated models, pay-as-you-go)29. OpenCode Zen（35+ 精选模型，按量付费）
30. OpenCode Go (open models, $10/month subscription)30. OpenCode Go（开放模型，10 美元/月订阅）
31. AWS Bedrock (Claude, Nova, Llama, DeepSeek — IAM or API key)31. AWS Bedrock（Claude、Nova、Llama、DeepSeek —— IAM 或 API 密钥）
32. Azure Foundry (OpenAI-style or Anthropic-style endpoint — your Azure AI deployment)32. Azure Foundry（OpenAI 风格或 Anthropic 风格端点 —— 你的 Azure AI 部署）
33. Vercel AI Gateway33. Vercel AI Gateway
34. Qwen OAuth (reuses local Qwen CLI login)34. Qwen OAuth（复用本地 Qwen CLI 登录状态）
35. Alibaba Cloud Coding Plan — dedicated coding tier35. 阿里云 Coding Plan —— 专属 coding 套餐
36. custom (direct API)36. 自定义（直连 API）
37. Custom endpoint (enter URL manually)37. 自定义端点（手动输入 URL）
38. Configure auxiliary models...38. 配置辅助模型…
39. Leave unchanged39. 保持不变

输入 API 密钥​

选择提供商后，会提示你输入 API Key（API 密钥）。

什么是 API 密钥？ 可以理解为一把"钥匙"，让 Hermes 能以你的身份调用大模型服务。每个提供商都可以在其后台免费生成。

输入 API Key

这时需要前往模型提供商的后台生成密钥。以 DeepSeek 为例，打开 https://platform.deepseek.com/api_keys ，创建一个 API 密钥并复制：

DeepSeek 后台创建 API 密钥

然后回到终端窗口中粘贴（可右键选择粘贴）并回车。

粘贴后看不到内容？

这是正常的！为了保护密钥安全，终端不会显示你粘贴的内容。直接按回车即可。

粘贴 API Key

选择具体模型​

稍等片刻，Hermes 会向 DeepSeek 发送请求获取可用的模型列表。

选择你想用的模型。这里我选 deepseek-v4-flash（社区比较推荐的模型，智力在线且便宜），输入对应编号并回车：

选择模型

第三步：选择终端后端​

终端后端选择

接下来是 Terminal Backend（终端后端） 选择。简单来说就是：Hermes 在哪里执行命令和代码？

选项说明
Local（默认）直接在你的电脑上执行，最简单，推荐新手选这个
Docker在 Docker 容器中运行，与系统隔离，需要先安装 Docker
Modal使用 Modal 云平台运行，按量计费
SSH通过 SSH 连接到远程服务器执行
Daytona使用 Daytona 持久化云开发环境
Vercel SandboxVercel 提供的云端微虚拟机
Singularity/Apptainer面向超算/HPC 集群的容器方案，适合学术科研场景
Keep current保持当前设置不变

大多数用户直接选 Local（默认）即可，按回车跳过。

第四步：配置消息平台（可选）​

可以跳过

如果你只想先在终端里体验 Hermes，可以选择 Skip 跳过这一步。之后随时可以通过 hermes setup 重新配置。

消息平台选择

消息平台指的是把 Hermes 接入飞书、微信、Discord 等聊天工具，让你可以在手机上跟 Hermes 对话。目前社区最推荐的是飞书，下面以飞书为例。

4.1 选择飞书​

使用方向键选中 Feishu / Lark 并回车：

选择飞书

4.2 选择飞书应用创建方式​

这个界面问你用哪种方式创建飞书应用，选第一个（自动创建）回车即可：

飞书创建方式

4.3 在浏览器中创建飞书应用​

终端会显示一个 open.feishu.cn 开头的链接，把它复制到浏览器中打开：

复制飞书链接

在打开的页面中，给你的飞书应用起个名字（随便取，比如"Hermes助手"），然后点击立即创建：

设定应用名称

创建完成

4.4 回到终端完成配置​

回到终端，接下来会有几个确认界面。

这一步是确认应用已经创建好了，直接回车：

确认应用创建

这一步是确认权限配置，同样回车：

确认权限配置

Hermes 会自动为飞书应用配置所需的权限：

权限配置中

看到 DM pairing enabled（私聊配对已开启）后，说明飞书应用配置成功了。继续回车：

DM pairing 完成

第五步：启动 Hermes​

配置完成！现在关掉当前终端窗口，打开一个新的终端，输入以下命令：

hermes

你会看到 Hermes 的聊天界面，可以直接在这里跟它对话了：

Hermes 聊天界面

第六步：绑定飞书机器人（如果上一步配置了飞书）​

如果你在第四步配置了飞书，还需要一个"配对"步骤，让飞书机器人和你的 Hermes 绑定在一起。

6.1 在飞书中给机器人发一条消息​

打开飞书，找到你刚创建的机器人（就是第 4.3 步起的那个名字），随便发一句话给它：

给飞书机器人发消息

6.2 在终端中执行配对命令​

机器人收到消息后，Hermes 终端会显示一条 hermes pairing approve 开头的命令。打开一个新终端，把这条命令粘贴进去并回车：

执行配对命令

看到类似下图的确认信息，说明配对成功：

配对成功

6.3 验证​

现在回到飞书，给机器人发条消息试试，它应该能正常回复了：

飞书机器人正常工作

配置完成​

恭喜！Hermes Agent 已经配置完成并可以正常使用了。你可以：

  • 在终端中对话：打开终端输入 hermes 开始聊天
  • 在飞书中对话：直接给机器人发消息
  • 重新配置：随时运行 hermes setup 修改设置

如果遇到问题，欢迎来社区提问：