hermes-installer：在 Agent 裏完成 Hermes Agent 安裝與配置

大模型Skills Hermes Agent SkillHub AI Agent 安裝配置 消息網關 2026-10-19

前言

部署 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/

相關文章

騰訊 CubeSandbox 開源：60ms 冷啓動的硬件級 AI Agent 執行環境 2026-07-29 MCP 最大版本更新：無狀態核心如何讓 AI Agent 真正上生產 2026-07-30 騰訊開源 CubeSandbox：60ms 冷啓動、硬件隔離的 AI Agent 執行沙箱 2026-07-30 OpenCode 未認證 HTTP 服務致 RCE：開源 AI 編碼 Agent 的安全紅線 2026-07-30 Google 發佈 Gemini 3.6 Flash：Token 效率提升 17%、Agent 默認模型的性價比之戰 2026-07-30
羽毛球分组比赛记分
小程序二维码

欢迎使用《羽毛球分组比赛记分》微信小程序

小夜