10 关键问题 Q&A
Q1：Hermes Agent 是什么？ A1：Nous Research 自研、具备自优化能力的 AI 智能体，跨终端 / IM 平台运行，支持接入各类大模型。
Q2：插件化架构好处是什么？ A2：内核精简、安装更快；插件独立发版修复；能力边界清晰，按需启用。
Q3：官方插件和社区插件区别？ A3：官方由 Nous 维护，放在本仓库；社区插件存于外部仓库，经审核后进入插件目录。
Q4：插件目录的 commit pin 机制作用？ A4：锁定经过评审的代码版本，防止自动拉取未审核变更，更新需要人工审核放行。
Q5：mcp-serve 插件能干什么？ A5：把 Hermes 本身暴露成 MCP 服务，让 Cursor、Claude Code 等 MCP 客户端调用 Hermes 的消息会话能力。
Q6：Bubblewrap 和 Singularity 插件用途？ A6：Linux 终端沙箱后端，隔离代码与终端执行，管控资源，适配共享集群、高安全场景。
Q7：agent-importers 插件功能？ A7：一键迁移 Cursor、Claude Code、OpenClaw 等智能体配置、规则、记忆到 Hermes。
Q8：插件安装时会下载全部仓库代码吗？ A8：不会，采用稀疏克隆，仅拉取目标插件子目录。
Q9：Langfuse 插件提供什么能力？ A9：对 Hermes 每一轮对话、LLM 调用、工具调用做追踪埋点，统计 token 与成本，支持脱敏上报。
Q10：如何开发和发布新官方插件？ A10：以 plugin.yaml 为清单开发；本地目录强制安装调试；合并 main 后提 PR 更新插件目录哈希完成上线。
附录 Hermes 官方插件库 ☤
这是 NousResearch/hermes-agent 的官方插件集合，由 Nous Research 开发与维护。 一个代码仓库收纳所有官方一级插件，一行命令即可从 Hermes 插件目录完成安装。
文档链接： https://hermes-agent.nousresearch.com/docs/plugins https://hermes-agent.nousresearch.com/docs/ CI 测试流水线：https://github.com/NousResearch/hermes-official-plugins/actions/workflows/tests.yml Discord：https://discord.gg/NousResearch 许可证：MIT
Hermes Agent 是什么？
Hermes Agent 是 Nous Research 推出的具备自我迭代能力的 AI 智能体。它能够在执行任务的过程中沉淀、编写技能，并随着持续工作不断优化；跨会话持久记忆关键信息；可在终端、Hermes 桌面客户端、Telegram、Discord、Slack、WhatsApp、Signal 等多种载体中运行，全部经由统一网关调度。
你可以接入任意大模型（Nous Portal、OpenRouter、Anthropic、OpenAI，或是你自研的模型端点），在笔记本、5 美元价位的 VPS、无服务器架构上跑起来。
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
轻量化内核，能力由插件向外扩展
Hermes 内核只保留所有用户都需要的基础能力：智能体主循环、记忆、技能系统、网关、模型路由、工具运行时。 所有绑定特定产品、厂商、小众场景的功能，全部放到插件里；需要的时候再安装，版本独立发布。
这套设计带来这些优势：
-
安装包更小、启动更快：你不需要为了跑代码智能体，顺带下载一个 Spotify 客户端。 -
补丁无需等待主版本发布：插件代码评审通过就可以单独发修复，不用等到 Hermes 大版本更新。 -
权责清晰：厂商配套插件由对应厂商维护，社区插件由作者维护，Nous 自研官方插件统一放在这个仓库。
插件目录（Catalog）
插件目录是一份经过审核的索引，囊括所有可安装项：模型服务商、记忆后端、消息平台、桌面扩展、语音、网页、自动化工具等。目录内已有数百条条目，来源包括 Nous、各合作厂商以及社区贡献者。 每一条目录条目都会绑定一个经过审核的 Git commit 哈希，你安装到的代码就是这份审核版本；只有新版本哈希通过审核后，update才会升级。
hermes plugins search # 浏览插件目录
hermes plugins info spotify # 查看插件能力、依赖、绑定commit
hermes plugins install spotify # 安装该审核版本
hermes plugins update spotify # 更新到目录里新的审核版本
Hermes 桌面端在「Capabilities → Plugins」里也提供同样的目录界面。
目录插件分为两个层级：
|
|
|
|
|---|---|---|
|
|
|
|
|
|
|
|
插件清单
homeassistant（Home Assistant）
hermes plugins install homeassistant
一套网关平台 + 四项工具。Hermes 监听 Home Assistant 事件总线，对你关心的状态变更做出响应；通过 REST API 控制设备，接收并转发 Home Assistant 通知。定时任务可以直接推送消息到你的手机，配置 deliver=homeassistant即可。 可用工具：ha_list_entities、ha_get_state、ha_list_services、ha_call_service
spotify
hermes plugins install spotify
基于 Spotify Web API 的 7 项工具：播放控制、Spotify Connect 设备、播放队列、搜索、歌单、专辑、个人曲库；配套 hermes spotify login，通过回环 PKCE 流程登录你自己的 Spotify 开发者应用。播放控制功能需要 Spotify 高级会员。 可用工具：spotify_playback、spotify_devices、spotify_queue、spotify_search、spotify_playlists、spotify_albums、spotify_library
claude-subscription-directsdk（实验性）
hermes plugins install claude-subscription-directsdk
模型服务商插件：让 Hermes 直接调用你已订阅的 Claude Pro / Max，依托官方 Claude Code CLI，不需要单独的 API Key、不计 token 单独计费。Hermes 保留自身完整的智能体循环、工具调用、审批机制、记忆压缩逻辑；插件把已登录的 claude二进制程序作为单次请求的模型客户端。如果未安装 Claude Code，会友好提示安装指引。 使用方式：在 hermes model里选择 Claude Subscription DirectSDK (Experimental)
memory-wiki
hermes plugins install hermes-memory-wiki
桌面面板 + 桌面标签页：把本地会话历史整理成可浏览的主题页面、每日日志；附带只读审计面板，查看 MEMORY.md和 USER.md。
仅面板展示，不会写入数据
blender
hermes plugins install blender
官方 Blender Lab MCP 服务（stdio 模式，锁定上游版本），配套 Blender 工作流技能，Hermes 可以读取、修改你的 Blender 场景。依赖：Blender 5.1+（安装官方 MCP 插件）、Git、uv。工具会在 Blender 内部运行 Python，仅使用可信工作流。
MCP 服务 + 技能，支持 Windows /macOS/ Linux
snyk
hermes plugins install snyk
通过 Snyk 官方 MCP 服务扫描代码（SAST）、依赖包、容器镜像、IaC 基础设施即代码、SBOM 物料清单，配套 snyk-security-scan工作流技能。依赖 Node.js/npm 和免费 Snyk 账号，支持网页登录 snyk_auth。
MCP 服务 + 技能
touchdesigner
hermes plugins install touchdesigner
对接 404.zero 免费 twozero MCP 服务（直接跑在 TouchDesigner 内部），配套 touchdesigner-mcp工作流技能，附带 20+ 参考工程（算子、GLSL、音频响应、实例化等），用来操控正在运行的 TouchDesigner 会话。
MCP 服务 + 技能，支持 macOS / Windows 上的 TouchDesigner
accent-picker（桌面端）
hermes plugins install accent-picker
Hermes 桌面状态栏上的 OKLCH 色轮。拖动色轮，整个客户端主题实时换色，方便主题作者就地调试强调色。颜色仅临时保存，不会持久化。
桌面插件：状态栏控件 + 调色命令
langfuse
hermes plugins install langfuse
把 Hermes 的每一轮交互追踪上报到 Langfuse：一轮交互对应一条 span，一次 LLM 调用对应一条 generation（包含用量、费用统计，缓存 token、推理 token 都会计入），每一次工具调用、子智能体对应一条观测记录。默认会对上报内容做脱敏；也支持仅上报元数据、全量上报两种模式。
可观测性钩子，支持 Langfuse 云版本或私有化部署
rea
hermes plugins install rea
借助 REA 的 MCP 服务逆向分析程序：原生二进制、.NET 程序集、Electron、JS 应用、安卓安装包、固件、浏览器行为；配套 reverse-engineer-anything工作流技能。JS 静态分析、归档文件检查开箱即用；原生代码反编译需要你自备 Ghidra / Hopper / IDA。依赖 Node.js 22.19+。
MCP 服务 + 技能，按需加载约 170 个工具
xchat（X 聊天）
hermes plugins install xchat
在 X（原推特）端到端加密私信里和 Hermes 对话。Hermes 使用你绑定的 X 账号运行：你可以在自己和自己的私信对话里调用它，也可以单独给它分配账号，直接私信这个账号。消息使用 X 官方 Chat XDK 在本地加解密，X 服务器只传输密文。支持加密媒体、线程回复、带提及权限控制的群聊、定时消息投递。hermes xchat setup查看运行账号、注册密钥。需要具备聊天 API 权限的 X 开发者应用。
网关平台，端到端加密
singularity（Apptainer）
hermes plugins install singularity
终端后端：在本机的硬化无 root Apptainer / Singularity 容器内运行 Hermes 的终端、文件、代码工具；可以设置 CPU、内存限额，支持可选持久化分层镜像。面向 HPC 高性能集群、不允许使用 Docker 的共享服务器环境。该功能之前内置在 Hermes 内核中。
终端后端，配置项
terminal.backend: singularity，仅 Linux
agent-importers
hermes plugins install agent-importers
hermes import-agent一条命令迁移 OpenClaw、Claude Code、Codex CLI、Cursor 的配置到 Hermes：指令、Cursor 规则、记忆条目导入为 Hermes 记忆；Bash 权限规则转为允许 / 拒绝列表；MCP 服务写入 config.yaml，技能一并迁移。迁移前默认预览，不会自动导入 API Key；OpenClaw 允许的密钥可以加 --migrate-secrets迁移；--sync增量同步源端变更。旧命令 hermes claw migrate/ hermes claw cleanup仍然兼容，对应 openclaw-migration 技能。该功能之前内置在内核。
CLI 命令：
hermes import-agent [openclaw|claude-code|codex|cursor]
mcp-serve
hermes plugins install mcp-serve
把 Hermes 自身启动成一个 MCP 服务：hermes mcp-serve可以让 Claude Code、Claude Desktop、Cursor、Codex 或任意 MCP 客户端接入 Hermes，读取所有已接入平台的对话、接收新消息事件、发送消息。默认不开放工具；加上 --tools开启后，额外提供网页、浏览器、视觉、图生图、技能、TTS 工具；终端、文件、看板工具永远不会对外暴露。前身是内核里的 hermes mcp serve。
stdio MCP 服务：默认 10 个对话工具，开启 --tools 后增加至 27 个
bubblewrap
hermes plugins install bubblewrap
终端后端：每一次 terminal和 execute_code都在独立的 bwrap 沙箱里执行；根目录只读、工作目录可写；SSH 密钥、云凭证、Hermes 家目录隐藏隔离，独立私有 /tmp、/proc，智能体 socket 做掩码，支持内存、CPU、进程数量限制。不需要镜像、没有常驻守护进程。注意：read_file/ write_file/ patch/ search_files这类文件工具是跑在宿主机上，不在沙箱内。
终端后端，配置项
terminal.backend: bubblewrap，仅 Linux
meshy
hermes plugins install meshy
Meshy 官方 MCP 服务生成 3D 模型：文生 3D、图生 3D、贴图、绑定骨骼、动画、格式转换、3D 打印预处理（修复可打印性、多色 3MF、模型拆分、对接切片工具），配套 meshy-3d工作流技能。每一次消耗点数的调用 Hermes 都会先向你确认。依赖 Node.js 18+、Meshy API Key（Pro 套餐）。
MCP 服务 + 技能，按需加载 28 个工具
advanced-delegation
hermes plugins install advanced-delegation
给 delegate_task子智能体委派新增两种路由方式：
-
模型路由：子任务可以按你写的列表，选择指定模型路由（快速、深度推理、本地模型等） -
配置文件路由：子智能体使用你的一条 Hermes Profile 运行，继承该 Profile 的模型、技能、凭证 只有路由名称和一行描述传给大模型。配套 hermes delegation config，聊天内用/delegation切换模式，要求 Hermes 版本 ≥0.22.5
camofox
hermes plugins install camofox
对接 jo-inc/camofox-browser：自托管反检测 Firefox，包装成本地 REST 服务。能力包括页面导航、带可点击坐标的无障碍快照、点击、输入、滚动、按键、截图（交由视觉模型解析）、只读 JS 读取、导入 Cookie。可选持久化浏览器配置文件，重启保留登录态。你原有的 CAMOFOX_URL和 browser.camofox配置可以直接沿用。该浏览器后端之前内置在 Hermes 内核。
11 项浏览器工具，工具集名称 camofox，需要提前启动 camofox-browser 服务
后续持续新增
当官方插件从 Hermes 内核剥离、或是从独立仓库并入时，都会放到这里。 你可以在 https://hermes-agent.nousresearch.com/docs/plugins 浏览全部插件（Nous、厂商、社区）。 Nous 自研、但不提供正式支持的实验性插件放在另一个仓库：hermes-labs-plugins。
如果你之前已经用过这些插件？
这里大部分插件之前放在别的地方： Home Assistant、Spotify 最早内置在 Hermes 内核，之后短暂迁移到独立仓库；Langfuse 之前作为内置可观测模块；Singularity/Apptainer 终端后端、Camofox 浏览器后端都曾经是内核组件；MCP Serve 前身是内核命令；其余插件各自有独立的 hermes-*仓库。 除 MCP Serve 以外，大多数场景你不需要手动操作：
-
如果你之前使用内置的 Home Assistant / Spotify / Langfuse / Singularity / Camofox：执行 hermes update，或是升级 Hermes 后首次启动，系统会自动从目录安装对应插件，保留你原有配置、环境变量、登录状态。 -
如果你之前已经从目录安装：现在目录指向本仓库， hermes plugins update <name>会迁移安装源，保留你的本地文件。 -
如果你使用旧版内置 hermes import-agent：开启了--sync自动同步的 Profile，升级后会自动安装 agent-importers；其他场景直接执行hermes import-agent，会提示一行安装命令：hermes plugins install agent-importers。 -
如果你使用旧命令 hermes claw migrate（OpenClaw）：现在由同一个插件提供，装好 agent-importers 之后，hermes import-agent openclaw和老命令hermes claw migrate/hermes claw cleanup都兼容，参数一致。 -
如果你之前跑 hermes mcp serve：现在需要安装mcp-serve，并且修改 MCP 客户端启动参数，从["mcp", "serve"]改成["mcp-serve"]。MCP 客户端配置独立于 Hermes，不会自动变更。 -
如果你之前直接通过仓库 URL 安装（例如 hermes plugins install NousResearch/hermes-homeassistant）：用hermes plugins install <name> --force重新从官方目录安装，后续升级就跟随本仓库；旧独立仓库已经归档，不再修复 bug。
仓库目录结构
hermes-official-plugins/
├── assets/ # README 和目录配图
├── homeassistant/ # 一个目录 = 一个完整插件
│ ├── plugin.yaml # 清单：名称、工具、环境变量、Hermes版本要求
│ ├── __init__.py # 注册入口 register(ctx)
│ ├── pyproject.toml # 插件依赖
│ └── tests/ # 插件自测用例
├── blender/ # 便携插件结构：plugin.json + mcp.json + skills/
├── accent-picker/ # 桌面插件：plugin.yaml + desktop/plugin.js
└── ...
每一个子目录都是独立完整 Hermes 插件。目录安装机制是：仓库 + 子目录 + 锁定commit；Hermes 只会拉取这个子目录（稀疏克隆，不下载无关代码）。比如安装 spotify，不会下载 homeassistant 的代码。
开发指南
每一次推送、每一个 PR，插件都会在 Linux /macOS/ Windows 上和当前 Hermes 内核联动自动化测试。还有夜间批量测试，提前捕获内核变更导致插件失效的问题，避免影响用户。
git clone https://github.com/NousResearch/hermes-agent
git clone https://github.com/NousResearch/hermes-official-plugins
cd hermes-official-plugins/spotify
HERMES_AGENT_REPO=../../hermes-agent PYTHONPATH=../../hermes-agent python -m pytest -q
在本地调试插件：
hermes plugins install ./spotify --force
发布流程：合并代码到 main 分支，然后在 hermes-agent 仓库提 PR，更新插件目录文件 plugin-catalog/<name>.yaml内的 sha 哈希。目录里的 commit 哈希就是版本发布锚点；用户执行 hermes plugins update时，才会同步到新锚点版本。
问题反馈：在本仓库提 issue，标题写明插件名，格式 [spotify] xxx。Hermes 内核本身的 bug，请到 hermes-agent 仓库提交。
开发你自己的插件
插件本质就是 Python 代码 + plugin.yaml清单。 参考文档： https://hermes-agent.nousresearch.com/docs/developer-guide/plugins/ 示例模板仓库： https://github.com/NousResearch/hermes-example-plugins 也可以参考 hermes-agent 仓库里的 plugin-catalog目录。
许可证：MIT 出品方：Nous Research