Hermes Agent 基础配置指南：从零搭建你的 AI 管家

青萍叙事2026-05-12

写在前面

Hermes Agent 是一个开源的 AI Agent 框架，由 Nous Research 开发。它运行在终端、消息平台和 IDE 中，属于与 Claude Code、OpenAI Codex 同类的自主编码与任务执行 Agent。

本文不介绍如何安装和部署 Hermes Agent，只覆盖安装部署完成后的基础配置。如果你还没安装，请先参考 Hermes Agent 官方文档完成安装。

安装好以后，你面对的是一个”素颜”的 Agent——它不知道自己的身份，没有消息平台，也搜不了网络。这篇指南会带你完成五个最基础也最重要的配置，让它真正成为你贴身的 AI 管家。

一、选择模型：推荐 DeepSeek

为什么推荐 DeepSeek

Hermes Agent 支持 20+ 个 LLM 提供商，但 DeepSeek 是目前综合性价比最高的选择：

价格低廉：相比 Claude/OpenAI 动辄几十倍的价差，DeepSeek 的 API 价格几乎可以忽略不计
中文友好：原生中文理解能力强于同价位的其他模型
上下文窗口大：1M token 的上下文窗口，处理长对话不费力

配置步骤

如果你还没有 DeepSeek API Key，先去 platform.deepseek.com 注册并创建一个 API Key。

首次配置时，Hermes 还没有可用的模型，无法直接对话。需要在终端中运行安装向导：

1	hermes setup

在向导中选择 DeepSeek 作为提供商，填入 API Key 即可。你也可以直接用以下命令快速配置：

1	hermes model

选择 DeepSeek 并完成授权。

配置完成后，随便问它一个问题，如果能正常回复，说明模型已生效。

以后想换模型？直接对 Hermes 说「帮我切换模型到 xxx，这是我的 API Key」就行了，首次切换时需要提供新模型的 API Key，之后 Hermes 会记住，下次切换同款模型就无需重复提供了。

二、选择消息平台：推荐飞书

在终端里使用 Hermes 很方便，但如果你想随时随地与它对话——通勤路上、午休时间、甚至出门在外——就需要接入消息平台。

在所有支持的平台中，飞书是体验最好的选择之一：消息即时送达、支持富文本、操作响应迅速，而且在国内网络环境下访问无压力。

接入飞书只需要三步：快速创建机器人 → 配置凭证 → 发布配对。

1. 快速创建飞书机器人

飞书开放平台提供了一个快速创建入口，直接打开这个链接：

https://open.feishu.cn/page/openclaw?form=multiAgent

按照页面指引填写基本信息，即可一键创建自带机器人能力的应用，无需手动配置复杂的权限。创建完成后，你就会看到 App ID 和 App Secret。

2. 配置应用凭证

将你看到的 App ID 和 App Secret 告诉 Hermes：

1	帮我配置飞书，App ID 是 cli_xxx，App Secret 是 xxx

Hermes 会自动写入环境配置，并设置为 WebSocket 连接模式。

3. 配对连接

配置完 App ID 和 App Secret 后，在飞书中搜索你刚创建的机器人，给它发一条消息。它会回复一串配对码，像这样：

Hi~ I don't recognize you yet!
Here's your pairing code: JAD4JCxx
Ask the bot owner to run:
hermes pairing approve feishu JAD4JCxx

把这串内容复制下来，发给 Hermes。它便会自动完成配对。

配对成功后，再对它说：

1	把这个聊天设为主频道

至此，你的 Hermes Agent 已经成功接入飞书。无论你在哪里，只要打开飞书就能召唤它。

三、开启全局流式输出

流式输出（Streaming）让 Hermes 的回复像真人打字一样逐字出现，而不是等待完整回复生成后再一股脑儿地展示。

对于飞书这样的消息平台，流式输出能显著提升交互体验——你看着文字一点点出现，而不是对着一个转圈的小菊花干等。

配置方法

对 Hermes 说：

帮我开启流式输出

然后重启网关：

帮我重启网关

现在当你向 Hermes 提问时，它会像在聊微信一样逐字回复，响应感十足。

四、配置人格定义：SOUL.md

你有没有想过，Agent 的”性格”从哪里来？

Hermes 有一个独特的机制叫 SOUL.md——它定义 Agent 的身份、语气和沟通风格。每次对话都会自动加载这份文件，让 Agent 始终保持一致的人格。

什么是 SOUL.md

SOUL.md 位于 ~/.hermes/SOUL.md，是一个 Markdown 格式的身份定义文件。它不同于配置文件（config.yaml，负责功能设置），也不同于技能文件（SKILL.md，负责操作流程），它定义的是 Agent 的”自我认知”。

你可以通过它让 Hermes 变成：

一个称职的管家（正式、高效、可靠）
一个有趣的朋友（幽默、活泼、随意）
一个专业的技术顾问（严谨、精准、耐心）
任何你想要的风格

编写你的 SOUL.md

以下是一个示例，让 Hermes 成为你的个人管家：

# Hermes — 个人 Mac 电脑管家

## 身份定位

- 你是主人的 Mac 管家，负责管理 MacMini 的日常事务
- 高效、可靠、礼貌但不啰嗦

## 沟通风格

- 称呼主人为"主人"
- 主人偏好高效直接的沟通风格
- 日常事务直接处理，专业事务调度 Agent 处理

保存后无需重启，SOUL.md 每次对话都会重新加载，修改立即生效。试试对 Hermes 说”介绍一下你自己”，感受一下人格设定带来的变化。

关于 SOUL.md 与 Memory 的分工

很多人会弄混这两者的关系，这里做个清晰的区分：

	SOUL.md	Memory
作用	定义我是谁	记录用户是谁
内容	身份、语气、人格	偏好、事实、环境信息
生效方式	每次对话自动加载	持久化存取
修改生效	立即生效	下条消息生效

简单来说：SOUL.md 定人设，Memory 记事实，两者各司其职。

五、配置网络搜索：推荐 Tavily

默认情况下，Hermes 不具备网络搜索能力——它只能基于训练数据和你的对话来回答。但你总会有需要实时信息的时候：查天气、搜新闻、查技术文档。

Tavily 是一款专为 AI Agent 设计的搜索引擎 API，响应速度快，返回结构化的搜索结果，非常适合作为 Hermes 的网络搜索后端。

获取 API Key

访问 tavily.com 注册账号
在 Dashboard 中创建一个 API Key（免费版每月有 1000 次搜索额度）

配置步骤

对 Hermes 说：

1	帮我配置 Tavily 搜索，这是我的 API Key：tvly-xxxx

Hermes 会自动设置搜索后端并写入 API Key。

验证配置

重启会话后，试试搜索功能：

1	帮我搜索一下今天北京的天气

如果配置成功，Hermes 会返回实时的搜索结果和 AI 摘要。响应时间通常在 1-2 秒以内，体验相当流畅。

注意：配置变更后，如果是在终端中使用，说一句「帮我重置会话」即可；在飞书上直接发新消息即可。

总结

至此，你的 Hermes Agent 已经完成了五大核心模块的配置：

配置项	推荐方案	核心作用
模型	DeepSeek	低成本、高性能的对话底座
消息平台	飞书	随时随地与 Agent 交互
流式输出	开启	打字般的实时回复体验
人格定义	SOUL.md	让 Agent 拥有独特人格
网络搜索	Tavily	Agent 的对外信息通路