【P3】第3期:HermesAgent 进阶:多智能体 + 知识库 + WebUI 全解析
本文由视频教程转写整理,聚焦 Windows 上 HermesAgent 的进阶用法: 多智能体(对应 ClaudeCode 里“养多只虾/多分身”)、知识库(重点是网上较火的 LLM Wiki 配合 Obsidian)、Web UI(Dashboard),并补充了上一期安装中大家反馈的常见问题,最后推荐了几个好用的 Hermes 资源网站。
📌 前置说明:本期是进阶篇,默认你已看过 P1 / P2、装好了 Hermes 并接好了飞书/微信。若还没装,请先按前两期完成安装与基础配置。
〇、本期概览
- 知识库:LLM Wiki(已内建为 Hermes 的 skill)+ Obsidian 阅读呈现
- 多智能体:用 Profiles 创建第二个、第三个 Hermes Agent(相当于多个分身)
- Web UI / Dashboard:给不习惯命令行的人看的图形界面
- 常见问题答疑:CLI 启停、网关、微信使用、文件路径、换模型
- 资源网站推荐
一、知识库:LLM Wiki + Obsidian
1. 两个工具的分工
- LLM Wiki:真正用来构建/管理知识库的工具。官方文档里它叫 “Karpathy’s LLM Wiki”,定位是构建并维护一个由相互链接的 Markdown 文件组成的、可持续累积的知识库。现在它已内嵌进 Hermes,做成了官方内建 skill(位于仓库
skills/research/llm-wiki/),无需单独安装,直接用斜杠命令即可调用。 - Obsidian:一个 Markdown 笔记软件,用来直观地阅读/查看 LLM Wiki 生成的知识笔记。它不是必须的——知识库本质就是普通的互链 Markdown 文件,由 LLM Wiki 创建,Obsidian 只是让你读起来更舒服(官方并未把它和 Obsidian 强绑定,任何能读 Markdown 的工具都行)。
- Obsidian 的一大优点是双向链接(双链笔记),查找关联内容更方便。
2. 安装/使用 Obsidian(可选,仅为方便阅读)
- 到 Obsidian 官网 obsidian.md 下载安装。
- 打开后在下方找到「管理仓库 / Manage vaults」→「打开本地仓库 / Open folder as vault」,把知识库文件夹导入进来即可。
- 在「设置」里可调外观/样式/语言(作者用的是黑色主题,看起来更炫)。点开任意节点即可查看整合好的笔记。
说明:网上很多教程讲的是较老的 Obsidian 用法;现在更简单——Hermes 里一条命令就能建好知识库,Obsidian 只负责呈现。
3. 用 Hermes 创建知识库(核心,超简单)
启动 Hermes 后,用内建 skill 的斜杠命令:
/llm-wiki
- 方式一:只输入
/llm-wiki,它会引导你一步步创建知识库。 - 方式二:
/llm-wiki 关于<主题>的知识库(命令后空格加上你要建的主题),直接创建。
该 skill 的核心能力是:摄取资料(ingest)→ 编译/查询知识 → 一致性检查(lint)。因为是官方内建 skill,你完全不用专门安装,直接用斜杠命令启动即可。创建本身一分钟就能建好——关键不在创建,而在如何建好、维护好。
⚠️ 斜杠命令的确切名称以你安装版本里
/help列出的为准(内建 skill 名为llm-wiki)。
4. 维护知识库
- 让它建关于某主题的知识库后,它会向你索要知识资料。
- 它可能基于你前期交流给过的文件自动创建;若没给过,就会问你要——把相关链接 / 文件 / 文件目录给它即可。
- ⚠️ 务必问清楚知识库文件存在哪个路径。它生成的就是一堆文件(主要是
.md文件 + 配置文件),直接看可读性差;知道根目录后用 Obsidian 打开阅读才直观。
5. LLM Wiki 的三层结构(设计思想)
- 原始资料层(原始资料):你给它的原始材料,它不改动。
- Wiki 层:它做自然语言领域抽取 + 大模型知识整合后产出的文件。
- 规则层 / 配置层:LLM Wiki 的配置文件、日志等。
这些理解一下即可,不难、也不需要硬啃。网上(GitHub)能找到 LLM Wiki 的相关介绍资料;现在它被内嵌进 Hermes,作者认为非常好用。
6. 应用场景
- 帮你管理复杂知识、做视频/知识整理归档、学习辅助。作者举例:给它一本教材 + 配套代码,它整合得很好。
- 把建好的知识库交给你的 Hermes Agent,它就能基于你的知识库做问答/回复——适合做群知识问答机器人、商业客服等需要基于特定资料回答的场景,手动实现很方便。
二、多智能体:用 Profiles 运行多个 Hermes Agent
这对应 ClaudeCode 里“养多只虾 / 多个分身”。在 Hermes 里,这个机制官方叫 Profiles(配置档)——每个 profile 是一个完全独立的 Hermes 实例,拥有各自的配置、API Key、记忆、会话、技能和网关状态。命令行操作非常简单(也正因效率高,大厂都在推 CLI 类产品)。
📌 重要修正:视频里口播的“process create”实为
hermes profile create。下面用官方 Profiles 命令重写本节。
1. 创建第二个 agent(新建 profile)
-
第一个 agent 是默认实例,本名就叫
hermes(默认 profile)。 -
新建一个 profile 并取名(视频里取名
mini,官方示例用coder):hermes profile create mini把
mini换成你想要的名字即可。相关管理命令还有hermes profile show(查看)、hermes profile use <名字>(设为默认)、hermes profile delete <名字>(删除)。 -
profile 默认存放在
~/.hermes/profiles/<名字>/。
⭐ 关键特性:创建一个 profile 后,这个名字本身就变成了一套独立命令。例如建了名为
mini的 profile,你立刻就能用mini chat、mini setup、mini gateway start等命令——这正是视频里演示的用法。
2. 配置第二个 agent
-
创建后进入配置,用你取的名字 +
setup(全新 profile 可用mini setup --portal一次性配好模型与工具):mini setup -
配置流程与第一个 agent 完全一样(快速模式或详细模式都行),可参考上一期(P2)的配置方法。
-
⭐ 几乎所有东西都能单独设置,甚至可以给每个 agent 配不同的大模型:
- 例如第一个专做文本处理 → 用 DeepSeek 等优秀语言模型;
- 第二个要处理图片/声音等多模态 → 选多模态能力强的模型来配。
3. 各 agent 的命令对应关系(重点)
创建第二个后,命令前缀换成对应的 profile 名字即可:
| 操作 | 第一个(hermes / 默认) | 第二个(mini,举例) |
|---|---|---|
| 配置 | hermes setup |
mini setup |
| 命令行启动 / 交流 | hermes / hermes chat |
mini / mini chat |
| 通讯终端(飞书/微信)启动 | hermes gateway |
mini gateway |
一句话:第一个用
hermes,第二个用你取的 profile 名(如mini),其余子命令一一对应即可。 也可以用--profile <名字>(简写-p)在单条命令里临时指定使用哪个 profile。 多个 agent 的网关可以同时运行(官方“Running Many Gateways at Once”),各自作为独立进程,崩溃或登录时自动重启。
三、Web UI(Dashboard)
Web UI 适合不习惯命令行的人看个大概。作者态度是“看看就行”,当前用起来还不够舒服。
1. 版本要求
-
需较新版本才支持 Web UI(视频里说约 2026 年 4 月中旬、0.8 之后)。
-
版本不够就先更新:
hermes update常用标志:
hermes update --check(只检查不更新)、--backup(更新前备份)、--restart-gateway(更新后重启网关)。更新后若提示有新配置项,按引导添加;也可用hermes config check查看缺失项、hermes config migrate交互式补齐。 若更新的是第二个/第三个(改过名的 profile),把命令前缀相应替换(如mini update)。
2. 启动 Dashboard
hermes dashboard
- 它会启动一个纯本地 Web 服务并自动打开浏览器,默认地址
http://127.0.0.1:9119(本机 FastAPI 服务,数据不离开 localhost)。 - 没自动弹出时,手动把该地址复制到浏览器即可。
🔐 安全提示:Dashboard(9119)与 Hermes API 服务(默认 8642)默认只绑定 localhost、且没有鉴权。不要在没有加认证的情况下把它们通过反向代理暴露到公网。
3. 常见失败原因与处理
- Node 版本太低会导致启动失败——升级 Node 即可(视频中作者列了操作步骤,遇到可按其方法处理)。
- 中文显示问题:Web UI 支持中英文,默认英文;切中文时首次可能显示不全(浏览器中文配置不够好)。在命令行用一两条命令让 Hermes 处理一下,再刷新/重启浏览器,重新切中文即可。
4. 多 agent 的端口冲突(重点)
-
多个 agent 的 Dashboard 默认都用 9119 端口。第一个
hermes dashboard已占用后,第二个(mini)再开就会报端口冲突错误。 -
解决:改端口。指定一个不同端口启动第二个(确切参数以
hermes dashboard --help为准,通常为--port):mini dashboard --port 9120改完它会指向新端口,自动弹出(或手动复制链接到浏览器)即可打开第二个 agent 的界面。
-
Dashboard 里可查看:已连接的平台、最近对话、对话分析、日志等。
关于第三方 UI:网上有第三方项目能做成类似豆包/DeepSeek 那样的聊天界面(如 P2 中列出的若干社区项目),但很多还在 Docker 环境里,作者不想把电脑环境搞乱,所以暂用官方 Dashboard 过渡,等有更简单的方案再用。
四、常见问题答疑(上一期反馈汇总)
1. CLI 启动/停止
- 刚开机就提示“正在运行”之类的错误,可能是上次没正常退出。逻辑很简单,记住这几个命令即可:
- 重启服务:
restart - 停止:
stop
- 重启服务:
- 第二个 agent(如
mini)把命令前缀换成对应名字即可。
2. 网关(gateway)概念
- 在通讯终端(飞书/微信)里用要加
gateway;在命令行 CLI 里用就不加——区别就这点。 - 这个“网关机制”概念是从 ClaudeCode 带火的,现在用得挺多。
3. 推荐的稳定启动方式
- 作者是 Windows 电脑,从开始菜单找到 Ubuntu,用它打开命令行——这样用下来最稳定。
- 有朋友用别的方式/别的地方打开经常报错,原因不明;作者这个方式一直稳定。
4. 在微信上使用
- 装好配置好后,微信里可以发语音条控制——你说话,它支持语音,操控感更强。
- 配置:第一个机器人用
hermes gateway setup进入网关配置 → 选微信 → 回车弹出扫码页面(和平时扫码登录一样)。浏览器扫不出来就把链接复制到浏览器再扫。 - 出现的确认项一路 yes / 往下走即可。
- ⚠️ 微信只有一个 chatbot:不像飞书可建很多机器人(ClaudeCode 用 3 个、Hermes 用 8 个都够),微信只有这一个 bot,控制了这个就控制不了那个。要想清楚以谁为主。
5. 文件路径在哪
- 装了 Ubuntu(WSL)后,打开 Windows 任意文件夹,左侧「此电脑/网络」附近能看到 Ubuntu / Linux 的入口,进去就能找到文件。
- Hermes 装在 Ubuntu 上、Ubuntu 装在你的 Linux(WSL)里。问 AI 要路径时,它通常给的是它在 Ubuntu 里的路径,照着进去找即可。
6. 更换大模型
- 逻辑同微信使用:第一个用
hermes model进入模型配置,自己改即可——换模型、换 API Key、换具体模型都行。 - 例如 DeepSeek 更新后想换到 DeepSeek V4 的 flash 或 pro,用这个方式进配置直接换。
- ⚠️ 第二个 agent 注意把名字对应好(如
mini model)。
五、推荐资源网站
- HermesAgent 源码(GitHub):github.com/NousResearch/hermes-agent。适合有折腾能力的程序员朋友,源码、内建技能、文档都在这里。
- 官方文档 & Skills 目录:官方文档站 hermes-agent.nousresearch.com/docs;技能分两个目录——内建技能目录 Bundled Skills 和 可选技能目录 Optional Skills。前面用到的 LLM Wiki 就是内建技能之一(标注
built-in)。- 目前遗憾的是内建 skill 的中文说明还不多,早期需自己研究里面有什么。
- 💡 特别推荐官方/大厂出品的 skill 包(如 Claude Code 官方 skill 包),比开发者零散贡献的、只解决小问题的 skill 强大很多。
- 中文社区/资料:作者提到有 Hermes 中文社区,涵盖安装、对接飞书、配大模型、配第二/第三个 agent 等内容。
- ⚠️ 核实说明:官方渠道目前主要是上面的 GitHub 仓库和官方文档站;我未能核实到一个“官方”的中文社区站点(社区性质的资料较分散)。建议优先以官方文档为准,中文资料作为补充参考。
好玩功能推荐:语音模式——在命令行用快捷键打开后,可以发语音、用说话控制它,它也支持语音回复。值得自己玩一玩。后续这些功能预计会持续更新、越来越好用。
附:常用命令速查
| 用途 | 命令 / 操作 |
|---|---|
| 启动知识库 skill | /llm-wiki(或 /llm-wiki 关于<主题>的知识库) |
| 新建第二个 agent(profile) | hermes profile create mini |
| 查看 / 切换 / 删除 profile | hermes profile show / hermes profile use mini / hermes profile delete mini |
| 配置某 agent | hermes setup / mini setup |
| 命令行启动 / 交流 | hermes(hermes chat)/ mini(mini chat) |
| 通讯终端启动(飞书/微信) | hermes gateway / mini gateway |
| 配置通讯网关 | hermes gateway setup |
| 临时指定 profile | hermes -p mini chat |
| 更新版本 | hermes update(--check / --backup / --restart-gateway) |
| 启动 Web UI 面板(默认 9119) | hermes dashboard → http://127.0.0.1:9119 |
| 第二个面板(避端口冲突) | mini dashboard --port 9120 |
| 重启 / 停止服务 | restart / stop |
| 更换大模型 | hermes model / mini model |
说明:本文命令、名称、地址已对照 HermesAgent 官方文档核实并修正。其中最重要的修正是:视频口播的“process create”实为官方的 Profiles 机制(
hermes profile create <名字>)。其余口播误识(「LLM v ki / Vicky」「offset / Austin」「one two / 乌班 two」「get away」「mini 8」「deep sik」)已修正为 LLM Wiki / Obsidian / Ubuntu / gateway / mini / DeepSeek。少数参数(如dashboard --port的确切写法、知识库斜杠命令)以你安装版本的--help提示为准。