跳到主要内容
AI教程

使用 Hermes Agent 安装和使用官方插件

了解如何安装 Hermes Agent、浏览经过审核的插件目录、添加和更新官方插件、迁移旧版安装并在本地测试插件。本指南还介绍可用的第一方集成，并说明目录固定版本如何实现受控发布。

AI我搜编辑部阅读约 12 分钟
使用 Hermes Agent 安装和使用官方插件
Hermes 官方插件

Hermes 官方插件提供什么

Hermes 官方插件是由 Nous Research 维护的Hermes Agent官方插件集合。仓库中的每个目录都包含一个独立的集成，可通过 Hermes 插件目录安装。

Hermes Agent 是一种可自我改进的 AI 代理，能够在不同会话之间保留有用信息、从经验中培养技能，并通过终端、Hermes Desktop、Telegram、Discord、Slack、WhatsApp 和 Signal 等界面运行。它支持多个模型来源，包括 Nous Portal、OpenRouter、Anthropic、OpenAI 和自定义端点。

项目将 Hermes 的通用部分保留在核心中，包括代理循环、记忆、技能、网关、模型路由和工具运行时。产品特定及供应商特定的功能则保留为独立插件。

Hermes 为什么使用插件

  • 安装更小：只需安装所需的集成。
  • 独立修复：插件可以获得经过审核的更新，无需等待新的 Hermes 核心版本发布。
  • 归属清晰：Nous 维护官方插件，供应商和独立作者维护社区插件。
  • 版本经过审核：目录条目固定到经过审核的提交，因此安装和更新使用的是已知版本。
  • 下载高效：Hermes 通过无 blob 的稀疏克隆，只获取选定的插件目录。

前置要求和 Hermes 安装

添加这些插件前，你需要先完成 Hermes Agent 的安装。在受支持的系统上，运行 Hermes README 中所示的安装脚本：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

安装后，确认命令行界面可用：

hermes --help

各个插件可能有额外要求。例如，Spotify 需要你拥有自己的 Spotify 开发者应用才能登录，Blender 需要 Blender 5.1 或更高版本及其 MCP 插件，Snyk 则需要 Node.js、npm 和 Snyk 账户。安装前请查看插件的目录信息。

浏览插件目录

Hermes 插件目录包含经过审核的官方和社区集成。使用搜索命令浏览可用条目：

hermes plugins search

安装前查看特定插件的信息：

hermes plugins info spotify

信息条目会说明插件的功能、要求以及其固定到的经过审核的提交。Hermes Desktop 用户可以在功能 → 插件下访问同一目录。

安装和更新插件

  1. 搜索所需的集成：

    hermes plugins search

  2. 阅读其要求和元数据：

    hermes plugins info spotify

  3. 安装经过审核的版本：

    hermes plugins install spotify

  4. 有新的经过审核的固定版本可用时，更新插件：

    hermes plugins update spotify

更新会根据目录指向下一个经过审核的提交，不会自动安装任意仓库版本。

选择官方插件

Home Assistant

Home Assistant 插件新增一个网关平台和四个工具，用于列出实体、读取状态、列出服务以及调用服务。Hermes 可以监控事件总线，响应选定的状态变化，通过 REST API 控制设备，并通过 Home Assistant 通知进行回复。

hermes plugins install homeassistant

其工具包括 ha_list_entities、ha_get_state、ha_list_services 和 ha_call_service。Cron 任务可以使用 deliver=homeassistant 将目标设为 Home Assistant。

Spotify

Spotify 插件提供用于播放控制、Spotify Connect 设备、队列、搜索、播放列表、专辑和用户媒体库的工具。

hermes plugins install spotify
hermes spotify login

登录命令会使用你自己的 Spotify 开发者应用执行回环 PKCE 登录。播放控制需要 Spotify Premium。

Claude Subscription DirectSDK

这个实验性模型提供商通过官方 Claude Code CLI，使用 Claude Pro 或 Max 订阅运行 Hermes 回合。Hermes 保留自己的代理循环、工具、审批处理和压缩机制，而该插件使用经过身份验证的 claude 二进制文件，作为请求范围内的模型客户端。

hermes plugins install claude-subscription-directsdk

安装后，打开 hermes model，并选择Claude Subscription DirectSDK（实验性）。如果 Claude Code 不可用，插件将拒绝运行，并提供安装提示。

Telegram 商业模式

Telegram 商业模式将 Hermes 转变为 Telegram Business 账户的审核式观察助手。它可以起草客户回复，但每条回复都必须经账户所有者批准后才能发送。

hermes plugins install hermes-telegram-business

记忆 Wiki

记忆 Wiki 添加了一个控制面板和 Hermes Desktop 标签页，可将本地会话历史整理为主题页面和每日日志。它还为 MEMORY.md 和 USER.md 提供只读审计面板。该插件会读取本地历史记录，但不会写入其中。

hermes plugins install hermes-memory-wiki

Blender

Blender 插件将官方 Blender Lab MCP 服务器与 Blender 工作流技能结合起来。它要求 Blender 5.1 或更高版本及其 MCP 插件，同时还需要 Git 和 uv。该插件支持 Windows、macOS 和 Linux。

hermes plugins install blender

Blender 工具会在 Blender 内运行 Python。请仅使用可信的工作流，并检查可能修改场景的操作。

Snyk

Snyk 插件使用 Snyk 的一方 MCP 服务器，并包含 snyk-security-scan 工作流技能。它可以扫描源代码、依赖项、容器镜像、基础设施即代码配置以及软件物料清单。

hermes plugins install snyk

它需要 Node.js、npm 和 Snyk 账户。身份验证通过浏览器使用 snyk_auth 完成。

TouchDesigner

TouchDesigner 插件通过 404.zero 的免费 twozero MCP 服务器连接到实时 TouchDesigner 会话，该服务器运行在 TouchDesigner 内。它包含一个工作流技能和 20 多个参考文件，涵盖算子、GLSL、音频响应项目和实例化等主题。

hermes plugins install touchdesigner

TouchDesigner 支持 macOS 和 Windows。

强调色选择器

强调色选择器是一个 Hermes Desktop 插件，可将 OKLCH 色轮添加到状态栏。拖动选择器即可实时重新着色主题，让主题作者能够就地测试强调色。所选颜色属于临时草稿状态，不会持久保存。

hermes plugins install accent-picker

迁移旧版安装

一些官方插件此前位于 Hermes 核心中或独立的代码仓库中。所需的迁移方式取决于最初的安装方式。

  • 内置的 Home Assistant 或 Spotify：运行 hermes update。更新后的首次启动可能会安装目录插件，同时保留现有配置、环境变量和登录状态。
  • 通过目录安装：运行 hermes plugins update <name>。现在目录会指向官方插件仓库，并在迁移过程中保留你的文件。
  • 基于 URL 安装：使用 hermes plugins install <name> --force 从目录重新安装一次。之所以必须这样做，是因为旧的独立仓库已归档，不再接收修复。

了解仓库结构

每个顶层插件目录都是一个完整的软件包。Python 插件通常包含清单、注册代码、依赖项和测试。基于 MCP 的可移植插件可以使用 plugin.json、mcp.json 和 skills 目录，而 Desktop 插件可以在 desktop 目录下包含 JavaScript。

hermes-official-plugins/
├── assets/
├── homeassistant/
│   ├── plugin.yaml
│   ├── __init__.py
│   ├── pyproject.toml
│   └── tests/
├── blender/
├── accent-picker/
└── ...

目录通过仓库、子目录和固定提交来标识插件。因此，安装 Spotify 不会下载 Home Assistant 插件。

在本地测试插件

进行开发时，请将 Hermes Agent 和官方插件仓库克隆到同一目录下：

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

官方插件会在 Linux、macOS 和 Windows 上，针对当前 Hermes 核心，在每次推送和拉取请求时进行测试。还会进行夜间测试，以发现导致插件失效的核心变更。

若要将本地检出版本安装到正在使用的 Hermes 环境中，请传入目录路径并强制替换：

hermes plugins install ./spotify --force

高级提示

  • 安装前检查：使用 hermes plugins info <name> 检查依赖项和经过审核的提交。
  • 优先使用目录名称：目录安装相比直接使用 URL 安装，能够更好地遵循未来经过审核的固定版本。
  • 谨慎使用强制选项：--force 选项适用于迁移和本地测试，但请确认替换的是预期的安装内容。
  • 遵守审批边界：Telegram Business Mode 等插件在发送回复前会明确要求审批。
  • 审查高权限集成：在应用程序中执行代码的工具（例如 Blender）只能用于受信任的工作流。
  • 在正确的仓库中报告问题：请在官方插件仓库中提交特定于插件的问题，并在标题中包含插件名称，例如 [spotify] ...。核心问题请报告至 Hermes Agent 问题跟踪器。

发布和构建插件

对于维护者而言，将插件变更合并到仓库的 main 分支并不会自动更新目录用户。完成发布需要针对 Hermes Agent 创建拉取请求，并修改 plugin-catalog/<name>.yaml 中插件的 sha: 值。目录中的固定版本即为发布版本。

要创建自己的集成，请从 Hermes 插件指南 和示例插件开始。标准插件是带有 plugin.yaml 清单的普通 Python 软件包。完成的插件可以提交到 Hermes 目录进行审核。

结语

Hermes Official Plugins 提供了一种受控方式，可以在不将每个集成都加入核心的情况下扩展 Hermes Agent。搜索目录，检查插件要求，安装经过审核的固定版本，并使用更新命令升级到之后经过审核的修订版本。开发者还可以克隆仓库，运行特定于插件的测试，并安装本地目录进行真实环境测试。