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

章節：參考 · URL：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 script、CI、cron、管道輸入提示的父程序）使用，hermes -z 是最純粹的一次性入口點：單一提示輸入，最終回應文字輸出，stdout 和 stderr 上沒有其他內容。 無橫幅、無旋轉指示器、無工具預覽、無 Session: 行 — 只有代理的最終回覆以純文字形式呈現。

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

# 父腳本可以乾淨地擷取回應：
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 聊天 session 中執行。

hermes model

在以下情況使用：

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

警告 — hermes model 與 /model 的差異

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

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

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

/model 斜線指令（session 中）

在不離開 session 的情況下，在已設定的模型之間切換：

/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 的變更僅對目前 session 生效。加上 --global 可將變更持久化至 config.yaml：

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

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

如果你只設定了 OpenRouter，/model 只會顯示 OpenRouter 模型。要新增其他供應商（Anthropic、DeepSeek、Copilot 等），請離開你的 session 並從終端機執行 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 常見問題。

hermes lsp

hermes lsp <subcommand>

管理 Language Server Protocol 整合。LSP 在背景執行真正的語言伺服器（pyright、gopls、rust-analyzer…），並將其診斷結果餵入 write_file 和 patch 使用的寫入後檢查。受 git 工作區偵測限制 — LSP 僅在目前目錄或編輯的檔案位於 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 code 配對。

hermes slack

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

產生 Slack 應用程式清單，將 COMMAND_REGISTRY 中的每個閘道指令（/btw、/stop、/model…）註冊為一等 Slack 斜線指令 — 與 Discord 和 Telegram 功能對齊。將輸出貼到你的 Slack 應用程式設定中：https://api.slack.com/apps → 你的應用程式 → 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），讓運維腳本、cron job、CI hook 和監控守護行程可以發送狀態更新，無需重新實作每個平台的 REST client。

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

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

傳送圖片和其他媒體

--file 僅用於文字正文。要以原生平台附件形式傳遞圖片、文件、影片或音訊檔案，請在訊息文字中使用 MEDIA:<local_path> 指令參照：

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]

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

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

這是人類/腳本化操作介面。 調度器產生的 agent worker 透過專用的 kanban_* 工具集（kanban_show、kanban_complete、kanban_block、kanban_create、kanban_link、kanban_comment、kanban_heartbeat；協調器 profile 還有 kanban_list 和 kanban_unblock）驅動看板，而非呼叫 hermes kanban。Worker 的環境中固定了 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>

管理用於事件驅動 agent 啟用的動態 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 版本）、近期 agent 和閘道日誌（每個檔案 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 設定、技能、session 和資料的 zip 壓縮檔。備份不包含 hermes-agent 程式碼本身。

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

zip 中排除的內容：

• *.db-wal、*.db-shm、*.db-journal — SQLite 的 WAL / 共用記憶體 / journal 附屬檔案。*.db 檔案已透過 sqlite3.backup() 取得一致的快照；將即時附屬檔案一起包含會讓還原看到半提交的狀態。
• checkpoints/ — 每個 session 的軌跡快取。以雜湊鍵控且每個 session 重新產生；無法乾淨地移植到另一個安裝。
• 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 儲存 — 這是 session 內 /rollback 指令的儲存層。可隨時安全執行；無需 agent 正在運行。

選項

範例

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 以取得完整架構和 session 內指令。

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 為 <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

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

# 追蹤 errors.log，從 30 分鐘前開始
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]

報告新 session 的固定提示預算 — 在任何對話內容之前，每次 API 呼叫都會發送的內容。當下游適配器或代理的提示預算比模型的上下文視窗更緊張時很有用，或當你想了解哪個區塊（技能索引、記憶體、profile）佔比最大時。

它會建立與 agent 相同的系統提示，然後將其分解：

• 系統提示總計 — 完整組裝的提示（身份、指引、技能索引、上下文檔案、記憶體、profile、時間戳）。
• 技能索引 — <available_skills> 區塊。安裝大量技能時通常是最大的單一區塊。
• 記憶體和使用者 profile — 你的 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 schema 和行為。

子指令：

範例：

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

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

hermes curator

hermes curator <subcommand>

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

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

請參閱 Curator 以了解行為和設定。

hermes fallback

hermes fallback <subcommand>

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

請參閱備援供應商。

hermes hooks

hermes hooks <subcommand>

檢視在 ~/.hermes/config.yaml 中宣告的 shell script hook，使用合成負載測試它們，並管理 ~/.hermes/shell-hooks-allowlist.json 中的首次使用同意允許清單。

請參閱 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 是安裝 computer_use 工具集所使用的 cua-driver 執行檔的穩定入口點。它執行的上游安裝程式與你首次啟用 Computer Use 時 hermes tools 呼叫的相同，因此可以安全地在工具集切換未觸發安裝時重新執行（例如在回訪使用者設定中）。

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 多個類別，包括角色、記憶體、技能、模型供應商、訊息平台、agent 行為、session 策略、MCP 伺服器、TTS 等。項目會被直接匯入到 Hermes 對應項目中或封存供人工檢視。

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

封存供人工檢視： 排程作業、外掛、hook/webhook、記憶體後端（QMD）、技能登錄設定、UI/身份、日誌、多 agent 設定、頻道綁定、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]

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

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

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

# 從 profile 別名 — 路由到機器控制面板，側邊欄切換器中
# 預選該 profile（運行中時附加）
worker dashboard

hermes profile

hermes profile <subcommand>

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

範例：

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 profile 中 source 輸出內容，以取得 Hermes 指令、子指令和 profile 名稱的 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 可能會在拉取前簽出更新分支。在更新前提交分支工作，如果你希望將其保留在更新自動儲存流程之外。

額外行為：

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

維護指令

另請參閱

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

---

---

斜線指令參考