Hermes Agent：實務工作者參考指南（2026）

TL;DR：Hermes Agent 是 Nous Research 推出的開放原始碼自我改進 AI 代理程式。它能以 CLI 運作，也能作為多平台訊息 gateway；會將持久身分與長期記憶儲存在磁碟上，彙整可隨使用持續改進的 skill，並支援任何與 OpenAI 相容的 LLM 供應商——包括 Nous Portal、OpenRouter、Anthropic、GitHub Copilot、z.ai、Kimi、MiniMax、DeepSeek、Qwen Cloud、Hugging Face、Google、xAI/SuperGrok，或您自行託管的端點。¹²¹⁹目前版本為 v0.21.5（標籤 v2026.9.24，發布於2026年9月24日），是 v0.21 系列的彙整修補版本；v0.21.5 的新功能介紹了變更內容，其後的版本章節則依時間由新至舊排列。⁵²對多數新使用者而言，最棘手的部分是供應商驗證：在標籤 v2026.9.24 中，Hermes 的靜態選擇器清單內建39個供應商，並會根據38個隨附的供應商外掛程式自動擴充該清單，另支援自訂端點與3種不同的驗證路徑（.env 中的 API 金鑰、透過 hermes model 進行 OAuth，或在 config.yaml 中設定自訂端點）。⁵³首先應掌握的就是驗證模型——後續所有行為都取決於最終解析出的供應商。

Hermes Agent 是完整的代理程式執行環境，而非單純的聊天包裝器。它能讀取檔案系統、在沙箱後端執行命令、擷取網頁內容、建立子代理程式、執行排程 cron 工作，並透過單一 gateway 程序與 Telegram/Discord/Slack/WhatsApp/Signal/Email 通訊，還能從經驗中建立自己的 skill。¹CLI 是建構於 run_agent.py 對話迴圈之上的終端使用者介面；gateway 則是長時間執行的程序，會將各訊息平台傳來的訊息導入同一個對話迴圈。³

Hermes 的入門使用者與專家之間，差別就在於能否掌握5大系統。精通這些系統後，Hermes 就能成為事半功倍的利器：

1. 供應商解析：驗證流程如何對應至 API 呼叫
2. 設定階層：config.yaml + .env + auth.json + SOUL.md + AGENTS.md
3. 工具與 toolset 系統：代理程式能執行哪些操作，以及各平台如何加以限制
4. Skills 系統：代理程式自行建立並持續演進的程序性記憶
5. Gateway + cron + profiles：讓 Hermes 在您的日常環境中運作，而不僅限於您當下所在之處

重點摘要

• 供應商驗證有3種路徑，而非只有1種。在 .env 中設定 API 金鑰、透過 hermes model/hermes auth 進行 OAuth，或在 config.yaml 中設定自訂端點。請選擇與供應商相符的路徑，而不是最熟悉的路徑。
• 切換供應商只需一行命令。hermes model 會以互動方式引導您設定每個受支援的供應商，包括 OAuth 登入；/model provider:model 則能在不中斷歷史記錄的情況下，於工作階段中途切換模型。²
• 使用者可編輯的設定介面只有2個檔案。~/.hermes/config.yaml 儲存設定，~/.hermes/.env 儲存機密資料。auth.json、SOUL.md、MEMORY.md 與 skills/ 由 Hermes 直接管理——您可以手動編輯 SOUL.md，其餘項目則由代理程式自行操作。⁴
• Hermes 是 OpenClaw 的後繼者。若要進行移轉，hermes claw migrate 可自動匯入30多個類別的狀態資料。⁵
• 輔助工作預設會沿用主要模型。視覺處理、核准分類、壓縮與工作階段標題會以獨立的「輔助」LLM 呼叫執行；在此標籤版本中，auto 會將每項工作都導向主要聊天模型——無須額外設定，但若採用昂貴的推理模型，這些附帶工作將產生可觀的成本。必要時，可將個別 auxiliary.<task> 欄位指向價格低廉且速度快的模型。⁴³⁴

以下每個章節均以 hermes-agent.nousresearch.com/docs 的上游文件及 github.com/NousResearch/hermes-agent 的原始碼樹為依據。每項事實陳述皆附有註腳，指向其具體來源頁面。

選擇您的閱讀路徑

Hermes 的運作方式：心智模型

Hermes 的架構以單一對話迴圈為核心，任何進入點皆可呼叫。這些進入點包括 CLI（cli.py）、訊息 gateway（gateway/run.py）、用於編輯器整合的 ACP 轉接器、批次執行器，以及 API 伺服器。³它們最終都會呼叫 run_agent.py 中的 AIAgent.run_conversation()，其運作流程如下：

1. 透過 agent/prompt_builder.py，根據 SOUL.md、MEMORY.md、USER.md、skills、context 檔案及工具指引建立系統提示詞（2026年9月的模組拆分已將其移至新的 agent/ 套件）³
2. 透過 runtime_provider.py 解析執行階段 provider——此步驟會選擇驗證方式、基礎 URL 與 API 模式³
3. 使用以下 3 種 API 模式之一呼叫 provider：chat_completions、codex_responses 或 anthropic_messages³
4. 透過 model_tools.py 與中央工具登錄檔（tools/registry.py），分派傳回的所有工具呼叫³
5. 持續迴圈，直到模型產生最終回應，再將工作階段保存至支援 FTS5 的 SQLite³

理解此迴圈至關重要，因為 personalities、memory、skills、compression、fallback 等所有功能，都會銜接其中一個階段。閱讀某個設定鍵並想知道它的作用時，答案通常是：「它是用來調整上述迴圈第 1、2、3 或 4 階段的控制項。」

與平台無關的核心。單一 AIAgent 類別同時服務於 CLI、gateway、ACP、batch 與 API 伺服器。平台差異存在於進入點，而非 agent 本身。³因此，相同的斜線命令能在終端機和 Telegram 中運作——它們皆由 hermes_cli/commands.py 中共用的 COMMAND_REGISTRY 分派。⁶

目錄結構就是系統。Hermes 將所有內容儲存在 ~/.hermes/ 下（非預設 profiles 則使用 $HERMES_HOME）：⁴

~/.hermes/
├── config.yaml        # Settings (model, terminal, TTS, compression, etc.)
├── .env               # API keys and secrets
├── auth.json          # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md            # Primary agent identity (slot #1 in system prompt)
├── memories/          # Persistent memory (MEMORY.md, USER.md)
├── skills/            # Bundled + agent-created + hub-installed skills
├── cron/              # Scheduled jobs
├── sessions/          # Gateway session state
└── logs/              # agent.log, gateway.log, errors.log (secrets auto-redacted)

上述每個檔案各司其職，彼此互不重疊。如果您想知道「Hermes 將 X 儲存在哪裡」，答案必在其中。

v0.21.5 的新功能（9月24日彙整版）

Hermes Agent v0.21.5（標籤 v2026.9.24，2026年9月24日）是目前的版本，也是 v0.21.x 系列第 3 個精簡彙整版本：「此標籤將自 v0.21.4 以來合併的約 460 個 PR 彙整為穩定的標記版本，供下游使用者採用」。精選版本說明再次延後至 v0.22.0。以下是已在該標籤原始碼中確認、與操作人員相關的變更：⁵²⁵³

• Hindsight memory 已移出核心程式碼樹。內建的 Hindsight provider 與 hermes-agent[hindsight] pip 額外套件皆已移除；Hindsight 現改由 Vectorize 維護，並從 plugin 目錄安裝；版本說明並未提及此事。若設定中包含 memory.provider: hindsight，hermes update 會將目錄中的 plugin 安裝到每個指定該 provider 的 profile 主目錄；若仍未安裝，首次啟動 agent 時也會安裝，除非 security.allow_lazy_installs 設為 false（此時請執行 hermes plugins install hindsight）。設定、.env 鍵值及 memory 資料均不受影響。請參閱外部 Memory Provider。
• gateway.multiplex_profiles: false 已停用。gateway 會直接將其改寫為 true，並顯示一次性的方框提示。若具名 profile 必須保有自己的 gateway，請在其 config.yaml 中設定 gateway.standalone: true；若要讓某個受服務的 profile 離線，現在可使用 hermes -p <name> gateway stop 將其暫停，而不會停止主機。請參閱訊息 Gateway。
• Nous 與 OpenRouter 選擇器中的新模型：GPT-6 Sol、GPT-6 Luna（兩者皆提供 -pro 變體），以及 Claude Opus 5.5。
• Plugin 相容性維持不變：plugins.allow_deprecated_imports: true 仍可正常運作。

更新方式：執行 hermes update 或安裝程式單行命令；Docker 與 Hermes Cloud 映像檔皆以 nousresearch/hermes-agent:v2026.9.24 為基礎建置。⁵²

v0.21.4 的新功能（第二個彙整修補版本）

Hermes Agent v0.21.4（標籤 v2026.9.21，2026年9月21日）是 v0.21.x 系列第二個刻意精簡的彙整版本。其原文定位為：「修補版本。此標籤將自 v0.21.3 以來合併的約 1,800 個 PR 彙整為穩定的標記版本，供下游使用者（Docker 映像檔、Hermes Cloud、託管部署）使用。」自 v0.21.3 以來的範圍包括：「5,071 個非合併提交」、橫跨「5,169 個變更檔案」、「1,812 個已合併 PR」，以及「2,116 個已關閉議題」。若按提交數計算，這是專案史上標籤間規模第二大的區間，僅次於 v0.21.1 的 5,139 個；若按已合併 PR 計算，則是歷來最大的一次。經過編纂的完整內容再次延後發布，原文為：「此區間的完整編纂版發行說明將隨 v0.22.0 推出，並記錄自 v0.21.0 起的所有內容」，以及「此區間內沒有任何內容遭到略過。」說明中確實列出了尚未記錄的項目，以下每一項均已在該標籤的原始碼中查核；若某項內容變更了本指南的既有章節，相關連結會直接列於該項之中。⁵⁰⁵¹

• 每台主機僅有一個 gateway，Desktop 會附加至現有程序，而非重新產生程序。 規則是每台主機、每個作業系統使用者只能有一個 hermes serve 與一個 hermes gateway run，兩者各自多工處理所有 profile——此規則由新的全主機單例層強制執行：勝出程序在其存續期間持有主機鎖，另有一筆攜帶 (pid, createTime) 的會合記錄，讓第二次呼叫能確認擁有者確實是同一個仍在執行的程序，並附加至該程序，而非繫結第二個連接埠。系統必須證實記錄已失效，絕不憑空假設；Desktop 應用程式也從自身一側採用相同概念，附加至執行中的主機後端，而非產生第二個後端。Messaging Gateway 詳述其運作機制。⁵¹
• 連接器整合為一項由後端擁有的操作，並共用同一張設定卡片。 一次 manage_connections tool 呼叫會在後端驅動純資料的連線狀態機，而 Desktop、TUI 與 CLI 會將其呈現為相同的設定卡片：每項缺少的憑證各有一個欄位；在所有必填欄位都有文字之前，卡片的動作按鈕會維持停用。請參閱 Nous 免費方案小節。⁵¹
• --format stream-json：機器可讀的單次執行。 hermes chat -q ... --format stream-json 會為 CI 執行器與協調器在 stdout 的每一行輸出一個 JSON 物件：先是 system/init 事件，接著是 text 增量／tool_use／tool_result 事件，最後是一個終止用的 result 封套，其中包含結束代碼、最終文字及 token 統計資料。診斷資訊與 session ID 會留在 stderr；每個事件的 tool 輸出上限為 5,000 個字元。此旗標隱含 --quiet，且必須搭配 -q 或 --query-file（若未提供則以代碼 2 結束），也不能與 --tui 併用。hermes chat 選項表 已列入此旗標。⁵¹
• skills.auto_load 將 skill 固定載入每個 session。 列於 config.yaml 中 skills.auto_load 之下的名稱，會在每個新 session 中完整載入——無論是 CLI、TUI、gateway、cron 或 API——並在首次建立 prompt 時解析一次。Skills System 新增了「固定載入的 Skills」小節。⁵¹
• 針對未授權 DM 的 decline 選項。 unauthorized_dm_behavior 在 pair 與 ignore 之外新增第三個值：decline 會傳送一次禮貌的拒絕訊息，之後對該傳送者保持沉默 24 小時。請參閱 User Authorization & Pairing。⁵¹
• mcp.discovery_concurrency 限制 MCP 探索連線數。 預設值為 4，0 表示不設上限；所有已設定的伺服器仍會連線，只是不再同時湧入。請參閱 MCP Integration。⁵¹
• session_search 新增時間範圍與召回重試。 探索格式接受 after／before 範圍（ISO 格式或如 7d 的相對時間長度）；若多字詞查詢結果為零，系統會改以符合任一字詞的方式重試，而非採用 FTS5 預設的所有字詞 AND 邏輯。請參閱 Session Search。⁵¹
• hermes sessions set-journal-mode delete|wal：離線 journal 轉換工具。 這是供使用者自行處理 state.db 卡在錯誤 SQLite journal 模式的途徑——以往必須手動執行 PRAGMA journal_mode=DELETE。請先停止 gateway、dashboard 與所有 CLI：只要任何外部程序仍持有資料庫，工具便會拒絕執行；它不會等待開啟者退出，而會直接切換模式，並在完成後驗證 SQLite 標頭位元組。Windows 不支援持有者掃描，因此必須先自行停止所有 Hermes 程序，再傳入 --force，否則工具會拒絕執行。hermes doctor 現在也會引導您使用此指令。Top-Level Commands 中的 hermes sessions 列已收錄此功能。⁵¹
• Desktop：字型設定、一鍵更新引擎，以及解除安裝 plugin。 Settings 新增字型家族欄位，並依 profile 儲存於 desktop.font_family——它會覆寫整個聊天與 UI 中佈景主題的無襯線字型；建議清單優先列出無障礙字型（OpenDyslexic、Atkinson Hyperlegible、Lexend），留空則由佈景主題決定。當受管理的本機模型執行環境有更新可用時，會顯示「更新引擎」按鈕；若更新失敗，按鈕仍會保留，以便直接重試。此外，Plugins 中心現在可在確認對話框後解除安裝 plugin。⁵¹
• 影片目錄：LTX 2.5 與 Kling O3。 FAL 影片 plugin 新增 ltx-2.5（Lightricks 的開放原始碼音訊影片模型：原生音訊、最長 20 秒／4K 的圖片轉影片、攝影機運動預設，以及平價方案——fal 會拒絕解析度為 1440p／2160p 且超過 10 秒的影片）與 kling-o3（Kuaishou 的前沿模型系列，屬於高階方案：支援多鏡頭原生敘事、選用音訊，以及 3 至 15 秒片長）。⁵¹
• plugin 目錄成為隨附的目錄與網站。 儲存庫中的 plugin-catalog/ 資料夾從 v2026.9.14 的 9 個項目增加至此標籤的 228 個——每個 plugin 都有一份經過審查的 YAML，並固定於確切的 commit SHA——文件網站現在也會為每個 plugin 與每位作者建立頁面，呈現取自固定 commit 的 plugin README。發行說明中列出的 10 個社群 plugin，在該標籤中全都已收錄於目錄。Plugin System 詳述相關資訊。⁵¹
• 另有大量修正，涵蓋 profile／多工隔離、cron、kanban、Desktop 與 state.db；發行說明僅將其列為一個類別，這些修正的完整編纂記錄將留待 v0.22.0 撰寫。⁵⁰

plugin 相容性回復仍未在此區間落地。 COMPAT_MANIFEST.md、compat_manifest.json 與相容性 shim 在 v2026.9.21 中全都仍然存在；此區間對 hermes_cli/plugin_compat.py 的唯一變更，是加入全程序共用的掃描快取（多工 gateway 會為每個提供服務的 profile 探索一次 plugin，而在啟動路徑上重新剖析每個 plugin 的原始碼，每個 profile 約需耗時 0.4 秒），以及修正 Windows 上 POSIX 格式的命中路徑（#112576）——日期閘門與字面布林值的緊急出口均未變更，因此 plugins.allow_deprecated_imports: true 仍可讓受影響的 plugin 繼續載入。Plugin System 中的相容性說明框記載了目前狀態。⁴²

更新方式維持不變：git 安裝使用 hermes update，全新安裝則使用 shell 安裝程式；Docker 與 Hermes Cloud 映像檔均從此標籤建置（nousresearch/hermes-agent:v2026.9.21）。⁵⁰

v0.21.3 的新功能（9月14日修補版本）

Hermes Agent v0.21.3（標籤 v2026.9.14，2026年9月14日）涵蓋 main 上另外 3 天的變更，但發行說明僅列出 2 個項目。發布此版本是因為 Cloud agent 會自動更新至最新的發行標籤，而修復遠端 gateway 登入問題後，才能順利連線至這些 agent。（1）遠端 dashboard session 不再因密集的重新整理請求而遭撤銷：gateway 上的兩條重新整理路徑（cookie 閘門與 Desktop 的原生 bearer 路由）現在會將攜帶相同輪替 refresh token 的並行請求合併為單次執行。因此，Desktop 喚醒時瞬間湧現的請求，不會再把已輪替的 token 重送至 Portal 的重複使用偵測機制，進而撤銷整個 session——重新整理作業也已移出事件迴圈，所以速度緩慢的身分提供者不再會凍結 /api/status。（2）長時間執行的程序不再建立重複的 state.db 寫入控制代碼：gateway、dashboard／Desktop 後端、ACP 與 CLI 讀取端會以唯讀方式附加，而同一程序內的寫入端則共用登錄中的控制代碼。此區間統計資料為：橫跨「2,642 個變更檔案」的「1,036 個非合併提交」，以及「338 個已合併 PR」。其餘內容均刻意延後記錄：發行說明列出了目前未記錄的項目（所有模型選擇器中的推理強度選項、OpenRouter OAuth PKCE、HEIF／HEIC／AVIF 解碼、一波 FAL 目錄更新、Slack 貼上的表格與 Agent Sessions API、跨 VM 檔案系統上的 state.db WAL 拒絕機制等），並承諾提供完整的編纂記錄，原文為：「此區間的完整編纂版發行說明將隨 v0.22.0 推出，並記錄自 v0.21.0 起的所有內容」，以及「此區間內沒有任何內容遭到略過。」⁴⁹

plugin 相容性的截止日期也如期到來。 v0.21.1 宣布的 2026-09-14 移除措施，是以日期閘門的形式在已發布的程式碼中生效，而非以程式碼回復的形式實施：在標籤 v2026.9.14 中，hermes_cli/plugin_compat.py 包含 COMPAT_REMOVAL_DATE = 2026-09-14，且 removal_in_effect() 會從該日期起傳回 true（若 manifest 檔案消失，則立即生效），因此受影響的外部 plugin 現在會在載入時遭停用，並顯示紅色通知。尚未發生的是：真正刪除舊匯入路徑的回復。COMPAT_MANIFEST.md、compat_manifest.json 與相容性 shim 在該標籤中全都仍然存在——截至9月22日，在 v2026.9.21 與 main 上也依然存在——因此 plugins.allow_deprecated_imports: true 仍可作為緊急出口：只要允許載入器繼續執行，舊路徑仍可解析。另有 2 個容易踩雷之處：此鍵必須是字面 YAML 布林值（程式碼只接受布林值 True；依原始碼註解「Literal boolean only」，如 "true" 或 "false" 的引號字串都會被視為未設定），而且一旦回復落地，這個出口便會失效，因為相關路徑本身將會消失。Plugin System 中的相容性說明框記載了目前狀態。⁴²⁴⁹

v0.21.2 的新功能（state.db 修補版本）

Hermes Agent v0.21.2（標籤 v2026.9.11，2026年9月11日）的首要任務，是修復 v0.21.0 所造成的問題。版本說明直言不諱：「v0.21.0 大幅重寫了工作階段儲存區的連線處理方式，卻導致部分安裝環境中的 state.db 變得脆弱：多個寫入端彼此取消對方的鎖定、正常的資料庫被誤報為損毀，以及單筆異常資料便會使 sessions list 完全失效。此版本徹底解決這類問題，並彙整 v0.21.1 發布後4天內合併至 main 的所有變更。」v0.21.1 的說明刻意保持精簡，本版則記錄了自身的主要亮點；這段期間共有「947筆非合併提交」，涉及「1,869個變更檔案」與「312筆已合併 PR」，由「140位貢獻者」共同完成。至於整個 v0.21.x 階段的精選紀錄，仍留待 v0.22.0 撰寫。⁴⁸

• state.db 可靠性改善行動：6筆 PR，解決44項議題。 版本說明首先提供了維運建議，而您也應照此處理：若 state.db 在 0.21.0 或 0.21.1 中損毀，請執行 hermes doctor。它現在會分別指出結構性損毀與全文搜尋索引損毀，不再將所有問題統稱為「FTS 寫入損毀」；當重建不足以解決問題時，也會引導您使用 hermes sessions recover --inspect-only（離線、非破壞性且鎖定至特定 profile；可回報標準資料表是否可讀，且不會建立輸出資料庫）。針對根本原因的修正，則移除了儲存區上的所有次要寫入端：profile gateway 原先每隔5秒便會將託管聊天室狀態寫入根層級的 state.db，如今這項協調工作已移至專用的 shared-state.db，因此 profile gateway 絕不會以可寫入模式開啟主要工作階段儲存區；dashboard 會優先以唯讀模式開啟；cron 的生命週期防護機制改經由受追蹤的連線登錄區處理，不再對運作中的資料庫直接呼叫原始 open()（這會取消 gateway 的 POSIX 鎖定，堪稱導致 SQLite 損毀的經典做法）；而 doctor --fix 若無法證明 checkpoint 安全，便會拒絕執行。除了處理寫入端之外：FTS 索引損毀如今只會降低搜尋功能，並於稍後重建索引，不再以全面封閉方式中止整個回合；單筆損毀資料也不會再使 sessions list、匯出或深入分析功能失效（異常資料列會顯示為 ?，並附上指出工作階段的警告）；工作階段絕不會繫結或讀取其他 profile 的資料庫；唯讀開啟也不再取得寫入鎖定，因此在忙碌 gateway 後方執行的一次性 hermes，已從延遲4至20秒後失敗，縮短至0.01秒即可完成。⁴⁸
• 強化多 profile 隔離。 自 v0.19.0 起，本指南便反覆提及專案所宣稱的能力：profile 路由可讓每個 profile 擁有「完全隔離的設定、skills、記憶與密鑰」。但截至 v0.21.2，這項承諾仍存在若干漏洞，如今均已修補：次要 profile 的機器人會繼承預設 profile 的允許清單、轉接器可能將憑證傳送至預設 profile 的主機、stdio MCP 伺服器會收到預設 profile 的 vault 密鑰、MEDIA: 傳送可能附加其他 profile 的 .env/auth.json/state.db、webhook 與 Feishu 回呼可能偏離已路由的 profile，以及次要 profile 可能從個別處理程序的備忘快取中取得同層 profile 的 Nous bearer（#107609-#107630）。若您在同一個多工 gateway 下執行多個 profile，此版本才真正兌現隔離承諾。⁴⁸
• 對密碼毫不知情的憑證 vault。 Agent 現在可透過 1Password、Bitwarden 或本機 Hermes vault，在瀏覽器中登入、付款及填寫地址，全程無須接觸任何密鑰；雙因素驗證碼則來自已儲存的驗證器金鑰（TOTP：base32 種子或 otpauth://totp URI；不接受計數器型 HOTP），或透過您的 UI 要求輸入。每個後端交給 Agent 的資料格式都相同——登入中繼資料，加上一個不透明且具命名空間的控制代碼（本機使用 vault_，外部則使用 op:、bw:），密碼只會在填入當下解析；外部管理工具在您為當次工作階段解鎖前會維持鎖定，而主密碼「絕不作為工具引數、絕不出現在 argv 中，也絕不持久保存」。此功能建立在 v0.19.0 的 SecretSource 基礎上；後者已將 provider API 金鑰移出純文字 .env，如今 vault 也以同樣方式保護 Agent 的瀏覽憑證。⁴⁸
• 經過精選並以 SHA 鎖定版本的 plugin 目錄。 hermes plugins browse 會列出「精選 plugin 目錄中的每個項目」，hermes plugins search 可查詢目錄，而 hermes plugins install 除了 Git URL 與 owner/repo，也能解析目錄名稱。hermes plugins pack 則以「宣告式、可共享的 plugin 組合」補全整套功能：透過單一 hermes-pack.yaml 將一組 plugins 鎖定至確切的提交 SHA；pack install 會展開為一般的版本鎖定安裝，同時仍由各 plugin 分別取得功能同意；pack export 可為目前的安裝項目輸出 pack；pack show 則用於試執行。Plugin 系統的指令區塊已納入這些新子指令。⁴⁸
• Nous 免費方案與引導式首次啟動。 全新安裝現在開箱即用，只需一項登入指令即可獲得免費推論與連接器；您也能在聊天內使用 /login，並透過 tool_search 搜尋連接器工具（Gmail、Linear、Notion 等）。桌面版的引導式首次啟動由 HERMES_GUEST_ONBOARDING=1 控制，而且只有字面值 1 才會啟用：桌面版自身的測試明確驗證，'true'、'0' 與空值都不會開啟此功能；啟動判定也會寫入所產生後端的環境中，確保繼承而來的值絕不會滲入。請參閱 Nous Tool Gateway。⁴⁸
• 桌面版後端大量重複啟動的問題已成過去。 Bot Mode 過去會在啟動時及每次 roster 更新時，為每個 profile 啟動或連線至一個後端；將游標停留在 Bots roster 上，還會為每一列啟動一個後端，而切換 profile 也可能重複啟動主要後端。這些問題均已在本次更新期間修復。⁴⁸

更新方式維持不變：現有安裝請執行 hermes update，全新安裝則使用 shell 安裝程式。⁴⁸

v0.21.1 的新功能（彙整修補程式）

Hermes Agent v0.21.1（標籤 v2026.9.7，2026年9月7日）刻意保持精簡：這是一個「修補版本」，旨在「彙整自 v0.21.0 以來目前 main 分支的內容，供標籤式部署與下游使用者採用」。內文列出此期間的統計資料——「4,364 個變更檔案中共有 5,139 個非合併提交（+601,014／-768,419）」以及「632 個已合併 PR」——隨後將完整說明留待日後補上：「此期間經整理的完整版本資訊將隨 v0.22.0 發布。」因此，這是專案歷來相鄰標籤之間規模最大的單一變更區間（先前沒有任何相鄰標籤區間超過 v2026.7.20..v2026.7.30 的 2,790 個非合併提交），卻搭配了最精簡的版本資訊。在 v0.22.0 補上經整理的正式紀錄之前，以下6個面向就是此標籤版本中會改變 Hermes 操作方式的重點，且每一項都已透過原始碼驗證。⁴¹

• 程式碼庫已完成拆分，而外掛程式相容性的倒數期限為9月14日。 2026年9月的拆分作業（PR #102117）將儲存庫中的大型模組拆成各司其職的檔案：新的 agent/ 套件容納對話迴圈的內部實作（共214個頂層模組與7個子套件；prompt_builder.py 現位於 agent/prompt_builder.py，而 run_agent.py 仍是 AIAgent 的所在之處）；CLI 的子命令剖析器移至 hermes_cli/subcommands/ 套件（61個模組）；靜態 CANONICAL_PROVIDERS 清單從 hermes_cli/models.py 移至 hermes_cli/models_catalog_static.py（清單本身並未變更：仍有39個靜態項目，並繼續根據隨附的39個供應商外掛程式目錄自動擴充）；delegate_task 則拆分至約12個 tools/delegate_tool_* 模組。內部匯入路徑並非穩定的 API，因此儲存庫根目錄新增了 COMPAT_MANIFEST.md，從舊模組路徑重新匯出1,148個「延遲搬移」的公開名稱；解析時，每個名稱在每個處理程序中會發出一次 HermesPluginCompatWarning。此相容層原本就是暫時措施，並已依排程於2026年9月14日移除，也就是標籤發布後6天——這並非透過還原程式碼達成，而是由已隨版本發布的程式碼內建日期閘門。自該日起，受影響的第三方外掛程式將不會載入：CLI 橫幅、hermes doctor 與 hermes update 會顯示紅色通知，指出遭停用的外掛程式；桌面版會顯示一次性對話框；hermes plugins list 則會列出原因。若您使用外部外掛程式，請加以檢查：hermes plugins compat <path> 會逐一列出仍使用舊路徑的位置，格式為 file:line 與舊路徑 -> 新路徑；只要仍有任何項目未修正，便會以狀態碼1結束（使用 --json 可取得機器可讀的輸出；不加參數執行則會掃描所有已安裝的外掛程式）。若外掛程式作者尚未跟上變更，可在 config.yaml 中設定 plugins.allow_deprecated_imports: true 作為權宜之計，而且目前依然有效：截至9月22日（已透過標籤 v2026.9.21 與 main 驗證），真正刪除舊匯入路徑的還原變更仍未合併，因此只要載入器獲准繼續執行，舊路徑仍可解析。後續情況詳見上方的 v0.21.2 新功能；外掛程式系統章節則收錄目前狀態的說明方塊。⁴²
• Gateway 對話不再因計時器輪替，任何情況皆不會。 工作階段生命週期文件現已明確載明此約定：「閒置或經過的實際時間永遠不會讓對話輪替。/new 與 /reset 會建立明確邊界；context compression 則會繼續管理冗長的歷史記錄。舊版計時器設定會被忽略。現有的 SessionResetPolicy 資料型別只是無實際作用的相容性資料，並非執行階段原則。」邊界由使用者明確建立；若您透過 hermes claw migrate 延續了 OpenClaw 時期的工作階段重設計時器，這些設定現已成為無作用的資料。請參閱訊息 Gateway。⁴³
• MCP 授權新增裝置代碼流程。 hermes mcp login <name> 新增 --flow {browser,device}：browser 是既有的 PKCE 流程；device 則是符合 RFC 8628 的裝置代碼登入方式，適合不便使用瀏覽器回呼的機器；此旗標會覆寫伺服器的 oauth.flow 設定。此期間也強化了 MCP 授權介面的其他部分：OAuth 工作階段會全程強制執行 profile 擁有權檢查；格式錯誤的 OAuth 中繼資料快取會被忽略，以免伺服器卡死；桌面版則透過用戶端本機回呼轉送 MCP OAuth。此外，-t／--toolsets 現在也會篩選哪些已設定的 MCP 伺服器需要啟動，因此單次執行 hermes -z -t <toolsets> 時，不會冷啟動用不到的伺服器。MCP 整合的命令區塊現已納入 login 與 reauth [--all]；這兩項功能早在此期間之前便已存在，只是先前未在此處記載。⁴⁴
• 委派功能如實處理背景工作。 以下是 delegate_task 的6項可靠性改進，皆直接查閱此標籤版本的委派工具原始碼確認。（1）背景批次預設會以單一完成事件回傳；選擇啟用 delegation.independent_completions 後，呼叫會拆成多個完成單位：具有相同 group 值的任務會合併並一併回報，未分組的任務則會在完成時各自回報。此預設值是刻意設計——原始碼指出，大量逐項任務完成通知會使「未預先因應此情況的協調器支離破碎」。（2）子代理程式結束時會終止其背景處理程序，除非子代理程式使用 process_manage(action="handoff") 將其交接給父代理程式；未交接的殘留處理程序會在結果中列為 orphaned_processes，而從未讀取便已結束的子處理程序則會列為 unread_completions，並附上輸出尾端內容。依原始碼 docstring 所述，此設計的立場是：父代理程式「必須從執行階段得知此事」，而不能只相信子代理程式宣稱「監看程式正在執行」。（3）delegation.fallback_providers 成為真正可用的設定介面：null 會讓未鎖定的子代理程式繼承父代理程式的鏈；[] 會停用後援機制；以供應商、端點或模型鎖定的子代理程式不會使用任何後援，除非此設定明確宣告。（4）子代理程式的後援鏈會經過標準正規化器解析，因此格式錯誤的項目會被捨棄，不致造成啟動失敗。（5）執行單位中途當機時，不再遺失已完成的子代理程式：多子代理程式單位中的每個已完成子代理程式，都會持久記錄在該單位自己的資料列中，並以部分結果保留至復原後的結果。（6）子代理程式絕不繼承1小時的提示詞快取層級：委派的子代理程式會降級為5分鐘層級，因為1小時層級的定價是為暫時離席的真人設計，並非用於短時間大量並行的子代理程式。⁴⁵
• 供應商與模型。 Nous Portal 與 OpenRouter 目錄新增 OpenAI 的 GPT-6 Astra 和 Astra Pro，以及 -fast／-flex 速度層級變體（「價格2倍，priority tier」／「價格0.5倍，flex tier」）。在 ChatGPT／Codex OAuth 路徑上，Astra 受帳號資格限制（只有即時、帳號範圍內的探索結果才能顯示該模型），並新增選擇性啟用的 -900k 選擇器變體，將標示的272K脈絡視窗提高至經即時驗證的約900K；此後綴絕不會在線路上傳送。同時新增的項目還包括：anthropic/claude-fable-5.1、google/gemini-3.7-flash 與 gemini-3.8-flash、qwen/qwen3.8-max-0902 與 qwen3.8-flash，以及 Meta 的 Muse Spark 1.3 系列（1M脈絡，包含貢獻者變體），另有 Meta muse-image 圖像生成供應商外掛程式。Tavily 成為網頁搜尋／擷取後端（TAVILY_API_KEY；透過 hermes tools 選取 Tavily 時可免用金鑰）。受管理的 llama.cpp 執行階段讓本機模型成為一級支援的使用途徑（官方二進位檔、單一受監督的 llama-server，以及從桌面版一鍵設定），而樹外的外部處理程序供應商也取得專屬解析分支。在操作層面，選擇器的遠端目錄現改為每20分鐘重新整理一次（model_catalog.ttl_minutes，預設為20；舊版 ttl_hours 鍵僅在使用者曾明確設定時才會沿用）。⁴⁶
• 桌面版：標註頁面，掌控工作階段。 內建瀏覽器新增註解模式：按一下 Annotate，接著按一下即時頁面中的任一元素（或拖曳選取方框）並輸入備註；儲存的註解會保留為編號圖釘，且不會自行傳送對話回合。完成後，「Add N comments」會將整批內容交給撰寫區，每個圖釘皆附有裁切後的螢幕擷取畫面；每則元素註解還會包含其 CSS 選取器、標記，以及與版面配置相關的計算樣式，讓代理程式能在原始碼中找到該元素，而不必從圖片憑空猜測（在標記離開頁面前，密碼、隱藏值及名稱類似金鑰的屬性都會先經過遮蔽處理）。較大的批次會依頁面區域分組，因此20多則註解會化整為零，成為少數幾項通常會修改不同檔案的工作——這正是能安全將它們分派給並行工作者的關鍵。其他新增項目包括：結構化工作階段控制與工作階段自動化控制、透過拖曳建立工作階段、用於匯入其他程式設計代理程式對話記錄的工作階段匯入檢視、display.resume_last_session（預設為 true：冷啟動時重新開啟上次的聊天或頁面）、首次開啟 Browser 窗格且 browser.use_real_profile 關閉時顯示的同意提示（可選擇啟用該設定）、Capabilities -> Skills 下方內建的選用 skill 目錄與一鍵安裝功能，以及新增的俄文桌面版介面語系（CLI 的17個語系目錄維持不變）。⁴⁷

更新方式維持不變：既有安裝可執行 hermes update，全新安裝則使用 shell 安裝程式。此期間經整理的正式紀錄將由 v0.22.0 補上；上述面向則是此標籤版本中的實際變更。⁴¹

v0.21.0 的新功能（The Pantheon Release）

Hermes Agent v0.21.0（標籤 v2026.8.31，2026年8月31日）是目前的功能版本，也是整個 v0.20.x 彙整系列一直延後至此的精選紀錄：「此版本彙整了 v0.20.1-v0.20.6 基礎架構修補標籤的所有內容——這些版本區間均已完整記錄於此。」其定位延續 Herald：「v0.20.0 讓 Hermes 成為信使——他開口傳訊，也將消息帶給其他代理程式。在 v0.21.0，眾神齊聚。」以下為統計資料原文：「自 v0.20.0 以來：約 5,800 次提交 · 約 2,475 個合併的 PR · 約 5,680 個檔案變更 · 約 869,000 行新增 · 約 135,000 行刪除 · 約 2,100 個議題已關閉 · 760 多位貢獻者」。³⁵

此版本依功能領域編排，以下摘要亦採相同方式。若某項功能變更了本指南的既有章節，相關連結會直接列於該項說明中。

• Bot Mode：內建功能讓您的代理程式形成一個社群。 Bot Mode 從 v0.20.3 版本區間隨附的 hermes-bots 外掛，正式升格為桌面應用程式預設啟用的功能。每個代理程式 profile 都有名稱、可透過隨機化／鎖定控制項調整的確定性頭像，以及共享名冊中的一席之地；您可以建立 Discord 風格的群組聊天，讓多個機器人與您在同一個聊天室交談、從訊息輸入框以 @ 提及任何機器人，並為聊天室設定名稱與圖片。其子功能包括標示來源的代理程式間訊息卡片、傳送端的送達通知、可立即喚醒的優先繪製 hydration、Routines 窗格，以及依應用程式設計系統重新打造的介面。此版本自身的說法是：「過去，『多代理程式』代表的是底層管線；如今，它看起來就像一個坐滿同事的聊天應用程式。」³⁵
• hermes peer：代理程式之間的機器人私訊。 任何 Hermes 代理程式都能透過代號向其他代理程式傳送訊息，橫跨不同 profile 與 gateway，既可從 CLI 操作，也可直接在對話中進行——例如，請研究機器人將調查結果交給程式開發機器人，再於目前所在位置讀取回覆。「回覆會進入各代理程式的標準 Bot Chat，因此代理程式之間的對話可長久保存並接受檢視，而非傳送後即拋諸腦後。」hermes peer 指令（新增／列出／移除 peer，以及 dm）已收錄於頂層指令表格。³⁵
• 記得住的 cron 工作。 排程工作不再轉眼即忘：cron 代理程式會像其他代理程式一樣載入並更新持久記憶；continuity=true 會將每次執行的輸出帶入下一次執行，讓監控程式可依先前回報的內容去除重複項目；每項工作都有可長久保存的記事本暫存區；若沒有任何變更，監控模式工作會完全略過 LLM；每項工作均可固定推理強度；cron 輸出也能傳送至機器人的標準 Bot Chat，並由該機器人實際回應。排程任務（Cron）章節現已記錄各項功能在此標籤版本中的運作機制。³⁵³⁷
• 即時子代理程式協作調度。 delegate_task 新增控制操作：列出執行中的子代理程式、在執行途中調整其方向，或提前停止並保留部分結果。子代理程式的輸出可依 JSON schema 驗證，結果中也會顯示每次委派的成本；預設值則提高至每個子代理程式 250 次迭代及 10 個並行子代理程式（這是 v0.19.0 中取代 max_async_children 的統一上限）。³⁵³⁸
• MCP 指揮中心。 MCP 伺服器與目錄整合至同一個桌面頁面，支援拖入式「貼上任何內容」匯入、可在工具呼叫失敗前提醒您重新驗證的背景健康狀態檢查、全體成本／用量浮層（schema token 估算、各伺服器 30 天用量），以及安裝 MCP 伺服器前要求明確確認的 hermes:// 深層連結。請參閱MCP 整合。³⁵
• CLI 功能大躍進。 Ctrl+P 會開啟模糊搜尋指令選單（也可透過 /palette 進入）；/model 選擇器會隨輸入內容篩選；/status 會顯示推理模式、待處理的核准項目與 context 用量；狀態列則可顯示即時快取命中率、延遲與每秒 token 數，且各欄位皆可個別切換。此外，還加入全域緊急停止、工作階段釘選／取消釘選、輪替的訊息輸入框預留文字，以及終端機寵物。命名方面有一點需要注意：版本說明將試執行核准檢查器稱為 hermes approval-check；但在此標籤版本中，實際介面為 hermes approvals test，並不存在 approval-check 子指令。³⁵⁴⁰
• 由代理程式操控桌面版瀏覽器。 應用程式內瀏覽器不再只是代理程式僅能觀看的視窗：Hermes 可以直接導覽、點選並讀取內容，頁面也能彈出至系統瀏覽器，並提供完整的連結內容選單。³⁵
• 6 個新供應商與一波模型目錄更新。 Meta Model API（Muse Spark）、CommandCode、Tencent TokenPlan、Nebius Token Factory、Ramp Router，以及 Actual Computer。其中 3 個（Meta AI、CommandCode、Actual Computer）已在先前的彙整版本區間加入，並已列於完整供應商矩陣；矩陣現再加入 Tencent TokenPlan、Nebius Token Factory 與 Ramp Router，以及文件中新列出的 Alibaba Token Plan SKU。模型目錄新增 GLM-5.3-Flash、qwen3.8-max/flash、Gemini 3.7 Flash、MiniMax M3 free、Nemotron 3.5 Lightning，以及 Muse Spark 1.2。同時也帶來 2 項結構性變更：config.yaml 中的 model_overrides 可讓您修補任何模型的 context window 或定價，不必等待新版本；供應商現在也能以透過 entry point 探索的 pip 安裝套件形式提供。統一的選擇防護登錄機制則會在所有選擇器介面上，針對會使用您的資料進行訓練的模型發出警告。³⁵³⁶
• 全面強化安全性。 寫入受保護的代理程式指示檔案（AGENTS.md、skill、記憶儲存區）如今一律需要核准，避免遭提示詞注入的代理程式暗中改寫自身的常駐指令；全面深入的遮蔽處理修補了終端機錯誤、讀取 .env、checkpoint 與 ACP 紀錄中的機密外洩缺口；核准系統新增對 Windows 破壞性指令的辨識；macOS 權限授予可透過穩定的 TCC 簽署身分（hermes desktop --setup-tcc-identity）在更新後繼續保留；Blender 的 MCP 目錄項目與 skill 則因上游遭入侵而移除。若要瞭解此標籤版本的詳細資訊，請參閱安全性強化。³⁵³⁹
• Gateway 日趨成熟。 Slack 新增原生即時卡片（真正的串流回覆，以及可選擇啟用的計畫／任務卡片）與外寄連結預覽抑制；Telegram 新增行內選擇器，可透過 @botname 搜尋所有指令與 skill，繞過 Telegram 的指令選單上限；relay 管道更加成熟（原生外掛初始化、支援草稿串流的即時卡片操作、工作階段跨度分段，以及恢復語音訊息 STT）；gateway 控制 socket 可讓叢集使用端查詢 gateway，也能讓更新程式從容暫停 gateway，不必終止整個處理程序樹；當看門狗觸發時，turn-reaper 還會擷取卡死的工作程序堆疊。³⁵
• 一波 skills 更新。 包括 8 項搶救回來的生產力 skill（document-to-action-items、meeting-action-items、email-inbox-triage、github-issue-to-pr、weekly-review-planning、competitor-news-monitor、product-price-monitor、social-media-content-calendar）、從 HAR 衍生的 API 用戶端（「只需觀察網站一次，之後便可直接呼叫其隱藏的 API，無須瀏覽器」）、publish-site、session-librarian、blocked-page-recovery、merge-reconciler、plan-interrogation，以及建立時提供建議的 SKILL.md linter。³⁵

此版本區間已還原的功能（不會隨版本提供）： Model Council 模式（/council）與 DCP context engine 都曾加入後又遭還原；僅支援 WS 的 gateway 伺服器（#94245）合併後亦遭還原（#96118），因此 FastAPI 仍位於桌面版啟動路徑上——不過，帶有序號戳記的事件重播（#94219）以及透過 WebSocket 實現的無損桌面重新連線，確實已隨版本提供。Electron 已回復至 40.10.2。若社群對 v0.20.x 版本區間的報導曾提及上述任一功能，請注意它們並未包含在此版本中。³⁵

更新方式維持不變：現有安裝可執行 hermes update，全新安裝則使用 shell 安裝程式。下方 Herald 版本之下的彙整子章節，仍會依各個標籤記錄每個版本區間加入的內容。³⁵

v0.20.0 的新功能（The Herald Release）

Hermes Agent v0.20.0（標籤 v2026.8.3，2026年8月3日）是 v0.21.0 整合所有變更前的功能版本；v0.20.1（8月13日）與 v0.20.2（8月16日）則是在其基礎上的穩定化標籤，而 v0.20.3（標籤 v2026.8.16.2，8月17日發布）、v0.20.4（標籤 v2026.8.18，8月18日）、v0.20.5（標籤 v2026.8.19，8月21日發布）及 v0.20.6（標籤 v2026.8.27，8月27日）延續了整合發布的節奏，且各自涵蓋新的功能時段——請參閱下方小節。自 v0.19.0 以來，此時段涵蓋約 3,650 次提交、1,400 個已合併的 PR，以及由 650 多位貢獻者完成的 1,200 個已關閉議題。⁵⁵

有 3 項變更推翻了本指南舊版提供的操作方式。請先閱讀這些內容，再繼續往下：

• 現在必須使用 Node 26。安裝程式固定使用 NODE_VERSION="26"，並以「Node.js … is too old (Hermes requires Node >=26).」拒絕較舊的執行階段。安裝程式、heal 與 upgrade 都會強制執行此要求。請注意，文件網站的安裝頁面仍標示 Node v22——安裝指令碼與版本資訊較新，應以兩者為準。⁵⁵
• pip 與 Homebrew 已停止支援，而非僅標示為不建議使用。原文指出：「brew + pip/PyPI wheel channels retired (shell installer / Docker / Nix are the supported channels).」若目前仍透過 pip 或 brew 安裝，該管道將不再收到新版本。⁵⁵
• 預設的工具呼叫迭代上限已從 90 提高至 500。長時間自主執行不再受人為上限阻礙，下文所有預算壓力門檻也都依照新上限計算。read_file 的預設值同樣從 500 行提高至 2,000 行。⁵⁵

本版本的其他內容：

• 對話語音。支援可隨時插話的串流 TTS，以及裝置端喚醒詞。⁵⁵
• A2A v1.0。提供代理程式對代理程式通訊協定的外掛程式，完成議題 #514 長期以來的功能要求。⁵⁵
• 簽署外送 webhook。hermes webhook 過去僅支援接收；v0.20.0 新增以 HMAC 簽署的外送生命週期 webhook，涵蓋工作階段、回合與工具事件。⁵⁵
• 有據可查的引用。新增具備事實查核模式的 skill。⁵⁵
• 進階使用者 CLI 功能浪潮。!command 可立即執行 shell 指令，無須耗用模型回合；/init 會掃描專案並建立或更新 AGENTS.md；/diff 可從任何介面顯示已暫存、全部或工作階段內的變更；/context 會分析內容視窗的占用來源；/focus 提供精簡輸出檢視，並可復原隱藏的行；Ctrl+S 則可暫存尚未寫完的提示詞。hermes import-agent 能以單一指令遷移 Claude Code 或 Codex CLI 設定。⁵⁵
• 祕密資料介面的新增功能。新增可與各種保險庫搭配的指令輔助祕密資料來源、單一指令權杖輪替及可採取行動的啟動錯誤、Bitwarden 選用式加密緊急存取快取、依各 profile 主目錄限定範圍的保險庫注入金鑰，以及 config.yaml 與 MCP 設定之間的 ${env:VAR} SecretRef 對等支援。下文的 3 路徑驗證模型維持不變。⁵⁵
• 加快暖啟動。hermes -w 的冷啟動時間從約 14 秒縮短至 1.8 秒。⁵⁵
• 桌面版成為正式平台。新增具有版本化卡片與沙箱化即時預覽的產出物、以 Kanban 作為首個桌面外掛程式的 Plugin SDK、快速輸入全域快速鍵、多個 GUI 視窗、SSH 遠端後端模式，以及 RFC 8252 原生登入。⁵⁵

v0.20.3、v0.20.4、v0.20.5 與 v0.20.6 整合版本（8月17日至27日）

v0.20.0 之後，專案採取高頻率的標籤整合發布節奏，而且這些版本不只是穩定化更新。這 4 個版本都以相同方式延後整理版版本資訊——每個版本均表示「full curated release notes for this window will ship with v0.21.0」——如今 v0.21.0 已如期提供：上方的 v0.21.0 新功能是整段期間經整理的完整紀錄（該版本確認這些時段「are fully documented here」）。以下區塊保留各標籤發布當時的紀錄，以呈現每個標籤各自納入的內容；整理版資訊則將這些變更合併敘述。^54233035

v0.20.3（自 v0.20.2 起約 250 次提交、約 125 個 PR）：

• MCP 2.x SDK 遷移，支援 2026-07-28 無狀態通訊協定。Hermes 遷移至目前的 MCP SDK 世代，並支援該通訊協定的無狀態修訂版本。⁵⁴
• Bot Mode 以內建外掛程式形式推出（hermes-bots），其中包含核心隊友通訊協定。⁵⁴
• 新增 CommandCode 供應商外掛程式，納入供應商目錄。⁵⁴
• 用於電腦操作的 Cua Driver 0.20 執行階段契約，並強化子程序 Python 執行階段的所有權管理（隔離 PYTHONHOME/PYTHONPATH）。⁵⁴
• 可靠性：cron 排程器自我修復（EMFILE 復原、過期宣告核對、卡住工作重新啟用）、修正工作階段交接造成的資料遺失、桌面版遠端 gateway 連線自我修復，以及一系列生態系移植項目（外掛程式安裝安全掃描、/worktree、/rollback 保留手動編輯內容、UTF-16 檔案讀取）。⁵⁴

v0.20.4（自 v0.20.3 起約 146 次提交、約 74 個 PR）：

• 桌面版的玻璃介面：霧面玻璃與半透明效果，並提供霧化選擇器及 macOS 預先選取功能。⁵⁴
• 採用分頁的 SESSIONS|BOTS 側邊欄，可分別隱藏或取消隱藏各個機器人；另修正 Bot Mode 群組聊天問題（長時間執行的成員回合、Markdown 算繪、跨機器路由）。⁵⁴
• 安裝 skill 時執行 NVIDIA SkillEvaluator Tier 1 建議性掃描——安裝 skill 時會進行授權條款與安全性檢查。⁵⁴
• 強化 cron 媒體傳送功能（可設定逾時、手動執行附件、顯示錯過的觸發）、修正 SessionDB 事件迴圈執行緒與資源爭用問題、讓 hermes update 如實呈現停放分支的狀態，以及新增 Kanban 原生作業系統通知。⁵⁴

v0.20.5（自 v0.20.4 起約 746 次提交、約 323 個 PR）：

• 無須金鑰的網頁層級：全新安裝後，不需任何 API 金鑰即可使用網頁搜尋——透過 5 家供應商免費輪替，並採用環狀容錯移轉。²³
• 一系列 CLI 細節改善：模糊搜尋 /model 選擇器、Ctrl+P 指令面板，以及資訊更豐富的 /status。²³
• Bot Mode 更臻成熟：群組聊天室討論串、可摺疊的對話摘要、斑點臉孔頭像，以及支援拖放的 PDF／檔案附件。²³
• 機群與 worktree 工具：hermes update 收據、hermes update --plan（版本資訊稱其為「fleet --plan verification」；此旗標屬於 hermes update，而非 fleet 指令。依其剖析器說明，它會「Show the update plan and exit without changing anything」），以及 hermes worktree list/prune。²³²⁷
• Cron 工作新增持久記憶體及各工作獨立的推理強度設定，另加入依 Composio 評估結果打造的執行紀律與執行階段停滯防護、多問題釐清、無須 opencode 的零驗證供應商，以及桌面版效能改善（Bot Mode 優先繪製再載入、兩個算繪器皆採用 React Compiler）。²³

v0.20.6（標籤 v2026.8.27，8月27日——自 v0.20.5 起約 1,313 次提交、約 525 個 PR）：

該版本直接將自身描述為「Patch release. This tag rolls up the ~525 PRs merged since v0.20.5 into a stable tagged release for downstream consumers」，其說明並指出，此時段涵蓋約 1,313 次提交、約 1,557 個檔案（+177,113／−21,682），以及約 525 個已合併的 PR。³⁰說明中的重點項目如下：

• 須經同意才可使用真實 profile 瀏覽——本機瀏覽可使用預設的 Chromium profile；Windows 上則提供須經核准的關閉流程。³⁰
• 桌面版 Browser 擁有獨立的作業系統視窗，另新增受管理的 SSH 遠端更新引擎，以及機群 profile 導覽列。³⁰
• 擴充遠端 MCP 目錄：收錄 50 多個經即時驗證、由供應商託管的伺服器，包括 Cloudflare、Grafana Cloud、Better Stack 與 Railway。³⁰
• 以作業系統鑰匙圈加密已儲存祕密資料的選用功能——不再需要每次啟動時回應 macOS Keychain 提示。³⁰
• 選擇器新增多款模型：GLM-5.3-Flash、免費的 MiniMax M3，以及 MiniMax H3 Max video。³⁰
• 為 web_search／web_extract 提供 TTL 結果快取，以及支援字幹擷取的多查詢 tool_search。³⁰
• Lean-tail 壓縮現在是預設選項——下方的內容壓縮章節記載此標籤版本的設定。³⁰³¹
• 終端機後端改為可插拔架構——請參閱終端機後端。³⁰³²
• 更新程式與機群狀態如實呈現：更新程式會透過控制 socket 暫停 gateway，不再終止整個程序樹；由映像檔或套件管理的安裝則會拒絕不安全的原地更新。³⁰
• Cron 支援持久性事件確認，並提供更清楚的程式碼版本偏差失敗訊息；另新增 Slack 連結展開控制與共用 Docker 容器身分。³⁰

更新方式維持不變：現有安裝可執行 hermes update，全新安裝則使用 shell 安裝程式。⁵⁴²³³⁰

v0.19.0 的新功能（Quicksilver 版本）

Hermes Agent v0.19.0（標籤 v2026.7.20，2026年7月20日）以信使之神自身的速度命名：此版本的核心是直截了當的回應速度，在所有平台上，首次互動從送出到產生第一個 token 的時間縮短約 80%。圍繞這項核心改進，另有終端機帳務管理、密碼管理器祕密來源、預設啟用的智慧核准、可觀察的 subagent，以及不受當機影響的回應傳送機制。自 v0.18.0 以來，這是專案迄今規模最大的更新：約 2,245 次提交、約 1,065 個合併的 PR、約 3,300 個已關閉的問題，以及超過 450 位社群貢獻者。⁵⁶

• 各平台產生第一個 token 的速度均提升約 80%。 在 CLI、gateway、TUI、桌面應用程式與 cron 中，冷啟動的送出→分派時間皆從約 4.3 秒降至約 0.9 秒——Discord 功能偵測已移出關鍵路徑、已知非 Ollama 供應商會略過 Ollama 探測，agent 初始化也移除了阻塞作業。感知延遲亦經過專門改善：推理模型現在預設即時串流其思考過程（display.show_reasoning 為開啟狀態），回應框也改為逐 token 繪製，而非逐行繪製。⁵⁶
• 桌面應用程式與 TUI 的算繪革新。 桌面應用程式歷經約 20 個 PR 的速度全面改造：透過增量區塊詞法分析，串流 Markdown 分割器的 CPU 使用量降至原本的 1/14；審查窗格的差異內容採虛擬化呈現；大型逐字記錄中的工作階段切換更加流暢；側邊欄與工具列也不再於每個 token 重新算繪。TUI 現在會以區塊為單位，增量算繪串流 Markdown。⁵⁶
• pip 與 Homebrew 安裝方式已棄用。 兩種途徑均被標示為「不受支援的舊版」安裝方式，並預定移除。v0.20.0 現已完成移除——brew 與 pip/PyPI wheel 管道已停用，目前支援的管道僅剩 shell 安裝程式、Docker 與 Nix。⁵⁶⁵⁵
• 祕密資料可由密碼管理器提供。 新增可插拔的 SecretSource 介面，可在載入時從 Bitwarden 與 1Password（op:// 參照）擷取祕密資料，並支援同時啟用多個保存庫、確定性的優先順序、衝突警告，以及逐變數的來源追蹤——API 金鑰不必再存放於純文字 .env 中。未來的保存庫供應商可直接透過外掛程式加入。⁵⁶
• 智慧核准現已成為預設值。 當 Hermes 想要執行已標記的命令時，會由獨立的 LLM 審查器進行評估，而非每次都要求您確認——且每項判定僅適用於該筆確切命令。使用者自訂的拒絕規則即使在 YOLO 模式下也會封鎖相符命令；/deny <reason> 會轉達您的拒絕理由，讓 agent 修正方向；重新加入並支援規則鍵的外掛程式 pre_tool_call 核准動作，則可將工具呼叫升級為人工審核。⁵⁶
• 終端機帳務管理：/subscription 與 /topup。 無須離開終端機，即可管理 Nous Portal 方案——查看方案與剩餘額度、準確預覽升級費用或降級生效時間，並可套用及復原變更。桌面應用程式也新增對應的帳務設定分頁。⁵⁶
• 觀察 subagent 工作；完成的答案絕不遺失。 delegate_task 分派會在 subagent 啟動時立即傳回可供 tail -f 追蹤的即時逐字記錄檔案——每個子 agent 各有一份人類可讀的日誌，涵蓋所有工具呼叫、結果與串流回覆。背景委派的完成結果可跨重新啟動持久保存，而最終 gateway 回應會記錄於 state.db 的傳送義務分類帳中；若 gateway 在傳送途中終止，便會於下次啟動時重新傳送。max_async_children 設定選項現已棄用，改由統一的委派並行數上限取代。⁵⁶
• 單一 gateway，多個 profile。 單一多工 gateway 可共用同一個 bot token，並將特定 guild、頻道或討論串路由至不同 profile——各 profile 的設定、skills、記憶與祕密資料完全隔離——並提供 GATEWAY_MULTIPLEX_PROFILES 覆寫選項。路由索引已移至 state.db；sessions.json 現為選用的舊版鏡像。⁵⁶
• 供應商與模型革新。 Fireworks AI 首度成為一級支援項目（提供成本估算，並列於供應商選擇器第 2 位），DeepInfra 與 Upstage Solar 也一併加入。模型目錄新增 GPT-5.6（Sol/Terra/Luna + Pro，完成端對端整合）、grok-4.5（正式發布）、kimi-k3（kimi-k2.x 已停用），以及完整整合的 Claude Sonnet 5。各供應商可使用 enabled: false 旗標，另有 excluded_providers 設定，可從 /model 選擇器與解析流程中移除未使用的供應商。⁵⁶
• 推理強度可分級調整。 所有介面均新增 max 與 ultra 強度層級，並支援設定中的個別模型覆寫、MoA 預設組合中的逐槽位強度（顧問深入思考，綜合器則維持快速）、輔助模型的逐任務強度，以及 CLI 中僅限目前工作階段的 /reasoning。⁵⁶
• CLI 與 MCP 功能擴充。 hermes sessions export 可輸出 Markdown、Quarto、HTML、僅提示詞及 Hugging Face 追蹤格式，並提供可選用的 --redact 清理功能；/model --once 可針對單次互動覆寫模型；斜線 skill 呼叫可堆疊使用（/skill-a /skill-b do XYZ）；--safe-mode 有助於疑難排解；hermes config get/unset 補齊設定管理功能；hermes serve 成為真正的無介面後端；MCP 工具則採用 mcp__server__tool 命名慣例。⁵⁶

若您從 v0.18.x 升級，首先應留意兩項變更：pip 或 Homebrew 安裝現在會顯示不受支援的舊版警告（請遷移至單行安裝程式），而 max_async_children 已棄用，改由統一的委派並行數上限取代。其餘皆為新增功能——最值得升級的理由包括首次互動延遲縮短約 80%、智慧核准，以及讓完成答案不受當機影響的傳送分類帳。

v0.18.0 的新功能（Judgment 版本）

Hermes Agent v0.18.0（標籤 v2026.7.1，2026年7月1日）以「判斷」為名：agent 會驗證自身工作，不再逕行宣稱成功，且整合式推理過程真正可供檢視。此版本也清空了所有 P0/P1 待辦項目——在 12 天內解決約 692 個最高優先等級項目。²²

• Mixture-of-Agents 成為一級模型。 現在可在所有介面中如同其他模型般選用 MoA，且整合式推理過程清楚可見：每個參考模型的完整輸出都會呈現為各自附有標籤的區塊，並即時串流答案——您可以親眼觀察整個模型組合的思考過程，而非只能取得不透明的合併答案。²²
• /goal 的完成契約。 agent 在回報目標完成前，會先執行專案的檢查來驗證自身工作，而非逕行宣稱成功——將判斷力用於自我檢驗。²²
• /learn——透過描述將任何內容轉化為 skill。 只要描述工作流程，即可將其轉化為可重複使用的 skill；產生的 skills 會自動遵循儲存庫的 CONTRIBUTING.md 慣例。²²
• /journey 時間軸。 以視覺方式呈現記憶與 skills 隨時間演變的歷程，支援編輯，桌面應用程式另提供記憶關聯圖。²²
• 背景 subagent 扇出。 可委派多項任務並行執行，且不會阻塞對話——v0.17.0 的單一背景 subagent 現已擴展為完整團隊。²²
• 桌面版 Projects。 提供一級支援的程式開發 Projects，採用 project/repo/lane 組織模型。²²
• 可縮減至零的 gateway。 Gateway 可在閒置時進入休眠，並協調流量排空以實現無縫部署——對於將 Hermes 作為常駐服務執行的使用者而言，意義重大。²²
• 支援 Google Vertex AI。 可透過 GCP 服務帳戶存取 Gemini，並自動重新整理 OAuth2 token，正式加入供應商目錄。²²
• /prompt 編輯器命令。 開啟 $EDITOR 以撰寫多行提示詞，不必再受限於單行輸入欄位。²²

若您從 v0.17.x 升級，此版本不會破壞 CLI。最值得升級的理由包括完成契約（可自我驗證的目標）、具備可檢視模型組合的一級 MoA，以及用於擷取 skill 的 /learn。

v0.17.0 的新功能（The Reach Release）

Hermes Agent v0.17.0（標籤 v2026.6.19，2026年6月19日）以代理如今延伸的廣度命名——新增訊息管道、模型供應商，以及更深入的桌面與儀表板控制。此版本在 v0.16.x 基礎上增添功能；CLI 介面維持不變。²¹

• 新增訊息管道。 iMessage 現在可透過 Photon Spectrum，在不使用 Mac 中繼站的情況下運作（裝置代碼 OAuth、hermes photon login）；WhatsApp Business Cloud API 是 Meta 官方轉接器，不再需要橋接處理程序；SimpleX 新增群組、原生附件、文字批次處理及自動接受功能；Raft 則以內建平台外掛程式之姿加入，採用依契約保障隱私的喚醒管道設計。²¹
• 新增模型與供應商。 目錄新增 z-ai/glm-5.2（1M context）、anthropic/claude-fable-5、laguna-m.1、nemotron-3-ultra 及 grok-composer-2.5-fast（透過 xAI OAuth 使用 Cursor 的模型，200k context）。xAI 的預設模型已改為 grok-build-0.1，而 Anthropic 自適應模型如今遵循現代思考契約（絕不傳送 reasoning 欄位）。²¹
• 桌面與儀表板。 桌面版新增背景子代理，並以即時「監看視窗」串流顯示委派活動（delegate_task(background=true)）、Composer 模型選擇器、可重新綁定的鍵盤快速鍵、原生作業系統通知、各討論串獨立的 Composer 草稿、VS Code Marketplace 主題，以及日文與繁體中文介面。儀表板新增完整的 profile 建立工具（無須編輯 config.yaml，即可設定模型、skills 與 MCPs）、全域 profile 切換器、重新設計並具備安全性掃描的 Skills Hub、Automation Blueprints（涵蓋表單、斜線指令、對話與文件的參數化範本），以及通過 OAuth 閘道後會回傳 401 的安全登入機制。²¹
• Skills 與工具。 image_generate 現在可在所有支援的影像供應商上編輯與轉換來源影像，不再只能從零建立影像；memory 工具新增 operations 陣列，可在單次呼叫中以不可分割的方式批次新增、取代及移除內容；新的 simplify-code skill 會平行執行由三個代理組成的審查與清理流程，並以 Chesterton’s-Fence 風險層級把關；布林值 write_approval 則取代三態的 write_mode。²¹
• 架構。 背景子代理會立即回傳控制代碼，並將結果作為新回合重新送入；MCP 引導處理常式支援在工具呼叫途中要求確認，而延遲連線的 MCP 工具會在回合之間公開（可安全快取）；cron 改為可插拔的 CronScheduler，並提供 Chronos 代管 cron 供應商；新的 Managed scope（/etc/hermes）讓管理員固定使用者無法變更的設定，另加入 Gateway-Gateway 中繼功能，以支援多 gateway 拓撲。²¹
• 新增指令。 /version、/billing（互動式終端機計費）、hermes photon login（iMessage 驗證），以及 hermes curator run --consolidate——整併現在改為選用功能，因此例行背景整理不會耗用任何 token。²¹
• 安全性。 v0.17.0 修補了 shell 跳脫字元繞過拒絕清單的漏洞；缺少核准模組或自有原則 gateway 轉接器時，系統會以安全方式拒絕運作；針對 cron 工作指令碼的子處理程序清理環境；在請求偵錯傾印中遮蔽機密資訊；檢查 MCP stdio 設定是否包含資料外洩模式；並升級 urllib3 與 PyJWT 以修補 CVE。²¹

若您從 v0.16.x 升級，這些變更都不會破壞 CLI；它們只是在相同代理周圍新增管道、模型與操作介面。無須中繼站的 iMessage、WhatsApp 官方轉接器，以及供管理員使用的 Managed scope，是此次升級最值得關注的重點。

v0.16.0 的新功能（The Surface Release）

Hermes Agent v0.16.0（標籤 v2026.6.5，2026年6月5日）以它為以 CLI 為優先的代理所帶來的新操作介面命名。最大亮點是 Hermes 不再僅限於終端機。²⁰

• 原生桌面應用程式。 Hermes Desktop 是適用於 macOS、Linux 與 Windows 的全新 Electron 應用程式，支援一鍵安裝及應用程式內自動更新。它提供串流聊天視窗、拖放檔案、從剪貼簿貼上影像、Cmd+K 功能面板、可封存與搜尋的工作階段清單，以及狀態列模型選擇器。應用程式可透過安全的 WebSocket 連線至遠端 Hermes gateway，並使用 OAuth 或使用者名稱與密碼進行驗證；每個 profile 均可設定不同的遠端主機，還能透過跨 profile 的 @session 參照，同時執行多個 profile 工作階段。桌面介面也透過型別化 i18n 層（display.language）提供完整的簡體中文（简体中文）翻譯；英文仍為預設語言。²⁰
• 瀏覽器管理面板。 本機網頁儀表板已從狀態檢視頁面蛻變為完整的管理面板：提供具啟用／停用切換功能的 MCP 目錄、憑證管理、webhook 與 hook 建立功能、記憶設定、gateway 控制項，以及具備更新前檢查與一鍵 Debug Share 的系統頁面。新的 Channels 頁面可從瀏覽器設定所有 gateway 訊息平台（Telegram、Discord、Slack 等）。驗證方式現在可自由插拔：支援使用者名稱與密碼登入、通用的自行託管 OIDC 供應商、使用 hermes dashboard register 註冊自行託管的 OAuth 用戶端，以及更新權杖工作階段輪替。²⁰
• 新增 CLI 與斜線指令。 /undo [N] 會搭配預填內容與軟刪除，回復最近 N 個使用者回合，並適用於 CLI、TUI 及各個訊息平台。現在可設定預設介面（cli 或 tui），並使用 --cli 覆寫；TUI 新增統一的 /model 指令與 Sessions 浮動視窗。hermes portal 是 Nous Portal 新手引導流程中便於閱讀的別名，首次執行時新增 Quick Setup 與 Full Setup 兩種路徑，並加入 hermes prompt-size 和 hermes sessions optimize 兩項診斷功能。²⁰
• 新增模型與供應商。 選擇器新增 deepseek-v4-flash、MiniMax-M3（1M context、原生 MiniMax 供應商）、qwen3.7-plus（Nous + OpenRouter）與 gemini-3.5-flash（Gemini OAuth + API key）。桌面啟動器新增一級支援的 xAI Grok OAuth 供應商；模型選擇器在所有操作介面均支援模糊搜尋；多端點供應商會歸入同一列；目錄重新整理頻率則從每日改為每小時一次。²⁰（v0.21.1 後來再次調整頻率：選擇器的遠端目錄現在每 20 分鐘重新整理一次，即 model_catalog.ttl_minutes。⁴⁶）
• 更精簡的 skills 與漸進式揭露。 預設 skill 集合已移除重複及失效的 skills（Spotify 改為原生外掛程式，Linear 改用 hermes mcp install linear，並移除數個過時項目），將更多 skills 改為選用，另新增 environments: frontmatter 關聯性閘道（kanban／docker／s6），讓特定情境的 skills 在被要求使用前不會出現在索引中。除了 OpenAI、Anthropic 與 HuggingFace，NVIDIA/skills 現在也是預設受信任的 Skills Hub tap。MCP 與外掛程式工具新增漸進式（限縮範圍的）工具揭露功能，並修正一項 MCP 錯誤：未取得 token 時，系統先前會誤報 OAuth 成功。²⁰
• 安全性。 v0.16.0 鎖定已修補的 Starlette（≥1.0.1），以因應 CVE-2026-48710（BadHost）；在非同步路徑中將 SSRF URL 檢查移出事件迴圈；從子處理程序環境中移除 Bedrock 推論 bearer token；將 bws_cache.json 納入檔案安全讀取防護；將 docker restart/stop/kill 加入危險模式清單；並清理經審核 skill 內容中的不可見 Unicode 字元。此版本解決了 2 項 P0 與 62 項 P1 問題，其中 16 項標記為安全性問題。²⁰

若您從 v0.15.x 升級，這些變更都不會對 CLI 本身造成破壞性影響；它們是在相同代理周圍加入新的操作介面與供應商。若要讓不使用終端機的使用者操作 Hermes，或從瀏覽器管理遠端 gateway，桌面應用程式與管理面板便是升級的主要理由。

v0.14.0 的新功能（The Foundation Release）

v0.14.0 並非聚焦於單一主打功能，而是著重於降低設定阻力，同時拓展 Hermes 的執行環境。¹⁹ 主要操作變更如下：

• 安裝與啟動更輕量。 可透過 PyPI 執行 pip install hermes-agent，重量級轉接器會在首次使用時才延遲安裝，而啟動路徑會延後足夠多的工作，將冷啟動時間縮短約 19 秒。（v0.19.0 後已棄用 pip 安裝方式——請參閱安裝。）
• 訂閱可轉為本機 API 端點。 hermes proxy 可將由 OAuth 支援的供應商（例如 Claude Pro、ChatGPT Pro 與 SuperGrok）轉換為與 OpenAI 相容的本機端點，供 Codex、Aider、Cline 和 Continue 等工具使用。
• Gateway 觸及範圍擴大。 LINE 與 SimpleX Chat 加入 gateway（文件中的平台比較表在標籤 v2026.8.31 列出 28 個平台；Messaging Gateway一節說明此數字的計算範圍）；Microsoft Teams 已完成端對端串接；Discord 預設會回填歷史記錄；Telegram／Discord 的 clarify 提示現在則使用原生按鈕。
• 寫入時驗證有所改善。 編輯完成後，Hermes 可在下一個回合前顯示每回合的檔案變動摘要，以及語言伺服器的語意診斷結果，使其更接近以證據為本的代理工作方式。
• 桌面與媒體工具涵蓋範圍更廣。 computer_use 可透過 cua-driver 搭配非 Anthropic 供應商運作；video_generate 統一由可插拔的後端提供；vision_analyze 則會將原始像素傳送給真正具備視覺能力的模型。

安裝

官方支援的安裝方式是單行安裝程式。它會處理Python、uv、Node.js、ripgrep、ffmpeg、複製儲存庫、虛擬環境，以及全域hermes命令。⁷

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

自v0.19.0起，已棄用pip與Homebrew安裝方式。 v0.14.0推出的PyPI套件（pip install hermes-agent）與Homebrew公式，如今均標示為「不受支援的舊版」安裝方式。Hermes偵測到其中任一方式時，會在各個介面發出警告（但不會阻止執行），並計畫停止透過PyPI/Homebrew發布。若您先前透過pip或brew安裝，請改用上述安裝程式。⁵⁶

支援Linux、macOS、WSL2與Android/Termux（安裝程式會自動偵測Termux，並改用經過測試的Android套件組合）。⁷ 原生Windows現已是Tier 1平台，不再是v0.14.0推出時的早期測試版；請使用iex (irm https://hermes-agent.nousresearch.com/install.ps1)安裝。文件明確指出一項限制：macOS僅支援Apple Silicon，不支援Intel Mac。⁵⁵ 過去，v0.14.0曾透過PowerShell安裝程式加入早期測試版的原生Windows支援；但在Windows安裝方式更加成熟之前，若用於正式環境，WSL2仍是較穩妥的選擇。¹⁹

完成後：

source ~/.bashrc    # or ~/.zshrc
hermes              # Start chatting

唯一的必要條件是git。安裝程式會透過uv自動佈建Python 3.11（不需要sudo）、Node.js 26（用於瀏覽器自動化與WhatsApp橋接器）、ripgrep及ffmpeg。自v0.20.0起，Node 26是不可逾越的最低版本要求；安裝程式會拒絕任何更舊的版本，並改為安裝由Hermes管理的Node。⁵⁵⁷

驗證安裝

hermes --version    # Check version (global flag; there is no `version` subcommand)
hermes doctor       # Diagnose config/dependency issues
hermes status       # Show current configuration + auth state
hermes dump         # Copy-pasteable setup summary for debugging

hermes doctor會精確指出缺少哪些項目，以及修正方式。⁷ 尋求協助時，可使用hermes dump產生診斷資訊，貼到GitHub issue或Discord討論串中。它會以純文字摘要呈現您的完整設定，並遮蔽機密資訊。⁸

手動安裝

若您需要完整控制，例如自訂Python版本、指定extras，或整合Nix/NixOS，上游安裝指南提供了逐步說明。⁷ 以下是可搭配uv pip install -e ".[<extras>]"使用的主要選用extras：

Termux的安裝命令有所不同——它使用帶有約束檔案的pip，而非uv pip：

python -m pip install -e ".[termux]" -c constraints-termux.txt

這是因為Android上的.[all]會透過voice extra引入faster-whisper，而後者依賴尚未針對Android發布的ctranslate2 wheel套件。⁷

驗證與提供者

在標籤v2026.9.7中，hermes_cli/models_catalog_static.py第311行包含39筆靜態CANONICAL_PROVIDERS項目（2026年9月的拆分作業將此清單從hermes_cli/models.py移出；項目本身維持不變，並包含v0.21.0的tencent-tokenplan），並會從plugins/model-providers/自動擴充該清單（內含39個隨附目錄；其中9個——actual、alibaba-coding-plan、commandcode、deepinfra、meta-ai、nebius-token-factory、opencode-free、router、upstage——沒有靜態項目，因採用預設的api_key驗證類型而由自動擴充機制納入）。文件的提供者頁面以表格列出45個雲端與訂閱制提供者，另有一列自訂端點；也分別介紹本機及自行託管的伺服器（Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM、ClawRouter，以及任何與OpenAI相容的端點）。²⁶ 在標籤v2026.9.24中，靜態清單仍有39筆項目，但plugins/model-providers/只剩38個目錄：無須金鑰的opencode-free提供者已於9月18日移除，因為OpenCode的免費方案如今會拒絕來自其自有用戶端以外的匿名流量。⁵³ 此外，還有自訂端點與3條不同的驗證路徑。以下依路徑整理完整的驗證介面，方便您找到符合現有條件的方式。

3條驗證路徑

Hermes中的每個提供者都屬於以下3種驗證模式之一：

路徑1——.env中的API金鑰。 將金鑰放入~/.hermes/.env，Hermes會在啟動時讀取。適用於OpenRouter、AI Gateway、z.ai/GLM、Kimi/Moonshot、MiniMax（含MiniMax China）、Alibaba Cloud/DashScope、Kilo Code、OpenCode Zen、OpenCode Go、DeepSeek、Hugging Face、Google/Gemini，以及大多數第三方提供者。² 自v0.19.0起，金鑰不再必須存放於純文字檔案中：可插拔的SecretSource介面能在載入時從Bitwarden或1Password（op://參照）擷取祕密，並支援同時啟用多個密碼庫、確定性的優先順序、衝突警告，以及逐一變數的來源資訊——.env仍作為備援。（這不同於v0.15.0的Bitwarden Secrets Manager啟動權杖；後者以單一權杖集中管理提供者金鑰。SecretSource則直接取代純文字檔案，未來的密碼庫提供者也能以外掛形式加入。）⁵⁶

路徑2——透過hermes model或hermes auth使用OAuth。 此方式會啟動裝置代碼流程、開啟瀏覽器，並將憑證儲存至~/.hermes/auth.json（也能從Claude Code或Codex CLI等工具匯入既有憑證）。適用於Nous Portal、OpenAI Codex（ChatGPT帳號）、GitHub Copilot，以及Anthropic（Claude Pro/Max）。²

路徑3——config.yaml中的自訂端點。 適用於任何與OpenAI相容的API——Ollama、vLLM、SGLang、llama.cpp、LM Studio、LiteLLM proxy、Together AI、Groq、Azure OpenAI，或您自行託管的伺服器。只需透過hermes model → Custom endpoint設定一次，之後便會保存至config.yaml。²

完整提供者矩陣

此矩陣涵蓋文件頁面表格中列出的提供者，並附上各自確切的設定流程；該標籤中的選擇器所列項目比文件更多（請參閱上述數量），而任何與OpenAI相容的服務都能透過自訂端點列接入。²²⁶

Anthropic：3 種驗證方式

Anthropic 值得獨立說明，因為 Hermes 支援 3 種不同的 Claude 存取方式，選對方式至關重要。根據上游文件：²

# Method 1: API key (pay-per-token)
export ANTHROPIC_API_KEY=***
hermes chat --provider anthropic --model claude-sonnet-4-6

# Method 2: OAuth through hermes model (preferred)
# Uses Claude Code's credential store when available
hermes model

# Method 3: Manual setup-token (fallback/legacy)
export ANTHROPIC_TOKEN=***
hermes chat --provider anthropic

# Auto-detect Claude Code credentials
hermes chat --provider anthropic   # reads Claude Code files automatically

透過 hermes model 選擇 Anthropic OAuth 時，Hermes 會優先使用 Claude Code 本身的憑證儲存區，而不是將 token 複製到 ~/.hermes/.env。如此一來，具備重新整理能力的 Claude 憑證仍可持續重新整理。² 若您已在同一台機器上使用 Claude Code，這是最簡潔的方式。

若要在 config.yaml 中永久指定 Anthropic：

model:
  provider: "anthropic"
  default: "claude-sonnet-4-6"

--provider claude 與 --provider claude-code 也可作為 --provider anthropic 的簡寫。²

GitHub Copilot：2 種模式

Copilot 支援 2 種模式：直接使用 Copilot API（建議），以及 Copilot ACP（將本機 Copilot CLI 作為子程序啟動）。²

# Direct Copilot API
hermes chat --provider copilot --model gpt-5.4

# Copilot ACP (requires the Copilot CLI in PATH + an existing copilot login)
hermes chat --provider copilot-acp --model copilot-acp

根據上游文件，驗證會依下列順序檢查：² 1. COPILOT_GITHUB_TOKEN 環境變數 2. GH_TOKEN 環境變數 3. GITHUB_TOKEN 環境變數 4. gh auth token CLI 備援方式 5. 透過 hermes model 使用 OAuth 裝置代碼登入

Token 類型很重要。Copilot API 不支援傳統的 Personal Access Token（ghp_*）。支援的類型包括 OAuth token（gho_*）、細粒度 PAT（github_pat_*，須具備 Copilot Requests 權限），以及 GitHub App token（ghu_*）。若 gh auth token 傳回 ghp_* token，請改用 hermes model，透過 OAuth 進行驗證。²

中國 AI Provider（第一級支援）

Hermes 內建支援 z.ai/GLM、Kimi/Moonshot、MiniMax（全球與中國端點），以及具備專用 provider ID 的 Alibaba Cloud。²

# z.ai / ZhipuAI GLM
hermes chat --provider zai --model glm-5                 # Requires: GLM_API_KEY

# Kimi / Moonshot AI
hermes chat --provider kimi-coding --model kimi-for-coding   # Requires: KIMI_API_KEY

# MiniMax (global)
hermes chat --provider minimax --model MiniMax-M2.7          # Requires: MINIMAX_API_KEY

# MiniMax (China)
hermes chat --provider minimax-cn --model MiniMax-M2.7       # Requires: MINIMAX_CN_API_KEY

# Alibaba Cloud / DashScope (Qwen)
hermes chat --provider alibaba --model qwen3.5-plus          # Requires: DASHSCOPE_API_KEY

您可以使用 GLM_BASE_URL、KIMI_BASE_URL、MINIMAX_BASE_URL、MINIMAX_CN_BASE_URL 或 DASHSCOPE_BASE_URL 環境變數覆寫基礎 URL。²

Z.AI 會自動偵測端點。使用 z.ai/GLM provider 時，Hermes 會探測多個端點（全球、中國及 coding 變體），找出可接受您 API 金鑰的端點。可用端點會自動快取——多數使用者無須設定 GLM_BASE_URL。²

xAI（Grok）會自動啟用提示快取。當基礎 URL 包含 x.ai 時，Hermes 會在每個請求中傳送 x-grok-conv-id 標頭，讓同一個對話工作階段持續路由至相同伺服器，從而重複使用已快取的系統提示與歷程記錄。² 此功能全自動運作，無須設定。

hermes auth 指令

hermes auth 是用於管理憑證池與 OAuth 憑證的指令。⁶

hermes auth                              # Interactive wizard
hermes auth list                         # Show all credential pools
hermes auth list openrouter              # Show one provider's pool
hermes auth add openrouter --api-key sk-or-v1-xxx
hermes auth add anthropic --type oauth
hermes auth remove openrouter 2          # Remove by index
hermes auth reset openrouter             # Clear cooldowns

憑證池可輪替同一 provider 的多組 API 金鑰或 OAuth token——不必修改程式碼，即可將速率限制分散至多組金鑰，十分實用。⁶ 舊版的 hermes login／hermes logout 指令已移除；請改用 hermes auth。⁶

自訂與自行託管的端點

Hermes 可搭配任何與 OpenAI 相容的 API 端點使用。只要伺服器實作 /v1/chat/completions，即可讓 Hermes 連線。²

互動式設定（建議）：

hermes model
# Select "Custom endpoint (self-hosted / VLLM / etc.)"
# Enter: API base URL, API key, Model name

手動設定 config.yaml：

model:
  default: your-model-name
  provider: custom
  base_url: http://localhost:8000/v1
  api_key: your-key-or-leave-empty-for-local

這兩種方式都會將設定持久儲存至 config.yaml；它是主模型、provider 與基礎 URL 的唯一資訊來源。² 舊版環境變數 OPENAI_BASE_URL 與 LLM_MODEL 已不再用於讀取主模型設定——請使用 hermes model，或直接編輯 config.yaml。²（OPENAI_BASE_URL 與 OPENAI_API_KEY 仍會作為輔助 provider: "main" 路由路徑的備援設定；若您正在該處使用這些變數，請勿貿然刪除。）⁴

在工作階段中途切換自訂端點：

/model custom:qwen-2.5             # Custom endpoint with explicit model
/model custom                      # Auto-detect the model from the endpoint
/model custom:local:qwen-2.5       # Named custom provider "local"
/model custom:work:llama3          # Named custom provider "work"
/model openrouter:claude-sonnet-4  # Back to a cloud provider

/model custom（不加任何模型名稱）會查詢端點的 /v1/models API；若只載入了1個模型，便會自動選取。這對僅執行單一模型的本機伺服器相當實用。²

本機 LLM 伺服器（設定範本）

上游文件提供 Ollama、vLLM、SGLang、llama.cpp 與 LM Studio 的完整設定指南。以下是實際會用到的關鍵命令。每種設定都能建立可供 Hermes 連線的運作中端點。²

Ollama — 最簡便的本機方案，無須設定：

ollama pull qwen2.5-coder:32b
OLLAMA_CONTEXT_LENGTH=32768 ollama serve   # Raise from 4k default
hermes model   # Custom endpoint → http://localhost:11434/v1 → qwen2.5-coder:32b

Ollama 的重大陷阱：Ollama 預設的 context 長度非常低（VRAM 不足24GB時為4,096個 token）。您必須透過 OLLAMA_CONTEXT_LENGTH 或 Modelfile 提高長度。OpenAI 相容的 API 不會接受用戶端傳入的 context 長度，因此 Hermes 無法代為設定。²若要供 agent 使用，至少應設為16k–32k。

vLLM — 高效能 GPU 推論服務：

pip install vllm
vllm serve meta-llama/Llama-3.1-70B-Instruct \
  --port 8000 \
  --max-model-len 65536 \
  --tensor-parallel-size 2 \
  --enable-auto-tool-choice \
  --tool-call-parser hermes

如需呼叫 tool，必須使用 --enable-auto-tool-choice 與 --tool-call-parser <name>。支援的 parser 包括：hermes（Qwen 2.5、Hermes 2/3）、llama3_json、mistral、deepseek_v3、deepseek_v31、xlam、pythonic。若未加入這些 flag，tool call 只會以純文字形式傳回。²

SGLang — 運用 RadixAttention 重複使用 KV cache 的高速推論服務：

pip install "sglang[all]"
python -m sglang.launch_server \
  --model meta-llama/Llama-3.1-70B-Instruct \
  --port 30000 \
  --context-length 65536 \
  --tp 2 \
  --tool-call-parser qwen

SGLang 的陷阱：預設 max_tokens 為128。若回應遭到截斷，請在伺服器上設定 --default-max-tokens，或於 config.yaml 中設定 model.max_tokens。²

llama.cpp / llama-server — 適用於 CPU 與 Apple Silicon Metal：

./build/bin/llama-server \
  --jinja -fa \
  -c 32768 \
  -ngl 99 \
  -m models/qwen2.5-coder-32b-instruct-Q4_K_M.gguf \
  --port 8080 --host 0.0.0.0

呼叫 tool 時必須使用 --jinja。若未加入，llama-server 會完全忽略 tools 參數，模型則會嘗試在回應文字中寫入 JSON 來呼叫 tool，但 Hermes 無法將其解析為真正的 tool call。²

LM Studio — 具備 GUI 的桌面應用程式：

從 LM Studio 應用程式啟動伺服器（Developer 分頁 → Start Server），或透過 CLI 執行：lms server start（在 port 1234 上啟動）及 lms load qwen2.5-coder --context-length 32768。²接著讓 hermes model 指向 http://localhost:1234/v1。

LM Studio 的重大陷阱：LM Studio 會從模型 metadata 讀取 context 長度，但許多 GGUF 模型回報的預設值是2048或4096。務必在 LM Studio 的模型設定中明確指定 context 長度：按一下模型選擇器旁的齒輪圖示，將「Context Length」設為至少16384（建議32768），再重新載入模型。²

具名自訂 provider

若您使用多個自訂端點（例如本機開發伺服器與遠端 GPU 伺服器），請在 config.yaml 中將其定義為具名自訂 provider：²

custom_providers:
  - name: local
    base_url: http://localhost:8080/v1
    # api_key omitted — Hermes uses "no-key-required" for keyless local servers
  - name: work
    base_url: https://gpu-server.internal.corp/v1
    api_key: corp-api-key
    api_mode: chat_completions      # optional, auto-detected from URL
  - name: anthropic-proxy
    base_url: https://proxy.example.com/anthropic
    api_key: proxy-key
    api_mode: anthropic_messages    # for Anthropic-compatible proxies

接著便能在 session 進行期間使用三段式語法切換：

/model custom:local:qwen-2.5
/model custom:work:llama3-70b
/model custom:anthropic-proxy:claude-sonnet-4

您也能從 hermes model 的互動式選單中選取具名自訂 provider。²

可插拔的 provider 架構（v0.13.0+）

v0.13.0 提供 ProviderProfile ABC 與 plugins/model-providers/ 資料夾，讓第三方推論 provider 無須修改核心即可整合。¹⁸若 provider 採用 OpenAI、Anthropic 或 Codex 相容的 API 模式，您可以實作 ProviderProfile 子類別，宣告驗證路徑、base URL、模型目錄與 caching header；Hermes 會透過內建 provider 所使用的同一條 runtime_provider.py 路徑加以解析。這正是 v0.13.0 擴充 provider 的架構變革：新增 provider 不再需要修改核心程式碼，只要發布 plugin 即可。

OpenAI 相容的本機 proxy（v0.14.0+）

hermes proxy 會公開一個 OpenAI 相容的本機端點，其後端採用 Hermes 已登入的 OAuth provider，例如 Claude Pro、ChatGPT Pro、SuperGrok 或其他已設定的相容 provider。¹⁹因此，預期使用 OpenAI 風格 API 的工具，包括 Codex CLI、Aider、Cline、Continue 或自訂 script，都能重複使用 Hermes 以訂閱方案為基礎的驗證，無須另外準備 API key。請將此 proxy 視為本機開發基礎設施：審慎指定綁定位置、切勿廣泛公開，並留意各 provider 的特定條款。

Context 長度偵測

根據上游文件，以下兩項設定經常遭到混淆：²

• context_length — context window 的總長度（輸入與輸出合計的 token 預算，例如 Claude Opus 4.7 為1,000,000，Sonnet 4.6 則為200,000）。Hermes 會據此判斷何時壓縮歷史記錄。
• model.max_tokens — 輸出上限（模型在單次回應中可產生的 token 數量上限），與歷史記錄長度無關。

若自動偵測的 window 大小不正確，請設定 context_length：

model:
  default: "qwen3.5:9b"
  base_url: "http://localhost:8080/v1"
  context_length: 131072      # tokens

Hermes 會透過多來源解析鏈偵測 context window：config override → 自訂 provider 的逐模型設定 → persistent cache → 端點 /models → Anthropic /v1/models → OpenRouter API → Nous Portal → models.dev（由社群維護、涵蓋3800多個模型的 registry）→ fallback 預設值（128K）。²此系統能辨識 provider，因此同一模型會依提供服務者而有不同的 context 上限（例如，claude-opus-4.6 透過 Anthropic 直接提供時為1M，但在 GitHub Copilot 上則為128K）。²

智慧模型路由：provider 輪替與 fallback

Hermes 不會將您限制在單一 provider 的單一模型上。智慧模型路由是一組 用來判定實際由哪個 provider 與模型處理特定 request 的機制：credential pool 會將負載分散至不同 key；primary 發生故障時，由已設定的 fallback 接手； 而下方的 auxiliary slot 則會獨立於 main model，將 side task 路由至成本較低的模型。²⁶請一併設定這三者——這決定了 agent 遇到 rate limit 時是停滯不前，還是能持續運作。

Credential pool。若同一 provider 有多個 API key，請透過 hermes auth 設定輪替策略。如此便能將 rate limit 分散至多個 key。⁶

Fallback model。設定備援 provider:model，當 primary model 發生故障（rate limit、伺服器錯誤或驗證失敗）時，Hermes 便會自動切換：²

fallback_model:
  provider: openrouter            # required
  model: anthropic/claude-sonnet-4  # required
  # base_url: http://localhost:8000/v1    # optional, for custom endpoints
  # api_key_env: MY_CUSTOM_KEY           # optional, env var name

Fallback 會在 session 進行期間切換模型與 provider，同時保留對話內容。每個 session 最多只會觸發一次。²支援 fallback 的 provider：openrouter、nous、openai-codex、copilot、copilot-acp、anthropic、huggingface、zai、kimi-coding、minimax、minimax-cn、deepseek、ai-gateway、opencode-zen、opencode-go、kilocode、alibaba、custom。²

Auxiliary model

Hermes 會使用「auxiliary」model 處理 side task：影像分析（vision）、危險命令核准分類、context 壓縮、session title 產生、插入 TTS audio tag、skill matching、MCP tool dispatch，以及 Kanban specifier/decomposer 系列。⁴³⁴依預設（auxiliary.*.provider: "auto"），所有 auxiliary task 都會在 main chat model 上執行——也就是您在 hermes model 中選取的同一組 provider/model。文件明確指出，這項設計取代了舊有的低成本 provider 自動偵測機制：「早期版本會將 aggregator 使用者（OpenRouter、Nous Portal）分流至 provider 端的低成本預設模型。這種行為出人意料……auto 現在會讓所有使用者採用 main model，而 config.yaml 中各 task 的 override 仍會優先套用。」³⁴一開始不需要進行任何設定；取捨在於成本——若使用昂貴的 reasoning model，auxiliary task 會產生可觀費用。因此，成本攸關時，請將個別 task 指向便宜且快速的模型。 有兩項先前的輔助任務已完全不再使用LLM：網頁擷取（「web_extract與瀏覽器快照會以確定性方式截斷過長內容，並儲存完整文字，供read_file分頁讀取——全程不涉及LLM」）以及工作階段搜尋（此單一形式的工具會直接傳回資料庫內容）。其舊有的auxiliary.web_extract.*與auxiliary.session_search.*區塊已從預設設定中移除——現有config.yaml內的殘留值「不會造成影響，且會被忽略」——而該標籤的預設設定也同樣不再包含flush_memories欄位。³⁴

您可以設定每項輔助任務所使用的模型與供應商。每個輔助欄位都採用相同的設定項目：provider、model、base_url（以及api_key、timeout、extra_body和各任務專屬的reasoning_effort）。⁴³⁴

auxiliary:
  vision:                          # vision_analyze + browser screenshots
    provider: "auto"               # "auto" (= main model), "openrouter", "nous", "main", etc.
    model: ""                      # e.g. "openai/gpt-4o", "google/gemini-2.5-flash"
    base_url: ""                   # Custom OpenAI-compatible endpoint
    api_key: ""                    # Falls back to OPENAI_API_KEY
    timeout: 120
    download_timeout: 30
  approval:                        # dangerous-command approval classifier
    provider: "auto"
    model: ""
    timeout: 30
  compression:                     # summarizer -- legacy compression.summary_* keys migrate here (config v17)
    provider: "auto"
    model: ""
    base_url: ""
    timeout: 120
  title_generation:                # auto-generated session titles after the first exchange
    enabled: true                  # set false to disable auto-titles
    provider: "auto"
    model: ""
    language: ""                   # empty follows the conversation; e.g. "English" pins titles to one language
  tts_audio_tags:    { provider: "auto", model: "" }  # Gemini 3.1 TTS hidden audio-tag insertion
  skills_hub:        { provider: "auto", model: "" }  # skill matching and search
  mcp:               { provider: "auto", model: "" }  # MCP tool dispatch
  triage_specifier:  { provider: "auto", model: "" }  # hermes kanban specify: rough one-liner into a concrete spec, promoted to todo
  kanban_decomposer: { provider: "auto", model: "" }  # hermes kanban decompose: triage task into a graph of child tasks routed to specialist profiles
  profile_describer: { provider: "auto", model: "" }  # hermes profile describe --auto: 1-2 sentence profile descriptions

其他專門用途的欄位也採用相同結構——goal_judge（判斷是否滿足/goal契約）、curator（用於檢視skill使用情況的分支）、background_review（每輪結束後執行自我改進的分支）、review（/review的審查子代理程式）、moa_reference與moa_aggregator（Mixture-of-Agents）、memory_query_rewrite，以及monitor——而且完全不必手動編輯YAML：執行hermes model，再選取「Configure auxiliary models」，即可透過互動式選擇器逐項設定任務。³⁴

"main"供應商選項表示「使用主代理程式所用的供應商」——此選項僅適用於auxiliary:、compression:與主要備援項目（fallback_providers:或舊版的fallback_model:）。它不適用於頂層的model.provider設定。若主模型使用自訂的OpenAI相容端點，請在model:區段中設定provider: custom。⁴

這一點為何重要：由於auto本來就會沿用主模型，過去「必須設定OpenRouter，否則輔助任務會在未告知的情況下降級」的陷阱已不復存在——如今需要權衡的是成本。若主模型是昂貴的推理模型，建議將頻繁運作的次要任務交由便宜且快速的模型處理：

auxiliary:
  vision:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"
  compression:
    provider: "openrouter"
    model: "google/gemini-2.5-flash"

設定系統

Hermes 採用分層設定系統。理解其優先順序至關重要，因為較高層會覆寫較低層；其中一層是無法在 config.yaml 中看見的全域提供者登錄檔。

設定檔配置

根據上游文件，Hermes 設定由以下檔案組成：⁴

~/.hermes/
├── config.yaml       # All settings (model, terminal, TTS, compression, memory, toolsets, ...)
├── .env              # Secrets (API keys, bot tokens, passwords)
├── auth.json         # OAuth provider credentials (Nous Portal, Codex, Anthropic)
├── SOUL.md           # Primary agent identity (slot #1 in system prompt)
├── memories/         # Persistent memory (MEMORY.md, USER.md)
├── skills/           # Bundled + agent-created + hub-installed skills
├── cron/             # Scheduled jobs
├── sessions/         # Gateway session state
└── logs/             # agent.log, gateway.log, errors.log (secrets auto-redacted)

config.yaml 與 .env——兩者皆有設定時，非機密設定以 config.yaml 為準。⁴規則如下： - 機密資料（API 金鑰、機器人權杖、密碼）→ .env - 其他所有設定（模型、終端機後端、壓縮設定、記憶體限制、toolsets）→ config.yaml

您可以使用 shell 風格的插值語法，在 config.yaml 中參照機密資料：⁴

auxiliary:
  vision:
    api_key: ${GOOGLE_API_KEY}
    base_url: ${CUSTOM_VISION_URL}
  delegation:
    api_key: ${DELEGATION_KEY}

管理設定

hermes config                # View current configuration
hermes config show           # Same as above
hermes config edit           # Open config.yaml in your editor
hermes config set KEY VAL    # Set a specific value
hermes config get KEY        # Print a single value (v0.19.0+)
hermes config unset KEY      # Remove a key so the default applies again (v0.19.0+)
hermes config path           # Print the config file path
hermes config env-path       # Print the .env file path
hermes config check          # Check for missing options (after updates)
hermes config migrate        # Interactively add missing options

範例：⁴

hermes config set model anthropic/claude-opus-4
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...   # Saves to .env

每次執行 hermes update 後，都應執行 hermes config check 與 hermes config migrate。這些命令會找出新加入但設定檔中尚未包含的設定選項。⁶

設定優先順序

Hermes 會從多個來源載入設定。若多個來源設定了相同的值，則以優先順序較高者為準：⁴

1. CLI 引數——hermes chat --model anthropic/claude-sonnet-4（針對單次呼叫覆寫）
2. 環境變數——於程序啟動時套用
3. config.yaml——主要設定檔
4. .env——僅存放機密資料
5. 內建預設值——未由其他來源設定值時套用

CLI 旗標在該次呼叫中一律具有最高優先權。config.yaml 則是長期維護的單一真實來源。

在地化（v0.13.0+）

v0.13.0 為 CLI 與 gateway 訊息新增了 7 種語系：簡體中文、日文、德文、西班牙文、法文、烏克蘭文及土耳其文。¹⁸ v0.14.0 將所有 gateway 命令與網頁儀表板全面在地化，並新增 8 種語系，使總數達到 16 種。¹⁹截至 v2026.8.31 標籤，locales/ 目錄樹包含 17 份訊息目錄——英文加上 16 種翻譯（af、ar、de、es、fr、ga、hu、it、ja、ko、pt、ru、tr、uk、zh-hant、zh）。³³目前文件僅提供 zh-Hans 在地化版本。系統會根據 LC_ALL／LANG 環境變數，或 config.yaml 中明確設定的 locale: 鍵決定語系。英文仍是預設語言，也是翻譯尚未涵蓋之字串的單一真實來源。

Profiles——多個相互隔離的 Hermes 執行個體

Profiles 讓您擁有多個相互隔離的 Hermes 執行個體，每個執行個體都有各自的設定、工作階段、skills、記憶體及 gateway PID。如此便能讓「工作用 Hermes」與「個人用 Hermes」並行運作，且彼此無法存取對方的狀態。⁶

hermes profile list
hermes profile create work --clone                  # Clone from current profile
hermes profile use work                             # Set sticky default
hermes profile alias work --name h-work             # Create wrapper script
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes -p work chat -q "Hello from work profile"    # One-off without switching

每個 profile 都有各自的 HERMES_HOME（預設為 ~/.hermes-<name>/），因此多個 profiles 能同時執行 gateway，互不干擾。⁶³

自 v0.21.2 起，隔離邊界的執行更加嚴謹：一系列修正解決了多工 gateway 設定中確實存在的跨 profile 洩漏問題。先前，次要 profiles 可能會繼承預設 profile 的允許清單、將憑證傳送至其主機、把該 profile 憑證庫中的機密資料交給 stdio MCP 伺服器，或將另一個 profile 的 .env／auth.json／state.db 附加至 MEDIA: 傳送內容（#107609-#107630）。若您採用多工 profiles，從 v0.21.2 標籤開始，隔離承諾才真正落實——請參閱 v0.21.2 的新功能。⁴⁸

CLI 命令

本節是提供給實務工作者參考的頂層CLI命令指南。如需以程式碼為準的權威參考資料，請參閱上游的CLI命令參考。⁶

全域選項

hermes [global-options] <command> [subcommand/options]

頂層命令

hermes chat——主要進入點

不帶引數執行hermes會直接進入互動式聊天。hermes chat則是明確指定的形式，並提供以下選項：⁶

hermes chat -q "Summarize the latest PRs" --oneshot # Answer and exit (without --oneshot, a TTY seeds an interactive session)
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills          # Enable specific toolsets
hermes chat --quiet -q "Return only JSON"           # Programmatic mode
hermes chat --worktree -q "Review repo and open a PR"

主要選項：

hermes setup——完整精靈

執行完整設定精靈，或直接進入其中一個區段：⁶

hermes setup                 # Full wizard
hermes setup model           # Provider and model only
hermes setup terminal        # Terminal backend only
hermes setup gateway         # Messaging platforms only
hermes setup tools           # Tool enable/disable per platform
hermes setup agent           # Agent behavior only
hermes setup --non-interactive
hermes setup --reset         # Reset config to defaults before setup

hermes logs——結構化日誌查詢

hermes logs比直接對日誌檔案執行tail -f更為強大，因為它能同時依層級、session ID及時間範圍進行篩選。⁶

hermes logs                          # Last 50 lines of agent.log
hermes logs -f                       # Follow in real time
hermes logs gateway -n 100           # Last 100 lines of gateway.log
hermes logs --level WARNING --since 1h   # Warnings from the last hour
hermes logs --session abc123         # Filter by session ID substring
hermes logs errors --since 30m -f    # Follow errors.log from 30m ago
hermes logs list                     # List all log files with sizes

日誌檔案位於~/.hermes/logs/：⁶ - agent.log——所有agent活動（API呼叫、tool分派、session生命週期、INFO以上層級） - errors.log——僅包含警告與錯誤（agent.log經篩選後的子集） - gateway.log——訊息gateway活動（平台連線、分派、webhooks）

系統會透過Python的RotatingFileHandler自動輪替——可尋找agent.log.1、agent.log.2等檔案。⁶

hermes doctor——診斷

發生問題時，應優先執行hermes doctor [--fix]。它會檢查設定有效性、相依套件是否存在、API key是否可用及服務狀態，並可透過--fix嘗試自動修復。⁶

若要與他人分享診斷資訊，請使用hermes dump——它會產生精簡的純文字摘要，並遮蔽API keys，可直接貼至GitHub issue或Discord討論串。⁶

Slash 指令

Slash 指令可在使用中的聊天工作階段內執行（CLI或訊息平台）。這些指令由hermes_cli/commands.py中的共用COMMAND_REGISTRY分派，因此大多數指令在不同介面上的運作方式完全相同。⁹

工作階段控制

設定與模型

若要在工作階段進行途中切換 provider，/model是最常用的核心指令：⁹

/model                              # Show current model and options
/model claude-sonnet-4              # Switch model (auto-detect provider)
/model zai:glm-5                    # Switch provider:model
/model custom:qwen-2.5              # Use model on custom endpoint
/model custom                       # Auto-detect model from custom endpoint
/model custom:local:qwen-2.5        # Named custom provider
/model openrouter:anthropic/claude-sonnet-4   # Back to cloud

v0.19.0 新增/model --once——僅套用一輪的模型覆寫；回覆完成後，會自動恢復先前的模型。⁵⁶ 自 v0.20.5 時期起，/model選擇器也支援模糊搜尋，會隨著輸入即時篩選。²³³⁵

工具、Skills 與資訊

動態 Skill Slash 指令

每個已安裝的 skill 都會自動公開為 Slash 指令：⁹

/gif-search funny cats
/axolotl help me fine-tune Llama 3 on my dataset
/github-pr-workflow create a PR for the auth refactor
/excalidraw       # Just the skill name loads it and lets the agent ask what you need

自 v0.19.0 起，Slash skill 呼叫可堆疊：/skill-a /skill-b do XYZ會依序在單一輪次中載入兩個 skill，並為串連的名稱提供自動完成與 ghost text。⁵⁶

您也可以在config.yaml中定義快速指令，將簡短名稱設為較長 prompt 的別名：⁹

quick_commands:
  review: "Review my latest git diff and suggest improvements"
  deploy: "Run the deployment script at scripts/deploy.sh and verify the output"
  morning: "Check my calendar, unread emails, and summarize today's priorities"

接著在CLI中輸入/review、/deploy或/morning即可。

前綴比對

指令支援前綴比對：輸入/h會解析為/help，輸入/mod則會解析為/model。若前綴存在歧義，會採用 registry 註冊順序中的第一個項目。完整指令名稱與已註冊的別名，優先順序一律高於前綴比對。⁹

訊息平台專用指令

部分指令僅適用於訊息平台（Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant）：⁹

• /status——顯示工作階段資訊（已不再僅限訊息平台使用；請參閱工作階段控制）
• /sethome（別名/set-home）——將目前聊天標示為平台首頁
• /approve [session|always]——核准待處理的危險指令
• /deny [reason]——拒絕待處理的危險指令。自 v0.19.0 起，/deny <reason>會將您的拒絕理由傳達給 agent，使其能調整做法，而非毫無頭緒地重試⁵⁶
• /update——將 Hermes Agent 更新至最新版本
• /commands [page]——分頁瀏覽所有指令與 skill

另有部分指令僅限CLI使用：/skin、/tools、/toolsets、/browser、/config、/cron、/skills、/platforms、/paste、/statusbar、/plugins。⁹

Tools 與 Toolsets

Hermes 內建廣泛的工具登錄檔，涵蓋網路搜尋、瀏覽器自動化、終端機執行、檔案編輯、記憶、委派、RL 訓練、訊息傳送、Home Assistant 整合等功能。¹⁰ 工具會整理成邏輯性的 toolset，可依平台啟用或停用。

高階分類

常見的 toolset 名稱包括 web、terminal、file、browser、vision、image_gen、moa、skills、tts、todo、memory、session_search、cronjob、code_execution、delegation、clarify、homeassistant 與 rl。¹⁰

管理工具

hermes chat --toolsets "web,terminal"       # Use specific toolsets
hermes tools                                # Interactive per-platform tool config
hermes tools --summary                      # Print enabled-tools summary

您也能在工作階段進行期間，透過 /tools disable <name> 與 /tools enable <name> 切換工具。這會重設工作階段，讓新的工具組合生效。⁹

終端機後端

終端機工具內建 7 種執行後端；自 v0.20.6 起，此機制也像供應商選擇器一樣可透過外掛擴充（見下文）：¹⁰²⁴

可使用 hermes config set terminal.backend <name> 切換後端，或在 config.yaml 中設定：

terminal:
  backend: docker      # or: local, ssh, singularity, modal, daytona, vercel_sandbox
  cwd: "."             # Working directory
  timeout: 180         # Command timeout in seconds

外掛後端（v0.20.6+）。 第三方沙箱供應商不再需要將程式碼併入核心儲存庫：外掛載入時，會透過 PluginContext.register_terminal_environment_provider 登錄 TerminalEnvironmentProvider，登錄的名稱隨即能像內建後端一樣，透過 terminal.backend 選用。內建名稱均為保留名稱——若供應商名稱與原始碼樹中的後端衝突，登錄檔便會拒絕該供應商。由於核心會在每個分類位置查詢登錄檔，而非使用硬編碼的名稱清單，因此登錄後端會自動整合至所有核心介面與機制，包括 hermes setup 後端選擇器、儀表板探測狀態、hermes doctor 檢查、容器路徑與目前工作目錄處理，以及機密資訊移除。³²

SSH 後端（基於安全考量而建議使用——Agent 無法修改自身程式碼）：¹⁰

terminal:
  backend: ssh

# In ~/.hermes/.env
TERMINAL_SSH_HOST=my-server.example.com
TERMINAL_SSH_USER=myuser
TERMINAL_SSH_KEY=~/.ssh/id_rsa

Docker 後端：

terminal:
  backend: docker
  docker_image: python:3.11-slim

容器資源（適用於 docker、singularity、modal、daytona）：¹⁰

terminal:
  container_cpu: 1
  container_memory: 5120          # MB (default 5GB)
  container_disk: 51200           # MB (default 50GB)
  container_persistent: true      # Persist filesystem across sessions

設定 container_persistent: true 後，已安裝的套件、檔案與設定會跨工作階段保留。¹⁰

所有容器後端都採用安全強化措施：唯讀根檔案系統（Docker）、捨棄除 DAC_OVERRIDE、CHOWN 與 FOWNER 以外的所有 Linux 權能、禁止提升權限、PID 上限（256 個處理程序）、完整的命名空間隔離，以及透過磁碟區建立持久化工作區。¹⁰

背景處理程序

終端機工具支援背景執行，並提供明確的處理程序管理功能：¹⁰

terminal(command="pytest -v tests/", background=true)
# Returns: {"session_id": "proc_abc123", "pid": 12345}

process(action="list")                            # Show all running processes
process(action="poll", session_id="proc_abc123")  # Check status
process(action="wait", session_id="proc_abc123")  # Block until done
process(action="log", session_id="proc_abc123")   # Full output
process(action="kill", session_id="proc_abc123")  # Terminate
process(action="write", session_id="proc_abc123", data="y")  # Send input

PTY 模式（pty=true）可支援 Codex 與 Claude Code 等互動式 CLI tools。¹⁰

Sudo

若命令需要 sudo，Hermes 會提示您輸入密碼，並於該工作階段快取密碼。也可以在 ~/.hermes/.env 中設定 SUDO_PASSWORD。¹⁰

Multi-Agent Kanban（v0.13.0+）

v0.13.0 將多 Agent 協作提升為第一級基礎功能：使用持久化 Kanban 看板，跨 Agent 與系統重新啟動追蹤工作、狀態及 worker 身分。¹⁸ 正因有了這塊看板，一群 Hermes worker 才能真正完成工作，不致因交接中斷而停滯不前。

Kanban 看板可自然搭配 /goal（鎖定目標的 Ralph 迴圈）處理目標端，並沿用既有的 delegate_task tool 處理生成語意。由此形成一種 worker 群模式：每個 Agent 都共用同一份事實來源，清楚掌握接下來該做什麼、由誰負責，以及哪些工作陷入停滯。

什麼是 Hermes Swarm？

swarm 是由多個 Hermes worker 組成，這些 worker 會針對同一個共用 Kanban 看板平行運作。 它並非需要另外啟用的獨立子系統——而是看板所促成的運作方式。看板 提供了平行 Agent 無法自行建立的關鍵能力：針對「接下來該接手哪項工作，而且是否已有其他人正在處理？」 給出單一且具權威性的答案。

v0.15.0 將此模式提升為正式支援的拓撲，新增用於 平行 worker 協調的 swarm 拓撲、將高階目標拆分成子工作的 自動分解、每項工作的模型覆寫、排程工作，以及工作樹管理，避免平行 worker 在同一份簽出內容中發生衝突。⁵⁹

實際運作方式如下：為 swarm 指定目標，讓自動分解功能將其拆成看板工作， 再由 worker 領取、執行並回傳結果。重試額度按工作設定（max_retries）， 因此單一不穩定的子工作不會耗盡整個執行作業的容錯額度。由於看板具備 持久性，swarm 可在重新啟動後繼續運作——worker 會重新連接，並依據相同狀態接續處理。

swarm 的成效取決於工作分解的品質。 看板負責協調 worker，但無法 將拆分不當的目標變成優良的工作規劃。共用隱藏狀態的工作依然會彼此衝突， 即使使用工作樹也無濟於事。

skill 系統

skill 是代理程式可在需要時載入的隨選知識文件。它們採用漸進式揭露模式，以盡量減少 token 用量，並與 agentskills.io 開放標準相容。¹¹

所有 skill 都位於 ~/.hermes/skills/——這是主要目錄，也是唯一可信來源。全新安裝時，內建 skill 會從儲存庫複製至此。透過 Hub 安裝及由代理程式建立的 skill 也會存放在這裡。¹¹

漸進式揭露

Level 0: skills_list()           → [{name, description, category}, ...]   (~3k tokens)
Level 1: skill_view(name)        → Full content + metadata                 (varies)
Level 2: skill_view(name, path)  → Specific reference file                 (varies)

只有在確實需要時，代理程式才會載入完整的 skill 內容。¹¹

SKILL.md 格式

---
name: my-skill
description: Brief description of what this skill does
version: 1.0.0
platforms: [macos, linux]      # Optional — restrict to OS platforms
metadata:
  hermes:
    tags: [python, automation]
    category: devops
    fallback_for_toolsets: [web]     # Conditional activation
    requires_toolsets: [terminal]    # Conditional activation
    config:                          # Config.yaml settings
      - key: my.setting
        description: "What this controls"
        default: "value"
        prompt: "Prompt for setup"
---

# Skill Title

## When to Use
Trigger conditions for this skill.

## Procedure
1. Step one
2. Step two

## Pitfalls
- Known failure modes and fixes

## Verification
How to confirm it worked.

條件式啟用

skill 可根據有哪些工具可用，決定顯示或隱藏自身。此功能最適合用於備援 skill——只有在付費工具無法使用時，才應出現的免費或本機替代方案：¹¹

範例：內建的 duckduckgo-search skill 使用 fallback_for_toolsets: [web]。設定 FIRECRAWL_API_KEY 後，web toolset 即可使用，代理程式會採用 web_search，而 DuckDuckGo skill 則保持隱藏。若未設定 API 金鑰，DuckDuckGo skill 會自動作為備援方案出現。¹¹

代理程式管理的 skill

代理程式可透過 skill_manage 工具建立、更新及刪除自己的 skill。這是代理程式的程序性記憶——當它摸索出一套不簡單的工作流程後，便會將方法儲存為 skill，供日後重複使用。¹¹

代理程式建立 skill 的時機：¹¹ - 成功完成複雜任務（使用工具5次以上）後 - 遭遇錯誤或走入死胡同，最終找到可行路徑時 - 使用者修正其處理方式時 - 發現不簡單的工作流程時

動作：¹¹

Skill Hub

從線上登錄庫瀏覽、搜尋、安裝及管理 skill：⁶¹¹

hermes skills browse                          # Browse all hub skills
hermes skills browse --source official        # Browse official optional skills
hermes skills search kubernetes               # Search all sources
hermes skills search react --source skills-sh # Search skills.sh directory
hermes skills inspect openai/skills/k8s       # Preview before installing
hermes skills install openai/skills/k8s       # Install with security scan
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills check                           # Check for upstream updates
hermes skills update                          # Reinstall changed hub skills
hermes skills audit                           # Re-scan installed hub skills
hermes skills uninstall k8s
hermes skills publish skills/my-skill --to github --repo owner/repo
hermes skills tap add myorg/skills-repo       # Add custom GitHub source

整合的 Hub 來源：¹¹

預設 GitHub tap（無須設定即可瀏覽）：openai/skills、anthropics/skills、huggingface/skills、NVIDIA/skills、garrytan/gstack。claude-marketplace 來源已於 v0.20.0 移除；browse-sh 在來源清單中取而代之。¹¹⁵⁵

安全性掃描

所有透過 Hub 安裝的 skill 都會經過安全性掃描器檢查，包括資料外洩、提示詞注入、破壞性命令、供應鏈風險訊號及其他威脅。¹¹

信任等級：¹¹

對於 community skill，--force 可覆寫非危險的政策封鎖，但無法覆寫 dangerous 掃描判定。¹¹

外部 skill 目錄

您可以指定額外的 skill 目錄，讓 Hermes 與本機目錄一併掃描：¹¹

skills:
  external_dirs:
    - ~/.agents/skills
    - /home/shared/team-skills
    - ${SKILLS_REPO}/skills

路徑支援展開 ~，以及替換 ${VAR} 環境變數。外部目錄為唯讀——代理程式建立或編輯 skill 時，一律寫入 ~/.hermes/skills/。若兩處存在同名 skill，則以本機版本優先。¹¹

釘選 skill：skills.auto_load（v0.21.4 時期）

在 config.yaml 的 skills.auto_load 下列出的 skill 名稱，會在每個新工作階段中釘選並完整載入——無論是 CLI、TUI、gateway、cron 或 API 皆然：⁵¹

skills:
  auto_load:
    - team-conventions
    - deploy-checklist

這份清單只會在首次建立代理程式提示詞時解析一次；若名稱不存在或已停用，系統會發出警告並略過，而不會導致工作階段失敗。HERMES_IGNORE_RULES（--ignore-rules 背後的運作機制）則會像處理其他自動注入的 context 一樣，停用此清單。這是常駐指令對 -s／--skills 的補充；後者只會為單一工作階段預先載入 skill。⁵¹

持久記憶

Hermes具備容量有限、經過篩選，且可跨工作階段保留的記憶。代理程式的記憶由2個檔案組成，兩者皆儲存於~/.hermes/memories/：¹²

兩者皆會在工作階段開始時以凍結快照形式注入系統提示。代理程式透過memory工具自行管理記憶，可執行add、replace或remove。¹²

凍結快照模式：系統提示的注入內容只會在工作階段開始時擷取一次，期間絕不變更。這是刻意設計，目的是保留LLM的前綴快取以提升效能。工作階段內所做的變更會立即儲存至磁碟，但要等到下一個工作階段才會出現在系統提示中。¹²

該儲存哪些內容

儲存以下內容（代理程式會主動執行）：¹² - 使用者偏好：「相較於JavaScript，我偏好TypeScript」→ user - 環境資訊：「此伺服器執行Debian 12與PostgreSQL 16」→ memory - 修正事項：「執行Docker命令時不要使用sudo，使用者已加入docker群組」→ memory - 慣例：「專案使用tab、每行120個字元，以及Google風格的docstring」→ memory - 已完成工作：「已於2026年1月15日將資料庫從MySQL遷移至PostgreSQL」→ memory

略過以下內容：¹² - 瑣碎或顯而易見的資訊 - 容易重新查明的事實 - 原始資料傾印（對記憶而言過於龐大） - 僅與當前工作階段相關的短暫資訊 - 情境檔案中已有的資訊

工作階段搜尋

除了MEMORY.md與USER.md之外，代理程式也能使用session_search工具搜尋過往對話。所有CLI與訊息工作階段都會儲存在SQLite（~/.hermes/state.db）中，並支援FTS5全文搜尋。自v0.15.0重新設計後，此工具完全不涉及LLM——它會直接傳回已儲存的對話內容（原始來源稱之為「single-shape tool returns DB content directly」）。正因如此，速度提升了4,500倍，也不再產生API成本。¹²⁵⁹³⁴

在v0.21.4時期新增了2項功能，兩者皆已在標籤v2026.9.21驗證。首先是時間範圍：探索介面接受after（工作階段開始時間的含括下限）與before（不含括的上限）。兩者皆可使用ISO日期／日期時間——若僅提供日期，代表當日UTC午夜——或相對期間（7d、24h、2w）；這些參數只應用於明確指定時間範圍的查詢。sort仍只是排序偏向，並非範圍限制。其次是零結果回想重試：FTS5會在搜尋詞之間隱含套用AND，因此，若改寫過的多詞查詢中有任何一個詞未出現在已儲存的句子裡，就可能無法命中。當精確查詢與子字串備援皆無結果時，搜尋會改為比對索引中的任一詞彙，並優先排列涵蓋較多詞彙的資料列。已有命中的查詢仍維持精確比對語意（只有零結果時才會觸發重試）；明確使用OR／NOT、單一詞彙，以及經CJK路由處理的查詢則不受影響。⁵¹

外部記憶提供者

若需要比MEMORY.md與USER.md更深入的持久記憶，Hermes內建7種外部記憶提供者plugin：Honcho、OpenViking、Mem0、Holographic、RetainDB、ByteRover與Supermemory。其他提供者（例如Hindsight）可從plugin目錄安裝。¹²

Hindsight在v0.21.4以前隨核心程式碼提供，並於v0.21.5移至目錄，由Vectorize維護。現有設定會自行遷移：若已設定memory.provider: hindsight，hermes update會將目錄中的plugin安裝到每個採用該設定的profile主目錄；若仍未安裝，代理程式首次啟動時也會進行安裝。若設為security.allow_lazy_installs: false，代理程式啟動流程只會記錄訊息，因此請自行執行hermes plugins install hindsight。plugin會安裝至~/.hermes/plugins/hindsight/並加入plugins.enabled；memory.provider、memory.hindsight.*、HINDSIGHT_API_KEY與您的記憶資料都會維持原狀。請使用hermes memory status與hermes plugins list檢查。hermes-agent[hindsight] pip extra已移除。⁵³

外部提供者會與內建記憶並行運作（絕不取代內建記憶），並加入知識圖譜、語意搜尋、自動擷取事實，以及跨工作階段使用者建模等功能：⁶¹²

hermes memory setup         # Pick a provider and configure it
hermes memory status        # Check what's active
hermes memory off           # Disable external provider (built-in only)

同一時間只能啟用1個外部提供者。內建記憶則一律保持啟用。⁶

工作階段自動恢復（v0.13.0+）

v0.13.0讓代理程式在執行途中遭到中斷後仍可恢復。gateway會在重新啟動後自動恢復中斷的工作階段；透過/update重新啟動時，升級過程會保留工作階段狀態；開發期間重新載入原始碼檔案時，也會維持目前工作階段，不再強制建立新工作階段。¹⁸實際效果是：長時間執行的gateway工作與由cron驅動的作業，不會再因程序重新啟動而重設context engine。

Checkpoints v2（v0.13.0+）

v0.13.0將狀態持久化重寫為單一儲存區設計，具備真正的清理機制、磁碟防護措施，且不會產生孤立的影子儲存庫。¹⁸先前的checkpoint系統會在長期運作的profile中持續累積磁碟狀態；v2儲存區則為本機checkpoint儲存空間設定明確上限，並移除造成空間增長的重複記帳資料。無須變更使用者端設定；下一次寫入checkpoint時便會採用v2路徑。

個性與SOUL.md

SOUL.md是Hermes執行個體的主要身分設定。它位於系統提示的第1個位置，取代硬編碼的預設身分。¹³

Hermes會自動在~/.hermes/SOUL.md（自訂profile則位於$HERMES_HOME/SOUL.md）建立預設的SOUL.md。現有的使用者檔案絕不會遭到覆寫。Hermes只會從HERMES_HOME載入SOUL.md，不會在目前的工作目錄中尋找。如此一來，跨專案的個性表現便能一致且可預期。¹³

SOUL.md該包含哪些內容

請用它設定持久的語氣與個性指引：¹³ - 語氣 - 溝通風格 - 直接程度 - 預設互動方式 - 風格上應避免的事項 - Hermes應如何處理不確定性、歧見與模糊情況

較不適合用於：¹³ - 一次性的專案指示 - 檔案路徑 - 儲存庫慣例 - 暫時性的工作流程細節

這些內容應放在AGENTS.md，而非SOUL.md。

SOUL.md與AGENTS.md的差異

這是Hermes身分管理中最重要的區別：¹³

SOUL.md——身分、語氣、風格、預設溝通方式，以及個性層級的行為。

AGENTS.md——專案架構、程式碼慣例、工具偏好、儲存庫專屬工作流程、命令、連接埠、路徑與部署備註。

有一項簡明實用的原則：若某項設定應如影隨形，就應放在SOUL.md；若屬於特定專案，則應放在AGENTS.md。¹³

內建個性

Hermes內建多種個性，可透過/personality切換：¹³³³

config.yaml中的自訂個性：¹³

agent:
  personalities:
    codereviewer: >
      You are a meticulous code reviewer. Identify bugs, security issues,
      performance concerns, and unclear design choices. Be precise and constructive.

接著使用/personality codereviewer切換。

SOUL.md與/personality的差異

SOUL.md是基礎語氣；/personality則是工作階段層級的疊加設定。¹³建議讓預設SOUL.md保持務實，再於教學對話中使用/personality teacher，或在腦力激盪時使用/personality creative。

Nous Tool Gateway（v0.10.0+）

自Hermes Agent v0.10.0（2026年4月16日）起，付費的Nous Portal訂閱者可使用既有的Portal憑證，存取一組經過精選的代管工具，無須管理額外的API金鑰。⁶¹ Hermes CLI本身仍採用MIT授權，並且完全開放原始碼。改變之處在於，Portal驗證如今不只解鎖模型推論功能。

最快的啟用方式是hermes setup --portal，README將其介紹為「全新安裝後只需一道指令」：它會透過OAuth登入、將Nous設為提供者，並啟用Tool Gateway。此後，可透過hermes portal管理相關設定。hermes portal login（未指定子命令時的預設行為）會執行相同的一次性初始設定；hermes portal info會顯示「Portal驗證與Tool Gateway路由摘要」；hermes portal open會在預設瀏覽器中開啟訂閱頁面；hermes portal tools則會列出gateway工具，以及哪些工具會透過Nous路由。hermes portal status仍作為info的隱藏向後相容別名保留，而該標籤版本的文件CLI參考資料仍將子命令寫成status，因此兩者皆可使用。²⁸

gateway包含哪些工具

運作方式

gateway透過新的use_gateway設定欄位，讓每項工具皆可個別選擇啟用。如果hermes auth中已有Portal憑證，並且為某項工具啟用gateway，該工具的呼叫就會透過Portal路由。否則，系統會使用您的直接API金鑰（若有）。

# config.yaml — per-tool gateway opt-in
tools:
  web_search:
    provider: firecrawl
    use_gateway: true          # route via Nous Portal subscription
  image_generation:
    provider: fal
    use_gateway: true

執行階段優先順序：當gateway可用，且某項工具設有use_gateway: true時，即使也設定了直接API金鑰，Hermes仍會優先使用gateway。這會影響計費方式：gateway呼叫會從Portal訂閱額度扣除，而非使用直接API金鑰的餘額。

啟用gateway

hermes model                      # select Nous Portal (OAuth flow)
hermes tools                      # per-platform tool picker integrates gateway tools
hermes status                     # confirms gateway/subscription detection

系統會透過hermes auth中既有的Portal OAuth憑證，自動偵測訂閱狀態，無須另行登入。自v0.19.0起，您也能直接在工作階段中管理訂閱：/subscription會顯示方案與剩餘額度、明確預覽升級費用或降級生效時間，並套用變更，同時顯示排程變更橫幅且支援復原；/topup則可加值。桌面應用程式中也有對應的帳務設定分頁。⁵⁶

定價與存取權限

定價與方案名稱公布於Nous Portal定價頁面（https://portal.nousresearch.com/pricing）。本指南不逐一列出方案，因為這些方案屬於Portal產品的範疇，而非Hermes CLI，且其變更不受Hermes版本發布週期影響。請前往https://portal.nousresearch.com/註冊，並查看定價頁面以取得目前的方案資訊。

Nous免費方案與引導式首次啟動（v0.21.2+）

自v0.21.2起，全新安裝不再需要付費方案或API金鑰，即可建立可正常運作的agent：免費推論與connectors皆可直接使用，只需一道指令即可登入，也能在聊天中使用/login開始登入。Connector工具（Gmail、Linear、Notion及其他工具）與一般工具相同，皆可透過tool_search搜尋。桌面版另提供由HERMES_GUEST_ONBOARDING=1控制的引導式首次啟動流程；只有字面值1會啟用此功能——桌面版本身的測試明確驗證了'true'、'0'與空值均不會將其開啟。此外，啟動決策會寫入新建後端程序的環境中，確保繼承而來的值絕不會意外滲入。⁴⁸

自v0.21.4期間起，連接這些connectors已整合為由後端統一負責的單一操作，不再由各前端分散處理：一次manage_connections工具呼叫會驅動後端上的純資料連線狀態機（操作期限固定為300秒，且刻意不設為設定鍵），而Desktop、TUI與CLI都會將其呈現為相同的設定卡片。卡片會為每項缺少的憑證顯示一個欄位（名稱、提示、是否必填），並在所有必填欄位皆有文字前停用操作按鈕；後端也會在每個前端強制執行相同的機密資料專用分流機制。⁵¹

棄用通知

• HERMES_ENABLE_NOUS_MANAGED_TOOLS環境變數已於v0.10.0中移除。代管工具現在透過各工具的use_gateway設定欄位啟用，並受Portal訂閱狀態限制。⁶¹

定位：此版本的功能範圍不包括什麼

Hermes Agent CLI不受訂閱限制。此專案仍採用MIT授權，所有核心功能（CLI、skills、記憶、訊息gateway、cron、MCP、本機dashboard，以及每個提供者的BYOK）皆可在不支付任何費用的情況下端到端運作。v0.10.0只是為已付費訂閱Nous Portal的使用者新增一條便利途徑，並未從免費使用途徑中移除任何功能。

Messaging Gateway

Hermes 可作為長時間執行的 gateway 程序，透過單一 gateway 程序連線至 28 個訊息平台：Telegram、Discord、Slack、WhatsApp、Signal、簡訊、電子郵件、Home Assistant、Mattermost、Matrix、DingTalk、Feishu/Lark、WeCom、Weixin（WeChat）、BlueBubbles（iMessage）、QQBot、Microsoft Teams、Tencent Yuanbao、Google Chat、LINE、SimpleX Chat、Photon（iMessage）、WhatsApp Cloud API、WeCom Callback、Raft、IRC、ntfy、Buzz，以及通用 Webhook 轉接器。^360171819 這個 28 取自 v2026.8.31 標籤版本文件中的「平台比較」表格；在底層，gateway/config.py 定義了 24 個內建 Platform 列舉成員（包括 local、api_server、webhook、msgraph_webhook 與 relay 等非聊天項目），並依需求將其他任何名稱解析至 plugins/platforms/ 下 22 個隨附的轉接器目錄之一，因此，單純計算列舉成員或目錄數量並不會與文件中的數字相符。²⁵ v0.9.0 新增透過 BlueBubbles 使用 iMessage 的支援（自動註冊 Webhook、設定精靈及當機復原能力），並透過 iLink Bot API 原生支援 WeChat，同時為企業應用程式提供 WeCom 回呼模式。¹⁶ v0.11.0 新增 QQBot。⁶⁰ v0.12.0 新增 Microsoft Teams 與 Tencent Yuanbao。¹⁷ v0.13.0 新增 Google Chat，成為第 20 個平台，並沿用同一套可插拔轉接器架構；IRC 與 Microsoft Teams 也遷移至新的轉接器模式，採用通用的 env_enablement_fn／cron_deliver_env_var 外掛掛鉤。¹⁸ v0.14.0 新增 LINE 與 SimpleX Chat，並以 Graph 驗證、Webhook 接聽程式、管線執行環境及傳出訊息遞送，完整打通 Microsoft Teams 的端對端技術堆疊。¹⁹ v0.17.0（2026年6月19日）新增透過 Photon Spectrum 直接使用 iMessage，無須中繼服務（以 hermes photon login 進行裝置代碼 OAuth，不再需要 Mac／BlueBubbles 中繼服務）、官方 WhatsApp Business Cloud API 轉接器（取代橋接程序需求）、SimpleX 群組與原生附件功能，並將 Raft 納入隨附的平台外掛。²¹ 文件表格中另有兩項未在發行說明中大肆宣傳的平台：ntfy 是輕量型 HTTP 發布／訂閱推播管道（從 ntfy 行動應用程式訂閱主題，傳送訊息至該主題以便與代理互動，再於手機上接收回覆；可搭配公用 ntfy.sh 伺服器或自行託管的執行個體使用，無須 SDK 或常駐程式），而 Buzz 則將 Hermes 連接至 Buzz 社群。Buzz 是 Block 建構於 Nostr 通訊協定之上的開放原始碼人類與代理協作平台；傳出訊息會透過 shell 呼叫 buzz CLI，傳入訊息則使用原生 Nostr WebSocket 訂閱。兩者皆可透過 hermes gateway setup 完成設定。²⁵

設定

hermes gateway setup                # Interactive platform configuration
hermes gateway install              # Install as user service (systemd/launchd)
hermes gateway start                # Start the installed service
hermes gateway stop
hermes gateway restart
hermes gateway status
hermes gateway run                  # Run in foreground (debugging)

互動式設定會引導您逐一連接各平台，包括 API 權杖、機器人 ID、頻道對應及允許清單。⁶

訊息流向

依據上游架構文件：³

Platform event → Adapter.on_message() → MessageEvent
  → GatewayRunner._handle_message()
    → authorize user
    → resolve session key
    → create AIAgent with session history
    → AIAgent.run_conversation()
    → deliver response back through adapter

每個訊息平台都會經過與 CLI 相同的 AIAgent 對話迴圈。 因此，斜線命令在兩處的運作方式完全一致，而在 Telegram 排程的 cron 工作也能將輸出遞送至 Discord——平台之間的差異只存在於邊緣層。³

v0.19.0 新增以 profile 為基礎的訊息路由與持久化遞送。 共用單一機器人權杖的多工 gateway，可將特定伺服器、頻道或討論串路由至不同 profile；每個 profile 的設定、skills、記憶與密鑰皆完全隔離，亦可使用 GATEWAY_MULTIPLEX_PROFILES 覆寫。經過一系列強化後，單一 profile 設定錯誤也不再會拖垮整個 gateway。底層路由索引已移至 state.db（sessions.json 現在只是選用的舊版鏡像），最終回應也會在平台傳送作業前後記錄至持久化的遞送責任帳本。如此一來，若完成的回應恰逢 gateway 當機，系統會在下次啟動時重新遞送，而不會無聲無息地遺失。⁵⁶ v0.21.2 進一步強化路由 profile 之間的隔離，修補這類多工設定中的一系列跨 profile 洩漏問題：繼承而來的允許清單、傳送至預設 profile 主機的認證資料、預設 profile 的保管庫密鑰流入 stdio MCP 伺服器、跨 profile 的 MEDIA: 附件，以及同層 profile 的 Nous bearer 權杖殘留於各程序備忘資料中（#107609-#107630）。⁴⁸

v0.21.1 將對話邊界改為只能明確建立。 v2026.9.7 標籤版本的工作階段生命週期文件以四句話闡明此契約：「閒置或經過多少實際時間，都不會輪替對話。/new 與 /reset 會建立明確邊界；context compression 則持續管理過長的歷程。舊版計時器設定會被忽略。現有的 SessionResetPolicy 資料型別只是無作用的相容性資料，並非執行階段原則。」明確暫停仍會在下一個傳入回合建立邊界；復原作業會遵守已定案的邊界，而不會重新開啟；僅因資源因素而逐出的對話仍可繼續。如果 gateway 上的工作階段看似「永不過期」，這正是目前的設計；請自行使用 /new 輪替。⁴³

自 v0.21.4 期間起，第二個 hermes gateway run 會附加至現有程序或拒絕執行，而不會重複繫結。 規則是每部主機的每位作業系統使用者只能執行一個 hermes serve 與一個 hermes gateway run，且兩者都會多工處理所有 profile。若為執行中的多工器已在服務的 profile 啟動 gateway，命令只會附加至現有程序並以狀態碼 0 結束；若該 profile 尚未受到服務，Hermes 會要求多工器重新掃描 profiles/，待其納入服務後再附加；如果無法讓多工器服務該 profile，命令會拒絕執行，而不會悄悄啟動第二個 gateway。--replace 現在會鎖定該主機程序，無論它是由哪個 profile 啟動；當擁有者程序卡死時，--force 則會完全略過詢問。獨立 gateway 仍可共存：如果執行中的 gateway 是另一個 profile 的獨立（非多工）gateway，您的 profile 仍會像以往一樣在旁啟動自己的 gateway，直到強制進行這項遷移為止（#109417）。若兩個 gateway 同時啟動，未取得主機鎖定的一方會以狀態碼 75 結束，而 Hermes 產生的每種監督程式都會重試；屆時勝出者的記錄已經存在，因此重試程序會依上述規則附加或拒絕執行。鎖定與會合記錄會存放於 $HERMES_GATEWAY_LOCK_DIR；若未設定，則位於 $XDG_STATE_HOME/hermes/gateway-locks（預設為 ~/.local/state/hermes/gateway-locks），其範圍限定於該作業系統使用者。若記錄中的 PID 已終止或已被其他程序重複使用，該記錄會被視為過期並予以忽略，因此 gateway 當機不會阻礙下次啟動。Desktop 應用程式也遵循相同規則，會附加至執行中的主機後端，而不會產生第二個程序。⁵¹

自 v0.21.5 起，多工處理不再是選用功能。 gateway.multiplex_profiles 只有一個有效值：true。未設定的鍵會解析為啟用，並寫入預設 profile 的 config.yaml；若明確設為 false，系統會就地改寫為 true，在該次 gateway 啟動時顯示一次方框通知，並於下次 hermes update 摘要中再次提醒。兩項控制機制取代了舊有的停用選項。若要讓單一 profile 離線，但不停止所有人的機器人，請執行 hermes -p <name> gateway stop：主機會將其停放（建立 profiles/<name>/gateway.parked 標記），而 hermes -p <name> gateway start 則會解除停放；dashboard 與 Desktop 的「停止／啟動」按鈕作用相同。若具名 profile 仍需要自己的 gateway，請在其 config.yaml 中設定 gateway.standalone: true；主機永遠不會服務該 profile，而其 stop／start 只會操作自己的程序。文件稱此鍵為「暫時性的相容性過渡機制」，並非受支援的拓撲；若在預設 profile 使用，系統會忽略並顯示警告。若拆分至不同作業系統使用者，或使用預設主目錄 profiles/ 以外的 HERMES_HOME，仍須使用 --force。⁵³

使用者授權與配對

hermes pairing list                    # Show pending and approved users
hermes pairing approve <platform> <code>
hermes pairing revoke <platform> <user-id>
hermes pairing clear-pending

配對碼可防止陌生人任意與您的 gateway 對話。使用者從其訊息平台傳送配對碼；您以 hermes pairing approve 核准後，對方便會取得後續存取權限。⁶

unauthorized_dm_behavior 決定陌生人在配對前傳送私人訊息時會收到何種回應：pair 會以私人訊息傳送配對碼，ignore 會默默捨棄訊息，而 v0.21.4 期間新增的 decline 則會傳送一次禮貌的拒絕訊息，接著在 24 小時內不再回應該傳送者（#88028）。系統會依平台與傳送者進行拒絕訊息去重，並涵蓋別名；訊息文字取自 unauthorized_dm_decline_message（全域鍵；留空時會使用內建回覆：「您好！我是私人助理，只能與我的擁有者交談，因此無法直接協助您。很抱歉！」）。您可以設定全域行為，也可針對個別平台設定；設定精靈會將值寫入對應平台：

# ~/.hermes/config.yaml
unauthorized_dm_behavior: decline      # global; gateway.unauthorized_dm_behavior also works
unauthorized_dm_decline_message: ""    # empty = built-in reply
platforms:
  telegram:
    unauthorized_dm_behavior: pair     # per-platform value always wins

未設定任何值時，實際預設行為取決於允許清單。未設定允許清單時為 pair；一旦設定任何允許清單（GATEWAY_ALLOWED_USERS，或平台的允許使用者、群組允許使用者或群組允許聊天變數），便會改為 ignore。這是因為允許清單代表 gateway 已受到刻意限制，向未知聯絡人傳送配對碼不但造成干擾，也可能導致資訊洩漏（#9337）。全域 ignore 或 decline 可覆寫此規則，但全域 pair 不行，因為它與預設值無法區分；若要在使用允許清單的同時保留配對功能，請針對個別平台設定 pair。（若平台轉接器本身設有 dm_policy，系統會先查詢該設定，再套用允許清單規則。）電子郵件採收件匣模式，預設為 ignore；除非透過其專屬的平台鍵選擇啟用，否則全域值不會套用至電子郵件。當您為未設定允許清單的平台進行設定時，hermes gateway setup 會將拒絕列為可選答案之一。⁵¹

排程任務（Cron）

Hermes 具備完善的 cron 系統，其中的工作是代理任務，而非 shell 指令。每個排程工作都會透過新的 AIAgent 執行，使用已設定的提示詞及選用的附加 skill，並將結果傳送至任何平台：³⁶

hermes cron list
hermes cron create --prompt "Check HN for AI news and summarize" --schedule "0 9 * * *" --deliver telegram
hermes cron edit <id>
hermes cron pause <id>
hermes cron resume <id>
hermes cron run <id>         # Trigger now on the next tick
hermes cron remove <id>
hermes cron status           # Check if scheduler is running
hermes cron tick             # Run due jobs once and exit

您也可以在訊息聊天中以對話方式建立：

Every morning at 9am, check Hacker News for AI news and send me a summary on Telegram.

代理會透過自身工具設定 cron 工作。工作會持續儲存在 JSON 中，重新啟動後仍會保留。³

v0.21.0 為排程工作加入了記憶與判斷能力。共有4項機制，均已在標籤 v2026.8.31 驗證：³⁵³⁷

• 連續性。continuity=true 會在每次執行時注入該工作自身最近一次的輸出，讓偵察或監控工作「甦醒時能看到上次回報的內容，進而去除重複項目，並接續先前的進度」——注入的指示為「避免重複已回報的內容」。首次執行不受影響；在內部，此旗標會儲存為 context_from 中的保留項目 self。可透過 hermes cron create ... --continuity 啟用，並使用 hermes cron edit <job_id> --continuity／--no-continuity 切換。³⁷
• 持久化記事本。每個工作都有一個小型 KV 暫存區，可儲存游標、水位標記與監看清單（每個值16 KB、每個工作64 KB——內容會在每次執行時注入提示詞，因此特意設有容量上限）。可使用 hermes cron notepad <job_id> set <key> <value> 寫入，執行中的代理會透過終端工具呼叫此指令。³⁷
• 監控模式。工作可以附加成本較低的 monitor_script／monitor_url 來源，在每次觸發時優先執行。若輸出未變更（以完全相同的位元組判定），就會徹底略過代理執行——不呼叫 LLM、不傳送內容，僅留下無聲的 no_change 執行記錄。若有變更，則會注入差異區塊，並照常執行代理。監控指令碼應輸出穩定內容，否則每次觸發看起來都會像是發生變更。³⁷
• 個別工作的推理強度與 Bot Chat 傳送。--reasoning-effort 可固定工作的思考層級（從 none 至 ultra），覆寫該工作執行時的全域與個別模型設定；deliver=bot-chat 則會將輸出作為真正的傳入訊息，送至 profile 的標準 Bot Chat 工作階段。機器人會「處理任何需要採取行動的事項，並在聊天中回覆」，而非僅由人員閱讀頻道內容。³⁷

MCP 整合

Hermes 同時支援作為 Model Context Protocol 的用戶端與伺服器：⁶

作為用戶端——將 Hermes 連線至外部 MCP 伺服器，以擴充其工具範圍：

hermes mcp add <name> --url https://example.com/mcp
hermes mcp add <name> --command npx --args "-y,@modelcontextprotocol/server-github"
hermes mcp list
hermes mcp test <name>
hermes mcp remove <name>
hermes mcp configure <name>   # Toggle individual tool selection
hermes mcp login <name>       # Force re-auth for an OAuth server (--flow browser|device)
hermes mcp reauth [--all]     # Re-authenticate one OAuth server, or every one

也可以在 config.yaml 中手動設定：¹⁴

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

自 v0.19.0 起，MCP 工具會依照 mcp__server__tool 命名慣例提供給模型——每個工具名稱都包含其伺服器名稱，因此兩台伺服器即使提供同名工具，也不再發生衝突——而 MCP 伺服器的日誌通知也會顯示於 agent.log。⁵⁶

v0.21.1 為 MCP OAuth 新增裝置代碼流程：hermes mcp login <name> 可接受 --flow {browser,device}——browser 是既有的 PKCE 流程，device 則是適用於無頭或遠端機器的 RFC 8628 裝置代碼登入——此旗標會覆寫伺服器的 oauth.flow 設定。同一版本也會在整個 OAuth 工作階段中強制執行 profile 所有權驗證；遇到格式錯誤的 OAuth 中繼資料快取時，會予以忽略，以免伺服器卡住；並透過用戶端本機回呼轉送桌面版 MCP OAuth。此外，-t／--toolsets 現在也會篩選要啟動的已設定 MCP 伺服器，因此限定範圍的呼叫不會冷啟動不需要的伺服器。⁴⁴

v0.21.0 將桌面版的 MCP 操作介面化為指揮中心：伺服器與目錄整合至同一頁面，支援拖入式「貼上任何內容」匯入；背景健康檢查會在工具呼叫失敗前，揭示即將到期的驗證；伺服器群成本／用量浮層可顯示各伺服器的結構描述 token 估算值與30天用量；hermes:// 深層連結則可在明確確認後安裝 MCP 伺服器。³⁵

v0.21.4 版本新增 mcp.discovery_concurrency（預設值為4；0 代表不限，#117373）：限制探索階段可同時連線的已設定 MCP 伺服器數量。所有伺服器仍會連線——此上限只會避免它們同時湧入——若設定非整數或負值，系統會記錄警告並退回預設值。⁵¹

作為伺服器——將 Hermes 對話提供給其他代理：

hermes mcp serve
hermes mcp serve -v    # Verbose

Context 壓縮

Hermes 會自動壓縮過長的對話，使其維持在模型的 context window 範圍內。壓縮摘要器會另行呼叫 LLM——您可以將其指向任何供應商或端點。⁴ 自 v0.20.6 起，保留尾端策略預設為 lean（compression.tail_mode: lean）；在該標籤版本中，摘要器的模型／供應商／端點設定已移至 auxiliary.compression.*，不再使用舊版的 compression.summary_*。舊版設定鍵會在首次載入時自動遷移（設定版本17）。³⁰³¹

compression:
  enabled: true
  threshold: 0.50          # Compress at this % of context limit
  threshold_tokens: null   # Optional absolute token cap -- trigger fires at the lower of ratio vs cap
  target_ratio: 0.20       # Fraction of threshold to preserve as recent tail (legacy tail mode)
  tail_mode: lean          # Tail retention: "lean" (default) or "legacy"
  protect_last_n: 20       # Min recent messages to keep uncompressed
  protect_first_n: 3       # Non-system head messages pinned across compactions

auxiliary:
  compression:
    model: ""              # Empty = main chat model; e.g. "google/gemini-3-flash-preview"
    provider: "auto"       # "auto", "openrouter", "nous", "codex", "main", etc.
    base_url: null         # Custom OpenAI-compatible endpoint (overrides provider)

tail_mode 決定的內容。legacy 會依 target_ratio 的大小逐字保留尾端內容——在大型 context window 或提高門檻的設定中，每次壓縮都會囤積100–240K個 token。lean 則會逐字保留 context window 的2.5%作為尾端內容，並將範圍限制在10K下限與25K上限之間；連續性改由摘要承接，包括壓縮區域內保留詳細識別資訊的工作階段日誌（每次嘗試呼叫一次輔助摘要器）、以機械方式擷取的錨點索引（PR 編號、SHA、路徑、錯誤字串——使用規則運算式，絕不改寫）、逐字引用的每則真實使用者訊息，以及可讓代理重新存取所有已摘要內容的 session_search 復原指標。文件針對500K token 真實工作階段的實測結果顯示：保留量約為49K token，而非約162K。lean 尾端內的舊工具結果會降級為附帶復原指標的單行摘要；未知的 tail_mode 值則會退回 lean。³¹

供應商選項：⁴³¹

摘要模型所支援的 context 長度必須至少與主要模型相同，因為它會在單次呼叫中接收完整的對話中段——若其 window 較小，呼叫就會失敗，而中段對話將在沒有摘要的情況下遭到捨棄。⁴³¹

預算壓力警告

當代理處理包含大量工具呼叫的複雜任務時，可能會在不知不覺間耗盡迭代預算（自 v0.20.0 起，預設為500輪，原為90輪）。預算壓力機制會自動警告模型：⁴

串流逾時

LLM 串流連線設有兩層逾時機制，並會針對本機供應商（localhost、區域網路 IP）自動調整：⁴

本機端點的 Socket 讀取逾時會提高至30分鐘，因為本機 LLM 在處理大型 context 的預填充時，可能需要數分鐘才會產生第一個 token。⁴

本機網頁儀表板（v0.9.0+）

這是一套以瀏覽器為基礎的儀表板，可供您在本機管理 Hermes Agent。無須接觸設定檔或終端，即可調整設定、監控工作階段、瀏覽 skill，以及管理 gateway。¹⁶ 使用 hermes dashboard 啟動。對偏好 GUI 的新使用者而言，這是最簡便的入門途徑。

背景程序監控（v0.9.0+）

watch_patterns讓您設定要在背景程序輸出中監控的模式，並在符合時即時收到通知。¹⁶無論是監控錯誤、等待特定事件（「正在監聽連接埠」），或追蹤建置記錄，都不必輪詢。搭配v0.8.0推出的notify_on_complete（在背景工作完成時通知），Hermes如今已具備完整的背景程序可觀測性層。¹⁵

可插拔的context engine（v0.9.0+）

現在可透過hermes plugins將context engine作為可插拔插槽管理。您可以換用自訂context engine，控制agent每一輪可見的內容，包括篩選、摘要，或注入特定領域的context。¹⁶這項設計將context策略與核心agent迴圈解耦，讓各專案或領域都能自訂context。

備份與還原（v0.9.0+）

hermes backup會為您的設定、工作階段、skills及記憶建立完整封存檔。hermes import則可從備份封存檔還原。¹⁶您可藉此在不同機器間遷移、於重大變更前建立快照，或與團隊成員分享經過驗證的設定。

Termux／Android支援（v0.9.0+）

Hermes可透過Termux直接在Android上執行。經過調整的安裝路徑、針對行動裝置螢幕最佳化的TUI、語音後端支援，以及/image指令，皆可直接在裝置上使用。¹⁶

安全性強化（v0.13.0+）

v0.13.0修正了8項P0安全性問題，並將一項預設值改為更有利於使用者的設定。¹⁸緊接著，v0.14.0又修正了12項P0與50項P1問題，包括防範sudo暴力破解與強化sudo-stdin、修正危險指令繞過問題、在將工具錯誤重新注入模型前進行清理、dashboard plugin API驗證、skills-hub SSRF防護，以及安裝期間的供應鏈安全公告掃描。¹⁹

若您負責維護Hermes部署，應將v0.13.0與v0.14.0視為與安全性息息相關的升級，而不只是功能更新。v0.13.0修正了Discord跨guild繞過問題與兩個TOCTOU時間差漏洞；v0.14.0則進一步強化sudo處理、工具錯誤重新注入、plugin API、skills-hub SSRF及相依套件安全公告。

v0.21.0帶來第4波強化。寫入受保護的agent指示檔案（包括AGENTS.md、CLAUDE.md、SOUL.md、.cursorrules、skills及記憶儲存區）現在一律需要核准，防止遭提示注入的agent暗中改寫自身的常駐指示。此閘門預設啟用（security.protected_instruction_files: true，並透過protected_instruction_extra_patterns中的fnmatch基本檔名延伸清單擴充）；原始碼也明確指出其封堵的攻擊途徑：「編輯AGENTS.md／CLAUDE.md／SOUL.md的注入指示」，並說明指示檔案會從cwd目錄樹載入，因此「agent日後可能執行所在之處的任何AGENTS.md，都是有效的攻擊目標」。³⁵³⁹同一版本也修補了終端機錯誤、讀取.env檔案、checkpoints及ACP記錄中的機密資訊外洩缺口；讓核准系統能識別Windows破壞性指令與路徑；透過穩定的TCC簽署識別，使macOS權限授予在更新後仍然有效（僅需設定一次：hermes desktop --setup-tcc-identity，僅限macOS，且需要openssl/security/codesign）；在上游遭入侵後移除Blender MCP目錄項目與skill；並為plugin安裝加入Tier-1安全性掃描。³⁵³⁹

實務工作者的架構參考

本節適合想深入瞭解底層運作方式，以便除錯、擴充或分析效能的人士。內容綜合整理自上游架構文件。³

進入點→AIAgent

Hermes 的每個進入點最終都會呼叫AIAgent.run_conversation()：

┌──────────────────────────────────────────────────────────────────┐
│                        Entry Points                              │
│                                                                  │
│  CLI (cli.py)    Gateway (gateway/run.py)    ACP (acp_adapter/)  │
│  Batch Runner    API Server                  Python Library     │
└──────────┬──────────────┬───────────────────────┬────────────────┘
           │              │                       │
           ▼              ▼                       ▼
┌──────────────────────────────────────────────────────────────────┐
│                     AIAgent (run_agent.py)                       │
│                                                                  │
│  ┌─────────────┐  ┌──────────────┐  ┌──────────────┐             │
│  │ Prompt      │  │ Provider     │  │ Tool         │             │
│  │ Builder     │  │ Resolution   │  │ Dispatch     │             │
│  └──────┬──────┘  └──────┬───────┘  └──────┬───────┘             │
│         │                │                 │                    │
│  ┌──────┴───────┐ ┌──────┴───────┐  ┌──────┴───────┐             │
│  │ Compression  │ │ 3 API Modes  │  │ Tool Registry│             │
│  │ & Caching    │ │ chat_compl   │  │ 47 tools     │             │
│  │              │ │ codex_resp   │  │ 20 toolsets  │             │
│  │              │ │ anthropic    │  │              │             │
│  └──────────────┘ └──────────────┘  └──────────────┘             │
└──────────────────────────────────────────────────────────────────┘

圖表改編自上游架構文件。³

啟動畫面中的「47 tools / 20 toolsets」與「28 tools」。「47 tools」是上游儲存庫完整工具登錄表的總數，涵蓋Hermes隨附原始程式碼的所有toolset及其中每項工具。實際執行的CLI會在啟動畫面顯示較小的數字（本指南驗證所用的安裝環境顯示28 tools / 89 skills）。這並非錯誤。許多toolset採選用制，必須在config.yaml的toolsets:下明確啟用，例如訊息平台轉接器、瀏覽器自動化及負載較重的擷取工具等。登錄表總數代表「可用項目」，啟動畫面的數字則代表「目前profile中已啟用的項目」。可使用hermes tools --list查看啟用中的toolset，並透過~/.hermes/config.yaml中的toolsets:區塊啟用或停用個別toolset（也可在執行中的工作階段內使用/tools list、/tools enable <name>或/tools disable <name>；移除工具會觸發工作階段重設，讓agent重新建立工具資訊清單）。

3種API模式

Hermes將供應商之間的差異抽象化為3種API模式，並在執行階段自動選用：³

runtime_provider.py解析器會將(provider, model)組合對應至(api_mode, api_key, base_url)，支援18種以上的供應商，並處理OAuth流程、憑證集區及別名解析。³

CLI工作階段中的資料流程

User input → HermesCLI.process_input()
  → AIAgent.run_conversation()
    → agent.prompt_builder.build_system_prompt()
    → runtime_provider.resolve_runtime_provider()
    → API call (chat_completions / codex_responses / anthropic_messages)
    → tool_calls? → model_tools.handle_function_call() → loop
    → final response → display → save to SessionDB

取自上游架構頁面。³

提示組裝順序

提示堆疊包含：¹³

1. SOUL.md（agent身分；若無法使用，則採用內建的備援內容）
2. 感知工具的行為指引
3. 記憶體／使用者情境（MEMORY.md、USER.md）
4. Skills指引
5. 情境檔案（AGENTS.md、.cursorrules）
6. 時間戳記
7. 平台專屬格式提示
8. /personality等選用的系統提示覆寫層

SOUL.md是根基，其餘所有內容皆建構於其上。¹³

工作階段儲存空間

採用SQLite的工作階段儲存空間，並支援FTS5全文搜尋。工作階段具備譜系追蹤功能（可跨壓縮追蹤父子關係）、逐平台隔離，以及具競爭處理機制的不可分割寫入。³

若v0.21.x安裝環境中的儲存區發生問題，請使用v0.21.2或更新版本：該版本解決了v0.21.0時期的一系列state.db脆弱性問題，包括第2個寫入者會取消彼此的鎖定、正常資料庫被誤報為損毀，以及單筆不良資料導致sessions list失敗。它也將託管聊天室的協調資料從根儲存區移至專用的shared-state.db，使profile gateway不再以可寫入模式開啟主要工作階段儲存區。hermes doctor現在會分別指出結構損毀與FTS索引損毀；FTS損毀只會使搜尋功能降級，不會導致該輪作業失敗；hermes sessions recover --inspect-only（離線、非破壞性、鎖定profile）則會回報標準資料表是否可讀，且不會建立輸出資料庫。此子命令早已存在，但先前未在此處記載。請參閱v0.21.2的新功能。⁴⁸若儲存區停留在錯誤的SQLite日誌模式，v0.21.4期間新增了離線轉換工具hermes sessions set-journal-mode delete|wal（請參閱頂層命令中的hermes sessions資料列）。⁵¹

Plugin系統

共有3個探索來源：~/.hermes/plugins/（使用者）、.hermes/plugins/（專案），以及pip進入點。Plugin會透過情境API登錄工具、掛鉤與CLI命令。記憶體供應者是plugins/memory/下的特殊plugin類型。³自v0.21.2起，另提供精選且固定SHA的plugin目錄，您可以瀏覽並依名稱安裝；此外，hermes plugins pack支援「宣告式、可共享的plugin集合」：使用單一hermes-pack.yaml，將一組plugin固定至確切的commit SHA。安裝套件時會展開為一般的固定版本安裝，而功能同意仍按個別plugin處理。⁴⁸

v0.21.4期間將該目錄從CLI介面進一步發展為隨附成品。儲存庫的plugin-catalog/目錄從v2026.9.14的9筆項目增加至v2026.9.21的228筆；每個plugin各有1份經審核的YAML（名稱、儲存庫、維護者、層級、類別、功能），固定至確切的40字元commit SHA，且只有存在於該目錄中才代表獲准收錄。這些資料會發布為供CLI使用的plugin-catalog.json（即時擷取，並快取於~/.hermes/cache/）。文件網站如今會根據同一份資料，為每個plugin（/docs/plugins/<name>）及每位作者（/docs/plugins/by/<slug>）建立頁面。每個頁面都會顯示從固定commit擷取的plugin README，而非分支最新版本；過程會使用建置階段的允許清單移除原始HTML，並依提交者日期標記新增／更新時間以供排序。v0.21.4版本列出的10個社群plugin，在該標籤下全都是目錄項目，實際目錄slug如下：hermes-tailscale、hermes-ssh、shodan、hermes-terminal、hermes-rss（另有獨立的rss-reader）、hermes-resetwatch、done-bell、kiwi、cognee及web-octen。桌面版的Plugins中心現在也能在確認對話方塊後解除安裝plugin；目錄plugin透過plugins.manage remove處理，獨立桌面plugin則透過Electron載入器處理。⁵¹

hermes plugins                       # Interactive enable/disable UI
hermes plugins browse                # List every curated plugin catalog entry (v0.21.2+)
hermes plugins search <query>        # Search the curated plugin catalog (v0.21.2+)
hermes plugins install <name|repo>   # Install from the curated catalog, a Git URL, or owner/repo
hermes plugins enable <name>
hermes plugins disable <name>
hermes plugins list
hermes plugins pack install <src>    # Shareable SHA-pinned plugin sets; also: pack export, pack show (v0.21.2+)

相容期（v0.21.1）現已結束：外部plugin必須在2026年9月14日前停止使用分解前的匯入路徑。2026年9月的分解作業（PR #102117）重新配置了plugin常用的內部匯入項目；暫時性的COMPAT_MANIFEST.md層則從舊模組重新匯出1,148個已移動的公開名稱，並在每個處理程序中針對每個名稱警告一次（HermesPluginCompatWarning）。移除作業已於2026年9月14日如期生效，其機制是隨附程式碼中的日期閘門（hermes_cli/plugin_compat.py內的COMPAT_REMOVAL_DATE；不需要還原任何程式碼）：自該日起，受影響的plugin會被停用而不再載入，CLI啟動畫面、hermes doctor及hermes update會顯示紅色通知，桌面版會顯示一次性強制回應視窗，hermes plugins list也會列出原因。給作者：hermes plugins compat <path>仍會列印每個使用舊路徑的位置，格式為file:line及舊路徑->新路徑；只要仍有任何項目存在，就會以狀態1結束（加入--json可取得機器可讀的輸出）。仍受未維護plugin所困的使用者，可在config.yaml中設定plugins.allow_deprecated_imports: true；它必須是字面YAML布林值，不能是加上引號的字串。由於刪除舊路徑的還原變更尚未實施，此設定目前仍然有效：在v2026.9.14、v2026.9.21、v2026.9.24，以及截至9月24日的main中，資訊清單與相容性墊片仍然存在（v0.21.4期間對相容性模組的變更，僅限於快取plugin掃描結果及正規化Windows路徑；v0.21.5期間未變更hermes_cli/plugin_compat.py，只移除了已刪除Hindsight模組的資訊清單項目）。該還原變更一旦實施，這個應急選項便會失效，因為舊路徑本身將不復存在。只有公開的頂層名稱受到涵蓋；私有名稱與測試用monkeypatch接縫從來都不是支援介面，也不會恢復。⁴²⁵³

設計原則

取自上游架構頁面：³

從 OpenClaw 遷移

Hermes Agent 是 OpenClaw 的後繼者。若要從現有的 OpenClaw 安裝環境遷移：⁶⁵

hermes claw migrate --dry-run                    # Preview what would be migrated
hermes claw migrate --preset full                # Full migration including API keys
hermes claw migrate --preset user-data --overwrite   # User data only, no secrets
hermes claw migrate --source /custom/path        # Non-default OpenClaw location

hermes claw migrate 預設會從 ~/.openclaw 讀取資料（也會自動偵測舊版的 ~/.clawdbot 與 ~/.moldbot 資料夾），並寫入 ~/.hermes。⁶

直接匯入（30 多個類別）：SOUL.md、MEMORY.md、USER.md、AGENTS.md、來自 4 個來源資料夾的 skills、預設模型、自訂提供者、MCP 伺服器、訊息平台權杖與允許清單（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、agent 預設值（推理強度、壓縮、人為延遲、時區、沙箱）、工作階段重設原則（目前不再生效：自 v0.21.1 起，計時器不會再輪替對話⁴³）、核准規則、TTS 設定、瀏覽器設定、工具設定、執行逾時、命令允許清單、gateway 設定，以及來自 3 個來源的 API 金鑰。⁶

封存以供人工檢閱：cron 工作、外掛程式、hooks/webhooks、記憶體後端（QMD）、skills 登錄設定、UI/身分識別、日誌、多 agent 設定、頻道繫結、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。⁶

API 金鑰解析會依優先順序檢查 3 個來源：設定值 → ~/.openclaw/.env → auth-profiles.json。⁶

疑難排解

「No inference provider configured. Run ‘hermes model’ to choose a provider and model」

這是每次全新安裝都會遇到的第一個錯誤：Hermes 尚未解析出任何提供者。訊息的意思很明確——3 種驗證途徑都未能產生可用的提供者。請執行：

hermes model

互動式選擇器會引導您設定所有支援的提供者，包括 OAuth 裝置代碼流程（Nous Portal、GitHub Copilot、Anthropic、OpenAI Codex），以及供自行託管伺服器使用的自訂端點。若原本預期提供者應已設定完成，hermes doctor 會顯示 Hermes 實際能偵測到哪些憑證。常見原因包括：API 金鑰設在錯誤的位置（應放在 .env 中或透過 hermes config set 設定，而非 shell profile）、~/.hermes/auth.json 中的 OAuth 憑證已過期，或 config.yaml 中的自訂端點遺失了 base_url。各種驗證途徑詳見驗證與提供者。²⁷

「API key not set」

執行 hermes model 以互動方式設定提供者，或執行 hermes config set OPENROUTER_API_KEY your_key。hermes doctor 命令會明確指出缺少哪些金鑰。⁷

啟動時出現「Context limit: 2048 tokens」（本機模型）

Hermes 會從伺服器的 /v1/models 端點自動偵測 context 長度，但許多本機伺服器回報的預設值偏低。請在 config.yaml 中明確設定：²

model:
  default: your-model
  provider: custom
  base_url: http://localhost:11434/v1
  context_length: 32768

工具呼叫顯示為文字，而未實際執行

您的伺服器尚未啟用工具呼叫，或該模型不支援透過此伺服器的實作方式進行工具呼叫。²

回應在句子中途遭到截斷

可能有兩個原因：²

1. 輸出上限過低（max_tokens）——SGLang 預設每次回應僅有 128 個 token。請在伺服器上設定 --default-max-tokens，或在 config.yaml 中設定 model.max_tokens。
2. Context 耗盡——模型已用完 context window。請提高 model.context_length，或在 Hermes 中啟用 context 壓縮。

從 WSL2 連線至 Windows 託管的模型伺服器時出現「Connection refused」

WSL2 使用具有獨立子網路的虛擬網路介面卡——WSL2 內的 localhost 指向 Linux 虛擬機器，而非 Windows 主機。有兩種解決方式：²

鏡像網路（Windows 11 22H2 以上版本）：編輯 %USERPROFILE%\.wslconfig：

[wsl2]
networkingMode=mirrored

接著執行 wsl --shutdown 並重新啟動。此後 localhost 即可雙向運作。

主機 IP 備援方案（較舊版本的 Windows）：從 WSL2 內取得 Windows 主機的 IP，並以該 IP 取代 localhost：

ip route show | grep -i default | awk '{ print $3 }'
# Use that IP as the base_url host

此外，模型伺服器必須繫結至 0.0.0.0，而不是 127.0.0.1——若使用 Ollama，請設定 OLLAMA_HOST=0.0.0.0；若使用 llama-server/SGLang，請加入 --host 0.0.0.0；若使用 LM Studio，請啟用「Serve on Network」。²

迭代預算未採用 agent.max_turns

若活動列顯示 N/90（或其他過時的上限），但 config.yaml 中設定的是 agent.max_turns: 500，可能是因為 ~/.hermes/.env 中仍殘留過時的 HERMES_MAX_ITERATIONS 項目。過去，設定精靈會將預算同時寫入兩個儲存位置；如果啟動橋接程序因先前的設定解析錯誤而提前中止，.env 中的幽靈設定便會悄然生效。自 v0.21.1 起，hermes doctor 會偵測這組遮蔽設定，而 hermes doctor --fix 會刪除 .env 中的該項目，讓 config.yaml 成為權威設定來源。⁴¹

所有項目都存放在哪裡？

此時，hermes status 和 hermes dump 是您的得力助手。hermes logs list 會顯示所有日誌檔案及其大小。hermes config path 會輸出設定檔的位置。hermes config env-path 則會輸出 .env 的位置。⁶

常見問題

Hermes Agent 和 Claude Code 有何不同？

Claude Code 是 Anthropic 官方推出的 CLI，僅限使用 Anthropic 模型。Hermes Agent 則是 Nous Research 推出的開放原始碼代理框架，可搭配任何與 OpenAI 相容的供應商，包括 Nous Portal、OpenRouter、Anthropic、GitHub Copilot、z.ai、Kimi、MiniMax、DeepSeek、Hugging Face、Google，或您自行託管的端點。¹² Hermes 還內建 Telegram/Discord/Slack/WhatsApp/Signal 的訊息 gateway，這是 Claude Code 所不具備的功能。

我可以使用 Anthropic API 金鑰搭配 Hermes 嗎？

可以，共有3種方式：²

1. 在 ~/.hermes/.env 中設定 ANTHROPIC_API_KEY，再執行 hermes chat --provider anthropic --model claude-sonnet-4-6
2. 執行 hermes model 並選取 Anthropic；若 Claude Code 的憑證儲存區可用，Hermes 將直接使用其中的憑證
3. 手動設定 ANTHROPIC_TOKEN（setup-token 或 OAuth token）作為備援

若已在同一台機器上使用 Claude Code，建議採用第2種方式，以便讓可重新整理的 Claude 憑證繼續自動更新。

如何切換供應商，又不遺失目前的對話？

在工作階段中使用 /model provider:model。對話紀錄、記憶與 skills 都會完整保留：⁹

/model zai:glm-5
/model openrouter:anthropic/claude-sonnet-4
/model custom:local:qwen-2.5

我已設定 Anthropic，但視覺／網頁／壓縮功能無法運作

在目前的版本中，舊有問題大多已不復存在。依預設（auxiliary.*.provider: "auto"），所有輔助工作——視覺、核准分類、壓縮、工作階段標題——都會使用您的主要聊天模型執行。因此，僅設定 Anthropic 時，這些工作也會使用現有的 OAuth。舊版預設行為（依序自動偵測 OpenRouter 的 Gemini Flash → Nous → Codex，若皆未設定則無聲降級）已經移除：「auto 現在一律使用主要模型，而 config.yaml 中各項工作的覆寫設定仍具有優先權。」³⁴

若輔助工作仍然失敗，請檢查是否有明確的個別工作覆寫設定指向尚未設定的供應商（config.yaml 中的 auxiliary.<task>.provider／.model），或仍留有舊版設定鍵。自標籤 v2026.8.31 起，壓縮摘要器的設定方式與其他輔助項目一致，使用 auxiliary.compression.provider；舊版的 compression.summary_* 設定鍵會自動遷移至此（設定版本17）。³¹ 網頁擷取已不再屬於 LLM 工作（「完全不涉及 LLM」），因此在目前版本中，網頁摘要失敗並非輔助模型所造成的問題。³⁴ 若要明確將某項工作固定使用主要供應商：

auxiliary:
  vision:      { provider: "main" }
  compression: { provider: "main" }

SOUL.md 和 AGENTS.md 有何不同？

SOUL.md 定義代理的身分，包括語氣、風格及預設溝通方式。此檔案位於 ~/.hermes/SOUL.md，無論在哪裡使用都會隨您套用。AGENTS.md 則專屬於個別專案，記錄架構、慣例、命令與路徑，並存放在專案目錄中。¹³ 若設定應在各處通用，請放入 SOUL.md；若僅適用於特定專案，則放入 AGENTS.md。

如何並行執行多個 Hermes 執行個體？

使用 profiles。每個 profile 都有各自的 HERMES_HOME、設定、記憶、工作階段及 gateway PID：⁶

hermes profile create work --clone
hermes profile use work                 # Sticky default
hermes -p work chat -q "..."            # One-off without switching
hermes profile alias work --name h-work # Wrapper script

Hermes 支援本機 LLM 嗎？

支援，可透過自訂端點使用。Hermes 可搭配任何與 OpenAI 相容的伺服器，例如 Ollama、vLLM、SGLang、llama.cpp/llama-server、LM Studio、LocalAI、Jan，或您自行架設的伺服器。² 各伺服器的設定方式請參閱自訂與自行託管的端點。

為什麼啟動畫面顯示的工具數量比本指南所述更少？

本指南引用上游架構登錄中的47項工具／20個 toolsets，這是 Hermes 在所有 toolset 中隨附原始碼的完整工具總數。實際執行的安裝版本在啟動畫面中會顯示較少的數量（本指南所用的參考安裝環境顯示28項工具），因為 Hermes 啟動時只會啟用預設的 toolset 組合。許多 toolsets 都必須選擇性啟用：訊息 gateway 介接器、瀏覽器自動化、較大型的資料擷取技術堆疊，以及多項專用整合，都必須明確列在 ~/.hermes/config.yaml 的 toolsets: 之下才會載入。登錄總數＝「啟用後可供使用的工具」。啟動畫面總數＝「目前 profile 實際載入的工具」。使用 hermes tools --list 可查看哪些 toolsets 已啟用，以及哪些可用但尚未啟用。若要在執行期間切換個別 toolset，請使用 /tools enable <name> 和 /tools disable <name>（停用時會重設工作階段，讓代理依據新的工具組合重新建立工具清單）。

主要供應商失效時，Hermes 如何處理模型備援？

在 config.yaml 中設定 fallback_model 區塊：²

fallback_model:
  provider: openrouter
  model: anthropic/claude-sonnet-4

主要供應商失效時（例如觸發速率限制、伺服器錯誤或驗證失敗），Hermes 會在工作階段進行期間切換至備援模型，且不會遺失對話紀錄。每個工作階段最多觸發1次。

代理能否隨時間持續改進自己的 skills？

可以，這正是 Hermes Agent「自我改進」的核心。代理可透過 skill_manage 工具建立、更新及刪除 skills。當它找出一套並非顯而易見的工作流程時，便會將其作法儲存為 skill，以供日後重複使用。¹¹ 完成複雜工作（呼叫工具5次以上）、遭遇錯誤並找出可行方法、您修正其處理方式，或發現一套不易掌握的工作流程時，代理都會建立 skills。

是否提供 IDE 整合？

有。Hermes 可作為 ACP（Agent Client Protocol）伺服器執行，並與 VS Code、Zed 及 JetBrains 搭配使用：⁶

pip install -e '.[acp]'
hermes acp

變更記錄