前言¶

部署 NousResearch 的 Hermes Agent 时，安装路径、Python 虚拟环境、~/.hermes/config.yaml 与 ~/.hermes/.env、以及后续接模型和消息网关，步骤分散在文档与脚本里。若在 Cursor、Claude Code 等环境里只靠通用对话，容易漏确认安装方式、漏读网关或厂商配置说明。

hermes-installer 是 SkillHub 社区 Skill（@user_6c44c808/hermes-installer，当前版本 1.1.7），把 Hermes 的安装、更新、卸载、健康检查，以及模型提供商与飞书/Telegram/Discord 网关配置，整理成 Agent 可执行的 SKILL.md 与配套参考文档。下面介绍它是什么、能做什么，以及如何在本地启用。

这是什么¶

hermes-installer 的定位是 Hermes Agent 安装配置完整指南：当对话里出现安装、部署、更新 Hermes，或配置 GLM、Kimi、OpenRouter、国内云厂商模型、飞书等网关时，Agent 按 Skill 中的步骤与模板操作，而不是即兴拼凑命令。

• 坐标：@user_6c44c808/hermes-installer
• 来源：SkillHub 社区（community），发布者 user_6c44c808
• 分类：ai-agent
• 官方页面：SkillHub - hermes-installer

Skill 元数据标明 requires_api_key=true；SKILL.md 前置条件中还列出环境变量 OPENAI_API_KEY、OPENAI_BASE_URL，以及本机需具备 git、python、pip、docker 等依赖（具体以 Skill 包内说明为准）。

核心功能¶

依据 Skill 包内容，已核实的能力包括：

1. 安装与目录约定
   安装前要求与用户确认程序目录（默认 ~/.hermes/hermes-agent）、配置目录（~/.hermes）、Python 版本（默认 3.11），并支持命令行部署（git clone + uv 虚拟环境 + uv pip install -e ".[all]"）或 Docker 部署（详见包内 docker-deploy.md）。

2. CLI 与 Gateway
   区分终端 hermes 与消息平台 hermes gateway start；提供 CLI 与消息侧常用命令对照（如 /model、/new、hermes gateway setup 等）。Gateway 文档侧写明支持 Telegram、Discord 等；网关专题文档另含飞书配置流程。

3. 从 OpenClaw 迁移
   覆盖 hermes setup 自动检测 ~/.openclaw，以及 hermes claw migrate 系列子命令（含 --dry-run、--preset user-data、--overwrite）。

4. 配置与运维脚本
   配置文件路径：~/.hermes/config.yaml、~/.hermes/.env。包内附带 scripts/update-restart.sh、uninstall.sh、doctor.sh（及 Windows 对应 .ps1），用于更新重启、卸载与健康检查。

5. 按需加载的配置模块
   - api-config.md：OpenRouter、智谱 GLM、Kimi 及多家国内云模型等 API 的 config.yaml / .env 模板。
   - gateway-config.md：飞书、Telegram、Discord 等网关的环境变量与启动步骤。

6. 触发场景（官方简介）
   安装 Hermes、部署 Hermes Agent、配置 Hermes、配置 GLM/Kimi/OpenRouter/阿里云百炼/腾讯云/火山引擎/阶跃星辰、Hermes 更新、Hermes 飞书配置等表述，用于唤起本 Skill。

安装与启用¶

安装 SkillHub CLI¶

若尚未安装 CLI，可先检查版本；未安装时按 SkillHub 官方安装文档执行（完整安装或仅 CLI）：

command -v skillhub && skillhub --version

# 完整安装（CLI + 默认 Skill，推荐）
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash

# 仅安装 CLI
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only

说明见：SkillHub 安装与优先源配置。

将 Skill 装到当前 Agent 的 skills 目录¶

安装 Skill 时必须用 --dir 指向当前 Agent 识别的 skills 目录，否则默认落到 ./skills/ 可能无法被加载。常见路径如下（摘自官方安装文档）：

• Cursor：~/.cursor/skills/
• Claude Code：~/.claude/skills/
• Codex：~/.codex/skills/ 或项目下的 .agents/skills/

以 Cursor 为例，安装本 Skill：

skillhub install @user_6c44c808/hermes-installer --dir ~/.cursor/skills/

SkillHub 页面也提供「让 AI 按文档安装」的提示词，核心是引用 skillhub.md 并安装坐标 @user_6c44c808/hermes-installer。

安装完成后，按你所用 Agent 的要求重启或刷新 Skill 列表，使 hermes-installer 生效。

典型用法¶

本 Skill 不是单独运行的 CLI，而是在对话中由 Agent 读取 SKILL.md 及 references 式模块后执行。可复现的唤起方式包括：

1. 安装 Hermes
   用户说明要「安装 Hermes」或「部署 Hermes Agent」时，Agent 应先按 Skill 中的确认话术核对安装目录、Python 版本，并选择命令行或 Docker 方式，再执行文档中的克隆与 uv 安装步骤。

2. 配置模型
   用户说「配置 OpenRouter」或「配置 GLM」等时，Agent 应加载 api-config.md，按模板写入 ~/.hermes/config.yaml 与 ~/.hermes/.env（例如 OpenRouter 使用 OPENROUTER_API_KEY 与 model.provider: openrouter）。

3. 配置网关
   用户说「Hermes 飞书配置」或要接 Telegram/Discord 时，Agent 应读取 gateway-config.md，完成应用创建、环境变量（如 FEISHU_APP_ID、FEISHU_APP_SECRET）与 hermes gateway run、配对命令等步骤。

4. 更新与诊断
   触发「Hermes 更新」时，可走 hermes update 与网关停启流程，或调用包内 scripts/update-restart.sh；问题排查可走 hermes doctor 或 scripts/doctor.sh。

示例对话意图（无需固定措辞，与官方触发词一致即可）：

• 「帮我在本机用 Python 3.11 部署 Hermes Agent，配置目录用默认的 ~/.hermes。」
• 「Hermes 已装好，请按 OpenRouter 模板配置默认模型。」
• 「给 Hermes 配置飞书网关，并说明需要哪些环境变量。」

适用场景与注意¶

适合谁

• 已在 Cursor、Claude Code、Codex 等支持 Skill 的 Agent 中工作，需要把 Hermes 安装与后续配置交给 Agent 按文档逐步完成的人。
• 从 OpenClaw 迁移到 Hermes，或需要在同一套对话里切换「装环境 / 配 API / 配飞书或 Telegram」的场景。

限制与注意

• Skill 指导的安装流程包含 git clone https://github.com/NousResearch/hermes-agent.git；执行环境需能访问 GitHub，并满足 git、python、pip 等前置条件；Docker 路径需本机 Docker 可用。
• 配置模型与网关会涉及 API Key、App Secret 等敏感信息，应只写入 ~/.hermes/.env 等本地配置，避免泄露到日志或公开仓库。
• api-config.md 中的模型列表与端点以 Skill 包版本为准，上线前应对照各厂商当前文档核对。
• SkillHub 页面统计（截至资料抓取）：评分 100000，下载约 12807 次，安装约 325 次；与第三方镜像站的数字可能不一致，以 官方 Skill 页 为准。

结尾¶

hermes-installer 把 Hermes Agent 从安装确认、目录与虚拟环境、配置文件位置，到模型提供商与消息网关的模板化步骤，收敛成 Agent 可跟随的一份指南，并附带更新、卸载与 doctor 脚本入口。若你正在 Agent 环境里落地 Hermes，可先安装该 Skill，再用官方触发场景发起对话。

• SkillHub 技能页：https://www.skillhub.cn/skills/user_6c44c808/hermes-installer
• Skill API 坐标页：https://api.skillhub.cn/user_6c44c808/hermes-installer
• Hermes 官方文档：https://hermes-agent.nousresearch.com/docs/