【P3】第3期：HermesAgent 进阶：多智能体 + 知识库 + WebUI 全解析

多智能体编排第 3 / 6 篇

本文由视频教程转写整理，聚焦 Windows 上 HermesAgent 的进阶用法：多智能体（对应 ClaudeCode 里“养多只虾/多分身”）、知识库（重点是网上较火的 LLM Wiki 配合 Obsidian）、Web UI（Dashboard），并补充了上一期安装中大家反馈的常见问题，最后推荐了几个好用的 Hermes 资源网站。

📌 前置说明：本期是进阶篇，默认你已看过 P1 / P2、装好了 Hermes 并接好了飞书/微信。若还没装，请先按前两期完成安装与基础配置。

写作日期：2026-06-09｜复核：2026-09-07（隔三个月）

📌 2026-09-07 复核：本篇引用的命令与文档链接全部仍然有效，正文未改一处。 八条子命令 hermes setup / model / config / profile / gateway / dashboard / update / chat 逐个对照官方 CLI 参考核实，全部命中；Dashboard、多 profile 网关、技能目录等文档页也都在（hermes -p 是选项不是子命令，没有一并核，跑 hermes --help 看）。

⚠️ 依赖的 P1 查出了三处漂移（Node 版本、pip install 途径被官方弃用、 hermes postinstall 已删），P2 查出第三方 Web UI 仓库改名 —— 那两篇顶部各有一张表，照做前先看。

🔔 要重验就跑这一条（零成本，覆盖本篇用到的全部命令）：
curl -fsSL https://hermes-agent.nousresearch.com/docs/reference/cli-commands \
  | grep -oE 'hermes (setup|model|config|profile|gateway|dashboard|update|chat)' | sort -u
# 本文基线：八条全部命中。少了哪条，正文对应位置就该改。
📌 用之前先让它在已知失败上失败一次 —— 把命令名换成一个编造的（如 hermes frobnicate）跑一遍，确认输出为空。不做这一步的话，「八条全中」也可能只是因为正则或页面结构变了而恒真。

〇、本期概览

知识库：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 提示为准。