<!-- Source: https://hermesbible.com/docs/reference/cli-commands -->

本頁面介紹從終端機執行的命令列指令。

關於聊天中的斜線指令，請參閱斜線指令參考。

全域入口

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

全域選項

頂層指令

hermes chat

hermes chat [options]

常用選項：

範例：

hermes
hermes chat -q "Summarize the latest PRs"
hermes chat --provider openrouter --model anthropic/claude-sonnet-4.6
hermes chat --toolsets web,terminal,skills
hermes chat --quiet -q "Return only JSON"
hermes chat --worktree -q "Review this repo and open a PR"
hermes chat --ignore-user-config --ignore-rules -q "Repro without my personal setup"
hermes chat --safe-mode -q "Is this bug mine or Hermes'?"

hermes -z <prompt> — 腳本化一次性執行

對於程式化呼叫者（shell 腳本、CI、排程任務、父程序管道輸入提示），hermes -z 是最純粹的一次性入口點：單一提示輸入，最終回應文字輸出，stdout 或 stderr 上沒有其他內容。 沒有橫幅、沒有旋轉提示、沒有工具預覽、沒有 Session: 行 — 只有代理的最終回覆純文字。

hermes -z "What's the capital of France?"
# → Paris.

# Parent scripts can cleanly capture the response:
answer=$(hermes -z "summarize this" < /path/to/file.txt)

每次執行的覆蓋選項（不修改 ~/.hermes/config.yaml）：

hermes -z "…" --provider openrouter --model openai/gpt-5.5
# 或：
HERMES_INFERENCE_MODEL=anthropic/claude-sonnet-4.6 hermes -z "…"

相同的代理、相同的工具、相同的技能 — 只是移除了所有互動/裝飾層。如果需要在對話記錄中也包含工具輸出，請改用 hermes chat -q；-z 明確用於「我只需要最終答案」。

hermes model

互動式供應商 + 模型選擇器。這是新增供應商、設定 API 金鑰和執行 OAuth 流程的指令。 從你的終端機執行 — 而非在活躍的 Hermes 聊天對話中執行。

hermes model

適用於以下情境：

• 新增供應商（OpenRouter、Anthropic、Copilot、DeepSeek、自訂等）
• 登入支援 OAuth 的供應商（Anthropic、Copilot、Codex、Nous Portal）
• 輸入或更新 API 金鑰
• 從供應商專屬模型清單中選擇
• 設定自訂/自架端點
• 將新的預設值儲存至設定檔

注意 — hermes model 與 /model 的差異

hermes model（從你的終端機執行，在任何 Hermes 對話之外）是完整的供應商設定精靈。它可以新增供應商、執行 OAuth 流程、提示輸入 API 金鑰，並設定端點。

/model（在活躍的 Hermes 聊天對話中輸入）只能在你已設定的供應商和模型之間切換。它無法新增供應商、執行 OAuth 或提示輸入 API 金鑰。

如果需要新增供應商： 先退出你的 Hermes 對話（Ctrl+C 或 /quit），然後從終端機提示中執行 hermes model。

/model 斜線指令（對話中）

在不離開對話的情況下切換已設定的模型：

/model                              # 顯示目前模型和可用選項
/model claude-sonnet-4              # 切換模型（自動偵測供應商）
/model zai:glm-5                    # 切換供應商和模型
/model custom:qwen-2.5              # 使用自訂端點上的模型
/model custom                       # 從自訂端點自動偵測模型
/model custom:local:qwen-2.5        # 使用命名的自訂供應商
/model openrouter:anthropic/claude-sonnet-4  # 切換回雲端

預設情況下，/model 的變更僅適用於目前對話。加上 --global 可將變更持久化至 config.yaml：

/model claude-sonnet-4 --global     # 切換並儲存為新預設值

資訊 — 如果只看到 OpenRouter 模型怎麼辦？

如果你只設定了 OpenRouter，/model 只會顯示 OpenRouter 模型。要新增其他供應商（Anthropic、DeepSeek、Copilot 等），請退出對話並從終端機執行 hermes model。

供應商和 base URL 的變更會自動持久化至 config.yaml。切換離開自訂端點時，過時的 base URL 會被清除以防止洩漏到其他供應商。

hermes gateway

hermes gateway <subcommand>

子指令：

選項：

提示 — WSL 使用者

請使用 hermes gateway run 而非 hermes gateway start — WSL 的 systemd 支援不穩定。用 tmux 包裝以確保持久性：tmux new -s hermes 'hermes gateway run'。詳見 WSL FAQ。

hermes lsp

hermes lsp <subcommand>

管理 Language Server Protocol 整合。LSP 在背景執行真正的 語言伺服器（pyright、gopls、rust-analyzer、…），並將其診斷資訊 餵入 write_file 和 patch 使用的寫入後檢查。 受 git 工作區偵測限制 — LSP 僅在 cwd 或編輯的檔案位於 git worktree 內時才執行。

子指令：

參閱 LSP — 語義診斷 以取得完整指南、支援語言和設定選項。

hermes setup

hermes setup [model|tts|terminal|gateway|tools|agent] [--non-interactive] [--reset] [--quick] [--reconfigure] [--portal]

最簡路徑： hermes setup --portal — 透過 OAuth 登入 Nous Portal 並加入 Tool Gateway，一步完成。

首次執行： 啟動初次設定精靈。

回訪使用者（已設定）： 直接進入完整重新設定精靈 — 每個提示顯示你目前的值作為預設值，按 Enter 保留或輸入新值。沒有選單。

直接跳入特定區段而非完整精靈：

選項：

hermes portal

hermes portal [status|open|tools]

檢視 Nous Portal 認證、Tool Gateway 路由，並前往訂閱頁面。不帶子指令時執行 status。

閘道本身的設定請參閱 Tool Gateway。一次性設定路徑請參閱上方的 hermes setup --portal。

hermes whatsapp

hermes whatsapp

執行 WhatsApp 配對/設定流程，包括模式選擇和 QR 碼配對。

hermes slack

hermes slack manifest              # 將 manifest 輸出至 stdout
hermes slack manifest --write      # 寫入 ~/.hermes/slack-manifest.json
hermes slack manifest --slashes-only  # 僅輸出 features.slash_commands 陣列

產生一個 Slack app manifest，將 COMMAND_REGISTRY 中的每個閘道命令 （/btw、/stop、/model、…）註冊為一等的 Slack 斜線指令 — 與 Discord 和 Telegram 功能對等。將 輸出貼到你的 Slack app 設定中， https://api.slack.com/apps → 你的 app → Features → App Manifest → Edit，然後 Save。如果範圍或斜線指令有變更， Slack 會提示重新安裝。

在 hermes update 後重新執行 hermes slack manifest --write 以 取得任何新命令。

hermes send

hermes send --to <target> "message text"
hermes send --to <target> --file <path>
echo "message" | hermes send --to <target>
hermes send --list [platform]

將一次性訊息傳送至已設定的訊息平台，無需啟動代理或閘道迴圈。重用閘道已設定的憑證（~/.hermes/.env + ~/.hermes/config.yaml），因此作業腳本、排程任務、CI hook 和監控守護行程可以發送狀態更新，無需重新實作每個平台的 REST 客戶端。

對於使用 bot-token 的平台（Telegram、Discord、Slack、Signal、SMS、WhatsApp-CloudAPI），無需執行中的閘道 — hermes send 直接與平台的 REST 端點通訊。需要持久適配器的外掛平台仍需要活躍的閘道。

如果既未提供位置參數 message 也未提供 --file，hermes send 會在非 TTY 時從 stdin 讀取。退出碼：成功為 0，傳送/後端失敗為 1，使用錯誤為 2。

傳送圖片和其他媒體

--file 僅用於文字內文。要以原生平台附件形式傳送圖片、文件、視訊或音訊檔案，請在訊息文字中使用 MEDIA:<本地路徑> 指令引用：

hermes send --to telegram "MEDIA:/tmp/screenshot.png"
hermes send --to telegram "Build chart for today MEDIA:/tmp/chart.png"   # 附帶說明
hermes send --to discord:#ops "MEDIA:/tmp/report.pdf"

預設情況下，圖片檔案會以照片形式傳送（Telegram 等平台會重新壓縮）。在訊息中加上 [[as_document]] 可改為以未壓縮的檔案附件形式傳送：

hermes send --to telegram "[[as_document]] MEDIA:/tmp/screenshot.png"

範例：

hermes send --to telegram "deploy finished"
echo "RAM 92%" | hermes send --to telegram:-1001234567890
hermes send --to discord:#ops --file /tmp/report.md
hermes send --to slack:#eng --subject "[CI]" --file build.log
hermes send --list                  # 所有平台
hermes send --list telegram         # 按平台篩選

hermes secrets

hermes secrets bitwarden <subcommand>
hermes secrets bw <subcommand>          # 短別名

在程式啟動時從外部密鑰管理器拉取 API 金鑰，而非儲存在 ~/.hermes/.env 中。目前支援 Bitwarden Secrets Manager。完整指南請參閱：Bitwarden 整合。

bitwarden（別名 bw）子指令：

hermes migrate

hermes migrate <type>

診斷並（選擇性地）重寫活躍的 config.yaml，替換已淘汰模型或已棄用設定的引用。重寫前會對原始 config.yaml 進行帶時間戳的備份（使用 --no-backup 可跳過）。

遷移子指令的通用標記：

請勿與 hermes claw migrate（一次性將 OpenClaw 設定匯入 Hermes）混淆 — hermes migrate 是頂層的配置重寫指令。

hermes proxy

hermes proxy <subcommand>

執行一個本機 OpenAI 相容 HTTP 伺服器，將請求轉發至 OAuth 認證的上游供應商（例如 Nous Portal、xAI）。外部應用可指向該代理並使用任何 bearer token；代理會在轉發時附加你真實的 OAuth 憑證。完整指南請參閱訂閱代理。

hermes security

hermes security <subcommand>

按需掃描 OSV.dev 漏洞。涵蓋 Hermes venv（已安裝的 PyPI 發行版）、~/.hermes/plugins/ 下外掛宣告的 Python 相依性，以及 config.yaml 中鎖定的 npx/uvx MCP 伺服器。不掃描全域安裝的套件或編輯器/瀏覽器擴充套件。

audit 標記：

hermes login / hermes logout （已棄用）

注意

hermes login 已被移除。請使用 hermes auth 管理 OAuth 憑證，使用 hermes model 選擇供應商，或使用 hermes setup 進行完整的互動式設定。

hermes auth

管理同供應商金鑰輪替的憑證池。完整文件請參閱憑證池。

hermes auth                                              # 互動式精靈
hermes auth list                                         # 顯示所有池
hermes auth list openrouter                              # 顯示特定供應商
hermes auth add openrouter --api-key sk-or-v1-xxx        # 新增 API 金鑰
hermes auth add anthropic --type oauth                   # 新增 OAuth 憑證
hermes auth remove openrouter 2                          # 按索引移除
hermes auth reset openrouter                             # 清除冷卻期
hermes auth status anthropic                             # 顯示供應商的認證狀態
hermes auth logout anthropic                             # 登出並清除已儲存的認證狀態
hermes auth spotify                                      # 透過 PKCE 認證 Hermes 與 Spotify

子指令：add、list、remove、reset、status、logout、spotify。不帶子指令呼叫時，啟動互動式管理精靈。

hermes status

hermes status [--all] [--deep]

hermes cron

hermes cron <list|create|edit|pause|resume|run|remove|status|tick>

hermes kanban

hermes kanban [--board <slug>] <action> [options]

多設定檔、多專案協作看板。每個安裝可承載多個看板（每個專案、儲存庫或領域一個）；每個看板是一個獨立的佇列，有自己的 SQLite 資料庫和分派器範圍。新安裝會建立一個名為 default 的看板，其資料庫為 ~/.hermes/kanban.db（向後相容）；額外的看板位於 ~/.hermes/kanban/boards/<slug>/kanban.db。閘道內建的分派器每次 tick 會掃描所有看板。

全域標記（適用於以下所有操作）：

這是人類/腳本化操作介面。 分派器產生的代理工作者透過專屬的 kanban_* 工具集（kanban_show、kanban_complete、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat；協調器設定檔還會有 kanban_list 和 kanban_unblock）驅動看板，而非透過 shell 執行 hermes kanban。工作者的環境中釘選了 HERMES_KANBAN_BOARD，因此它們實際上無法看到其他看板。

範例：

# 建立第二個看板並在其上建立任務，無需切換。
hermes kanban boards create atm10-server --name "ATM10 Server" --icon 🎮
hermes kanban --board atm10-server create "Restart server" --assignee ops

# 為後續呼叫切換活躍看板。
hermes kanban boards switch atm10-server
hermes kanban list                  # 顯示 atm10-server 的任務

# 封存看板（可恢復）或永久刪除。
hermes kanban boards rm atm10-server
hermes kanban boards rm atm10-server --delete

看板解析順序（最高優先度在前）：--board <slug> 標記 → HERMES_KANBAN_BOARD 環境變數 → ~/.hermes/kanban/current 檔案 → default。

所有操作也可在閘道中作為斜線指令使用（/kanban …），具有相同的操作介面 — 包括 boards 子指令和 --board 標記。

完整設計 — 與 Cline Kanban / Paperclip / NanoClaw / Gemini Enterprise 的比較、八種協作模式、四個使用者故事、並行正確性證明 — 請參閱儲存庫中的 docs/hermes-kanban-v1-spec.pdf 或 Kanban 使用者指南。

hermes webhook

hermes webhook <subscribe|list|remove|test>

管理事件驅動代理觸發的動態 webhook 訂閱。需要在設定中啟用 webhook 平台 — 如未設定，會顯示設定指示。

hermes webhook subscribe

hermes webhook subscribe <name> [options]

訂閱持久化至 ~/.hermes/webhook_subscriptions.json，由 webhook 適配器熱重載，無需重啟閘道。

hermes doctor

hermes doctor [--fix]

hermes dump

hermes dump [--show-keys]

輸出你整個 Hermes 設定的精簡純文字摘要。設計用於在 Discord、GitHub issues 或 Telegram 中複製貼上以尋求支援 — 沒有 ANSI 顏色、沒有特殊格式，只有資料。

包含內容

範例輸出

--- hermes dump ---
version:          0.8.0 (2026.4.8) [af4abd2f]
os:               Linux 6.14.0-37-generic x86_64
python:           3.11.14
openai_sdk:       2.24.0
profile:          default
hermes_home:      ~/.hermes
model:            anthropic/claude-opus-4.6
provider:         openrouter
terminal:         local

api_keys:
  openrouter           set
  openai               not set
  anthropic            set
  nous                 not set
  firecrawl            set
  ...

features:
  toolsets:           all
  mcp_servers:        0
  memory_provider:    built-in
  gateway:            running (systemd)
  platforms:          telegram, discord
  cron_jobs:          3 active / 5 total
  skills:             42

config_overrides:
  agent.max_turns: 250
  compression.threshold: 0.85
  display.streaming: True
--- end dump ---

適用時機

• 在 GitHub 上回報錯誤 — 將 dump 貼到你的 issue 中
• 在 Discord 中尋求幫助 — 在程式碼區塊中分享
• 將你的設定與他人比較
• 當某些功能無法運作時快速健全性檢查

提示

hermes dump 專為分享而設計。互動式診斷請使用 hermes doctor。視覺化概覽請使用 hermes status。

hermes debug

hermes debug share [options]

上傳除錯報告（系統資訊 + 近期日誌）至貼上服務並取得可分享的 URL。適用於快速支援請求 — 包含協助者診斷你的問題所需的一切。

報告包含系統資訊（作業系統、Python 版本、Hermes 版本）、近期代理和閘道日誌（每個檔案 512 KB 限制），以及遮蔽的 API 金鑰狀態。金鑰始終被遮蔽 — 不會上傳密鑰。

依序嘗試的貼上服務：paste.rs、dpaste.com。

範例

hermes debug share              # 上傳除錯報告，列印 URL
hermes debug share --lines 500  # 包含更多日誌行
hermes debug share --expire 30  # 保留貼上 30 天
hermes debug share --local      # 將報告列印到終端（不上傳）

hermes backup

hermes backup [options]

建立你 Hermes 設定、技能、對話和資料的 zip 壓縮檔。備份不包含 hermes-agent 程式碼本身。

備份使用 SQLite 的 backup() API 進行安全複製，因此即使 Hermes 正在執行也能正確運作（WAL 模式安全）。

zip 中排除的內容：

• *.db-wal、*.db-shm、*.db-journal — SQLite 的 WAL / 共用記憶體 / 日誌側車檔案。*.db 檔案已透過 sqlite3.backup() 取得一致快照；與其一起打包即時側車檔案會讓還原看到半提交的狀態。
• checkpoints/ — 每個對話的軌跡快取。以雜湊鍵值化且每個對話重新產生；無法完整移殖到其他安裝。
• hermes-agent 程式碼本身（這是使用者資料備份，不是儲存庫快照）。

範例

hermes backup                           # 完整備份至 ~/hermes-backup-*.zip
hermes backup -o /tmp/hermes.zip        # 完整備份至指定路徑
hermes backup --quick                   # 僅包含狀態的快速快照
hermes backup --quick --label "pre-upgrade"  # 帶標籤的快速快照

hermes checkpoints

hermes checkpoints [COMMAND]

檢視和管理 ~/.hermes/checkpoints/ 中的影子 git 儲存 — 這是對話中 /rollback 指令的儲存層。可隨時安全執行；不需要代理正在執行。

選項

範例

hermes checkpoints                                  # 狀態概覽
hermes checkpoints prune --retention-days 3         # 積極清理
hermes checkpoints prune --max-size-mb 200          # 一次性收緊大小上限
hermes checkpoints clear-legacy -f                  # 丟棄 v1 封存目錄
hermes checkpoints clear -f                         # 清除所有內容

完整架構和對話中指令請參閱 Checkpoints 和 /rollback。

hermes import

hermes import <zipfile> [options]

將先前建立的 Hermes 備份還原到你的 Hermes 主目錄。壓縮檔中的所有檔案會覆蓋你 Hermes 主目錄中的現有檔案；--force 僅在目標已有 Hermes 安裝時跳過確認提示。

警告

匯入前請停止閘道，以避免與執行中的程序產生衝突。

範例

hermes import ~/hermes-backup-20260423.zip           # 匯入前提示是否覆蓋現有設定
hermes import ~/hermes-backup-20260423.zip --force   # 直接覆蓋不提示

hermes logs

hermes logs [log_name] [options]

檢視、追蹤和篩選 Hermes 日誌檔案。所有日誌儲存在 ~/.hermes/logs/（非預設設定檔為 <profile>/logs/）。

日誌檔案

選項

範例

# 檢視 agent.log 的最後 50 行（預設）
hermes logs

# 即時追蹤 agent.log
hermes logs -f

# 檢視 gateway.log 的最後 100 行
hermes logs gateway -n 100

# 僅顯示過去一小時的警告和錯誤
hermes logs --level WARNING --since 1h

# 按特定對話篩選
hermes logs --session abc123

# 從 30 分鐘前開始追蹤 errors.log
hermes logs errors --since 30m -f

# 列出所有日誌檔案及其大小
hermes logs list

篩選

篩選器可以組合使用。當多個篩選器啟用時，日誌行必須通過所有篩選器才會顯示：

# 過去 2 小時內包含 session "tg-12345" 的 WARNING+ 等級行
hermes logs --level WARNING --since 2h --session tg-12345

沒有可解析時間戳的行在 --since 啟用時會被包含（它們可能是多行日誌項目的延續行）。沒有可偵測等級的行在 --level 啟用時會被包含。

日誌輪替

Hermes 使用 Python 的 RotatingFileHandler。舊日誌會自動輪替 — 尋找 agent.log.1、agent.log.2 等。hermes logs list 子指令顯示所有日誌檔案，包括已輪替的。

hermes prompt-size

hermes prompt-size [--platform <name>] [--json]

報告全新對話的固定提示預算 — 在任何對話內容之前，每次 API 呼叫都會發送的內容。適用於下游適配器或代理的提示預算比模型的上下文視窗更緊湊時，或想查看哪個區塊（技能索引、記憶、設定檔）佔比最大。

它會建立代理會使用的相同系統提示，然後進行分解：

• 系統提示總計 — 完整組裝的提示（身分、指引、技能 索引、上下文檔案、記憶、設定檔、時間戳）。
• 技能索引 — <available_skills> 區塊。當安裝了大量技能時， 這通常是最大的單一區塊。
• 記憶和使用者設定檔 — 你的 MEMORY.md / USER.md 快照。
• 提示分層 — 穩定 / 上文 / 易變，對應 Hermes 為了快取友善性 而對提示進行的分層方式。
• 工具 schema — 所有已啟用工具的 JSON（固定每次呼叫負載的另一半）。

完全離線執行 — 無需 API 呼叫，無需設定憑證即可運作。

# CLI 平台的人類可讀明細（預設）
hermes prompt-size

# 模擬訊息平台的提示（不同的平台提示）
hermes prompt-size --platform telegram

# 腳本用的機器可讀輸出
hermes prompt-size --json

提示

技能索引和工具 schema 會隨著你啟用的技能和工具數量而增加。 要縮減提示，請停用未使用的工具集（hermes tools）或 解除安裝不需要的技能（hermes skills）。你目前目錄中的上下文檔案（AGENTS.md、 .cursorrules）也計入總量。

hermes config

hermes config <subcommand>

子指令：

hermes pairing

hermes pairing <list|approve|revoke|clear-pending>

hermes skills

hermes skills <subcommand>

子指令：

常用範例：

hermes skills browse
hermes skills browse --source official
hermes skills search react --source skills-sh
hermes skills search https://mintlify.com/docs --source well-known
hermes skills inspect official/security/1password
hermes skills inspect skills-sh/vercel-labs/json-render/json-render-react
hermes skills install official/migration/openclaw-migration
hermes skills install skills-sh/anthropics/skills/pdf --force
hermes skills install https://sharethis.chat/SKILL.md                     # 直接 URL（單一檔案 SKILL.md）
hermes skills install https://example.com/SKILL.md --name my-skill        # frontmatter 沒有名稱時覆蓋名稱
hermes skills check
hermes skills update
hermes skills config
hermes skills reset google-workspace
hermes skills reset google-workspace --restore --yes
hermes skills opt-out                  # 停止未來的內建技能植入（不刪除任何內容）
hermes skills opt-out --remove --yes   # 同時刪除未修改的內建技能
hermes skills opt-in --sync            # 撤銷：移除標記並立即重新植入

備註：

• --force 可覆蓋第三方/社群技能的非危險策略區塊。
• --force 無法覆蓋 dangerous 的掃描結論。
• --source skills-sh 搜尋公開的 skills.sh 目錄。
• --source well-known 讓你將 Hermes 指向暴露 /.well-known/skills/index.json 的網站。
• --source browse-sh 搜尋 browse.sh 的 200+ 網站專屬瀏覽器自動化技能目錄。識別碼格式如 browse-sh/airbnb.com/search-listings-ddgioa。
• 傳入 http(s)://…/*.md URL 會直接安裝單一檔案 SKILL.md。當 frontmatter 沒有 name: 且 URL slug 不是有效識別碼時，互動式終端會提示輸入名稱；非互動式介面（TUI 中的 /skills install、閘道平台）需要使用 --name <x>。

hermes bundles

hermes bundles <subcommand>

技能套件將多個技能組合在單一 /<bundle-name> 斷線指令下。呼叫套件會將每個引用的技能載入單一組合的使用者訊息。儲存位置：~/.hermes/skill-bundles/<slug>.yaml。YAML 架構和行為請參閱技能套件。

子指令：

範例：

hermes bundles create backend-dev \
  --skill github-code-review \
  --skill test-driven-development \
  --skill github-pr-workflow \
  -d "Backend feature work"

hermes bundles list
hermes bundles show backend-dev
hermes bundles delete backend-dev

在聊天對話中，/bundles 列出已安裝的套件，/<bundle-name> 載入一個。

hermes curator

hermes curator <subcommand>

Curator 是一個輔助模型背景任務，定期檢視代理建立的技能、修剪過時的技能、整合重疊的部分，並封存過時的技能。內建和 hub 安裝的技能永遠不會被觸碰。封存是可恢復的；永遠不會自動刪除。

在全新安裝中，首次排程的擊次會延後一個完整的 interval_hours（預設 7 天）— 閘道不會在 hermes update 後的首次 tick 時立即進行整理。在此之前使用 hermes curator run --dry-run 預覽。

行為和設定請參閱 Curator。

hermes fallback

hermes fallback <subcommand>

管理備用供應商鏈。當主要模型因速率限制、過載或連線錯誤而失敗時，依序嘗試備用供應商。

參閱備用供應商。

hermes hooks

hermes hooks <subcommand>

檢視在 ~/.hermes/config.yaml 中宣告的 shell 腳本 hook，使用合成 payload 測試它們，並管理 ~/.hermes/shell-hooks-allowlist.json 中的首次使用同意白名單。

事件簽名和 payload 格式請參閱 Hooks。

hermes memory

hermes memory <subcommand>

設定和管理外部記憶供應商外掛。可用供應商：honcho、openviking、mem0、hindsight、holographic、retaindb、byterover、supermemory。同一時間只能有一個外部供應商處於活躍狀態。內建記憶（MEMORY.md/USER.md）始終活躍。

子指令：

資訊 — 供應商專屬子指令

當外部記憶供應商處於活躍狀態時，它可能會註冊自己的頂層 hermes <provider> 指令用於供應商專屬管理（例如 Honcho 活躍時的 hermes honcho）。非活躍的供應商不會暴露其子指令。執行 hermes --help 查看目前有哪些指令。

hermes acp

hermes acp

將 Hermes 作為 ACP（Agent Client Protocol）stdio 伺服器啟動，用於編輯器整合。

相關入口：

hermes-acp
python -m acp_adapter

請先安裝支援：

pip install -e '.[acp]'

參閱 ACP 編輯器整合和 ACP 內部機制。

hermes mcp

hermes mcp <subcommand>

管理 MCP（Model Context Protocol）伺服器設定，並將 Hermes 作為 MCP 伺服器執行。

參閱 MCP 設定參考、在 Hermes 中使用 MCP 和 MCP 伺服器模式。

hermes plugins

hermes plugins [subcommand]

統一的外掛管理 — 一般外掛、記憶供應商和上下文引擎集中管理。不帶子指令執行 hermes plugins 會開啟一個組合互動畫面，包含兩個區段：

• 一般外掛 — 多選複選框用於啟用/停用已安裝的外掛
• 供應商外掛 — 記憶供應商和上下文引擎的單選設定。按 ENTER 開啟無線電選擇器。

供應商外掛選擇會儲存至 config.yaml：

• memory.provider — 活躍的記憶供應商（空值 = 僅內建）
• context.engine — 活躍的上下文引擎（"compressor" = 內建預設）

一般外掛停用清單儲存在 config.yaml 的 plugins.disabled 下。

參閱外掛和建立 Hermes 外掛。

hermes tools

hermes tools [--summary]

不帶 --summary 時，這會啟動互動式的按平台工具設定 UI。

hermes computer-use

hermes computer-use <subcommand>

子指令：

hermes computer-use install 是安裝 cua-driver 二進位檔案的穩定入口點， 供 computer_use 工具集使用。它執行與 hermes tools 在你首次啟用 Computer Use 時呼叫的相同上游安裝程式，因此可以安全地 用於在工具集切換未觸發安裝時重新執行（例如在回訪使用者設定中）。

hermes update 會在更新結束時自動重新執行上游安裝程式（如果 cua-driver 在 PATH 上），因此大多數使用者不需要 手動呼叫 --upgrade。當上游發佈了你想要立即取得的修復而不想等待下一次 Hermes 更新時使用它。

hermes sessions

hermes sessions <subcommand>

子指令：

hermes insights

hermes insights [--days N] [--source platform]

hermes claw

hermes claw migrate [options]

將你的 OpenClaw 設定遷移至 Hermes。從 ~/.openclaw（或自訂路徑）讀取並寫入 ~/.hermes。自動偵測舊版目錄名稱（~/.clawdbot、~/.moltbot）和設定檔名稱（clawdbot.json、moltbot.json）。

遷移內容

遷移涵蓋 30+ 個類別，包括角色、記憶、技能、模型供應商、訊息平台、代理行為、對話策略、MCP 伺服器、TTS 等。項目會被直接匯入至 Hermes 對應項或封存以供手動審查。

直接匯入： SOUL.md、MEMORY.md、USER.md、AGENTS.md、技能（4 個來源目錄）、預設模型、自訂供應商、MCP 伺服器、訊息平台 token 和白名單（Telegram、Discord、Slack、WhatsApp、Signal、Matrix、Mattermost）、代理預設值（推理強度、壓縮、人類延遲、時區、沙箱）、對話重置策略、核准規則、TTS 設定、瀏覽器設定、工具設定、exec 逾時、命令白名單、閘道設定，以及來自 3 個來源的 API 金鑰。

封存以供手動審查： 排程工作、外掛、hook/webhook、記憶後端（QMD）、技能登錄設定、UI/身分、日誌、多代理設定、頻道綁定、IDENTITY.md、TOOLS.md、HEARTBEAT.md、BOOTSTRAP.md。

API 金鑰解析按優先順序檢查三個來源：設定值 → ~/.openclaw/.env → auth-profiles.json。所有 token 欄位支援純字串、env 範本（${VAR}）和 SecretRef 物件。

完整設定對應、SecretRef 處理細節和遷移後清單，請參閱**完整遷移指南**。

範例

# 預覽將被遷移的內容
hermes claw migrate --dry-run

# 完整遷移（所有相容設定，不含密鑰）
hermes claw migrate --preset full

# 完整遷移包含 API 金鑰
hermes claw migrate --preset full --migrate-secrets

# 僅遷移使用者資料（不含密鑰），覆蓋衝突
hermes claw migrate --preset user-data --overwrite

# 從自訂 OpenClaw 路徑遷移
hermes claw migrate --source /home/user/old-openclaw

hermes dashboard

hermes dashboard [options]

啟動網頁控制面板 — 用於管理設定、API 金鑰和監控對話的瀏覽器 UI。需要 pip install hermes-agent[web]（FastAPI + Uvicorn）。內建瀏覽器的聊天分頁始終可用，另外需要 pty 附加元件（pip install 'hermes-agent[web,pty]'）以及 POSIX PTY 環境（如 Linux、macOS 或 WSL2）。完整文件請參閱網頁控制面板。

# 預設 — 開啟瀏覽器至 http://127.0.0.1:9119
hermes dashboard

# 自訂連接埠，不開瀏覽器
hermes dashboard --port 8080 --no-open

# 從設定檔別名 — 路由至機器控制面板，在側邊欄切換器中
# 預選該設定檔（執行中則連線）
worker dashboard

hermes profile

hermes profile <subcommand>

管理設定檔 — 多個隔離的 Hermes 實例，每個都有自己的設定、對話、技能和主目錄。

範例：

hermes profile list
hermes profile create work --clone
hermes profile use work
hermes profile alias work --name h-work
hermes profile export work -o work-backup.tar.gz
hermes profile import work-backup.tar.gz --name restored
hermes profile install github.com/user/my-distro --alias
hermes profile update work
hermes -p work chat -q "Hello from work profile"

hermes completion

hermes completion [bash|zsh|fish]

將 shell 自動完成腳本列印至 stdout。在你的 shell 設定檔中 source 輸出以取得 Hermes 指令、子指令和設定檔名稱的 Tab 自動完成。

範例：

# Bash
hermes completion bash >> ~/.bashrc

# Zsh
hermes completion zsh >> ~/.zshrc

# Fish
hermes completion fish > ~/.config/fish/completions/hermes.fish

hermes update

hermes update [--gateway] [--check] [--no-backup] [--backup] [--yes]

拉取最新的 hermes-agent 程式碼並在你的 venv 中重新安裝相依性，然後重新執行安裝後 hook（MCP 伺服器、技能同步、完成安裝）。可在活躍安裝上安全執行。

pip 安裝： hermes update 會自動偵測基於 pip 的安裝 — 它向 PyPI 查詢最新發行版並執行 pip install --upgrade hermes-agent 而非 git pull。PyPI 發行版追蹤標籤版本（主要/次要發行版），而非 main 上的每個提交。使用 --check 查看是否有更新的 PyPI 發行版可用而不安裝。

git 安裝： hermes update 拉取設定的更新分支（預設：main）。如果你的 checkout 在另一個分支上，Hermes 可能在拉取前切換到更新分支。在更新前提交分支工作，如果你想將其保留在更新自動 stash 流程之外。

額外行為：

• 閘道重啟。 成功更新後，Hermes 會嘗試自動重啟所有執行中的閘道設定檔以取得新程式碼。想要重啟閘道但不套用更新時，請使用 hermes gateway restart。
• 本機來源變更。 對於 git 安裝，分支切換或拉取前會自動 stash 有變更的已追蹤檔案和未追蹤檔案（git stash push --include-untracked）。互動式終端更新會在還原 stash 前詢問。非互動式更新預設會還原；僅在管理安裝上設定 updates.non_interactive_local_changes: discard，使本機來源編輯在成功拉取後被丟棄。如果 stash 還原衝突或拉取失敗，stash 會保留供手動恢復。
• npm lockfile 變動。 在 stash 或切換分支前，Hermes 會盡最大努力清理 npm install/build 步驟產生的已追蹤 package-lock.json 差異。在執行 hermes update 前提交或手動 stash 有意的 lockfile 編輯。
• 配對資料快照。 即使 --backup 關閉，hermes update 也會在 git pull 前對 ~/.hermes/pairing/ 和 Feishu 評論規則進行輕量級快照。如果拉取重寫了你正在編輯的檔案，你可以使用 hermes backup restore --state pre-update 還原。
• 舊版 hermes.service 警告。 如果 Hermes 偵測到更名前的 hermes.service systemd 單元（而非目前的 hermes-gateway.service），它會顯示一次性的遷移提示以避免震盪迴圈問題。
• 退出碼。 成功為 0，拉取/安裝/安裝後錯誤為 1，阻擋 git pull 的意外工作區變更為 2。

維護指令

參見

• 斜線指令參考
• CLI 介面
• 對話
• 技能系統
• 外觀與主題

---

---

斜線指令參考