全在這裡了！我把 Hermes Agent 學透後，整理出 80+ 條命令和用法（含教程）

2026年9月5日· #Hermes #AI Agent #教學 #技術隨筆 #轉載

本文轉載自知乎專欄，原文：https://zhuanlan.zhihu.com/p/2029680669119246545

大家好，下面的命令需要在終端裡執行。

Mac 使用者開啟終端就行，Windows 使用者需要先裝 WSL2，裝好之後開啟 Ubuntu 終端再操作，文末避坑部分有詳細步驟。

前面的文章我們介紹了 Hermes Agent 是什麼以及如何接入個人微信。

# 新使用者，一行裝好
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 裝完過載一下 shell
source ~/.bashrc   # zsh 使用者換成 source ~/.zshrc

# 老使用者，直接更新
hermes update

那麼，除了和hermes聊天，還能幹啥？

命令那麼多，從哪裡開始？

國內的模型能接嗎？

這篇我就一次性全說清楚。

▍ 有多少東西

先說一下這篇的資訊量。

Hermes 能接的AI模型，國內國外加起來超過 20 個，DeepSeek、Kimi、通義千問、智譜 GLM、MiniMax 全都支援，每個怎麼配我都寫了。

光命令就有 80 多條。

頂層的 CLI 命令 30 多個，進入聊天之後還有 50 多條斜槓指令，本文按「你想做什麼」幫你分好類了，不用全記，收藏備查就好。

它有個技能商店，裡面 644 個外掛，覆蓋 GitHub、寫作、研究、機器學習等 16 個方向，一行命令裝好。

它不是一個聊天框，是 9 個模組拼起來的完整系統，能說話、能自動化、能接瀏覽器、能定時跑任務。

▍ 第一類：啟動和會話管理

最基礎的一類，剛裝好就會用到。

你想啟動 Hermes，就這個👇

hermes
# 或者
hermes chat

你想繼續上次沒聊完的對話👇

hermes --continue
# 簡寫
hermes -c

退出的時候 Hermes 會列印一行恢復命令，下次直接複製貼上就行。

你想啟動時就指定模型、工具集、技能👇

新手跳過這塊也沒關係，進聊天之後用 /model 隨時切換就行。這裡是給想用命令列引數的朋友備查的。

# 指定模型
hermes chat -m deepseek/deepseek-chat

# 指定工具集
hermes chat -t web,debugging

# 預載入技能
hermes chat -s github-pr-workflow

# 單次提問，不進入聊天介面
hermes chat -q "幫我寫一個 Python 爬蟲"

# 安靜模式，適合指令碼呼叫，只輸出最終回答
hermes chat -q "今天天氣怎麼樣" --quiet

# 限制每輪最多工具呼叫次數（預設 90）
hermes chat --max-turns 30

# 在獨立 Git worktree 裡跑，適合多個 Agent 同時改同一個倉庫
hermes chat --worktree

# 開啟檔案系統檢查點，改壞了可以 /rollback 回來
hermes chat --checkpoints

你想按名字找回某個會話👇

hermes --resume 會話名

你想管理歷史會話，有一整套子命令👇

hermes sessions list      # 列出所有歷史會話
hermes sessions browse    # 互動式翻找，像檔案管理器
hermes sessions rename ID 新名字   # 給會話改個好記的名字
hermes sessions export 檔名      # 匯出成 JSONL 檔案
hermes sessions delete ID          # 刪掉某個會話
hermes sessions prune              # 批次清理舊會話
hermes sessions stats              # 看儲存統計

有一個細節值得說。

Hermes 的所有對話都自動存在本地，格式是 SQLite 加 Markdown 雙份，不會丟。

好用的快捷鍵👇

Alt+Enter — 多行輸入換行，貼上程式碼或寫長提示詞的時候用

圖：Hermes 啟動後的歡迎橫幅

▍ 第二類：配置和模型切換

這類命令解決一個問題，隨時換模型、改配置，不用重灌。

你想換一個模型👇

hermes model

會彈出互動式選單，上下鍵選，回車確認，10 秒搞定。

國內可以用的模型，重點說一下👇

提供商	支援的模型	配置方式
—––	———	———
DeepSeek	DeepSeek-V3、R1 等	設定 DEEPSEEK_API_KEY
Kimi / Moonshot	編碼和聊天模型	設定 KIMI_API_KEY
通義千問 / 阿里雲	Qwen 系列	設定 DASHSCOPE_API_KEY
智譜 GLM / Z.AI	GLM 系列	設定 GLM_API_KEY
MiniMax	國際端點	設定 MINIMAX_API_KEY
MiniMax 國內	國內端點	設定 MINIMAX_CN_API_KEY

國外提供商也都支援👇

提供商	說明	配置方式
Nous Portal	訂閱制，零配置直接用	hermes login
Anthropic	Claude 系列	hermes model 認證或設定 API Key
OpenAI Codex	GPT 系列	hermes model 裝置碼認證
OpenRouter	多提供商路由，一個 Key 用所有模型	設定 API Key
GitHub Copilot	GPT-5.x、Claude 等	OAuth 或設定 COPILOT_GITHUB_TOKEN
Hugging Face	Qwen、DeepSeek 等 20+ 開源模型	設定 HF_TOKEN
Vercel AI Gateway	Vercel 路由	設定 AI_GATEWAY_API_KEY

自己有本地模型或私有端點也能接👇

Ollama、vLLM、SGLang 這類 OpenAI 相容的 API 都行，hermes model 裡選「Custom Endpoint」，填 base URL 和 API Key，上下文視窗大小會自動檢測。

不知道怎麼設定環境變數的，最簡單的方式是在 ~/.hermes/.env 檔案里加一行👇

DEEPSEEK_API_KEY=你的key

或者裝好 Hermes 之後，直接告訴它「幫我配置 DeepSeek」，它會引導你一步步填好。

你想看或者改配置👇

hermes config              # 看當前所有配置
hermes config edit         # 用編輯器開啟 config.yaml
hermes config set KEY VAL  # 改某一項，比如 hermes config set terminal.backend docker
hermes config path         # 看配置檔案在哪
hermes config check        # 檢查有沒有缺失或過期的配置
hermes config migrate      # 升級配置格式

你想走一遍完整的配置嚮導👇

hermes setup
# 也可以只配某一塊
hermes setup model
hermes setup gateway
hermes setup tools

你想檢查環境有沒有問題👇

hermes doctor
# 加 --fix 讓它嘗試自動修復
hermes doctor --fix

其他常用的👇

hermes status        # 看所有元件狀態
hermes version       # 看版本號
hermes update        # 更新到最新版
hermes login         # OAuth 登入（Nous Portal、OpenAI Codex 等）
hermes logout        # 清除登入狀態

憑證池管理，多賬號輪換用👇

如果你有多個 API Key 想輪換使用，或者某個 Key 配額用完了自動切下一個，用這個。

普通使用者一個 Key 就夠，這塊可以跳過。

hermes auth add              # 互動式新增憑證
hermes auth list             # 看憑證池裡有哪些
hermes auth remove P INDEX   # 刪掉某個
hermes auth reset PROVIDER   # 重置「配額耗盡」狀態

外掛管理👇

外掛和技能不一樣，外掛是擴充套件 Hermes 底層能力的（比如接入新的記憶服務），技能是教它怎麼做事的。

大多數人用不到外掛，這塊備查就好。

hermes plugins list      # 看已裝的外掛
hermes plugins install   # 裝外掛
hermes plugins remove    # 刪外掛

外部記憶服務配置👇

Hermes 預設把記憶存在本地檔案裡，如果你想接 Honcho（使用者建模）或 Mem0（向量記憶）這類外部服務，用這個。

hermes memory setup    # 配置外部記憶服務
hermes memory status   # 看狀態
hermes memory off      # 關掉外部記憶，回到本地

MCP 伺服器管理👇

MCP（Model Context Protocol）是一個開放協議，讓 Hermes 能接入外部工具伺服器，比如 GitHub、檔案系統、資料庫等。

hermes mcp add NAME --url URL       # 新增一個 HTTP 型別的 MCP 伺服器
hermes mcp add NAME --command CMD   # 新增一個命令列型別的
hermes mcp list                     # 看已配置的伺服器
hermes mcp test NAME                # 測試連線
hermes mcp configure NAME           # 配置該伺服器暴露哪些工具
hermes mcp remove NAME              # 刪掉
hermes mcp serve                    # 把 Hermes 本身作為 MCP 伺服器執行

配置檔案裡的寫法長這樣👇

# ~/.hermes/config.yaml
mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_PERSONAL_ACCESS_TOKEN: "ghp_xxx"

多例項隔離執行（Profiles）👇

你想同時跑一個「寫作助手」和一個「程式碼助手」，各自有獨立的配置、記憶、技能，互不干擾，用 profile 隔離。剛開始用一個就夠，等用熟了再考慮這個。

hermes profile list              # 看所有 profile
hermes profile create NAME       # 建立新 profile
hermes profile use NAME          # 設為預設
hermes profile show NAME         # 看詳情
hermes profile rename A B        # 改名
hermes profile delete NAME       # 刪掉
hermes profile export NAME       # 匯出成 tar.gz
hermes profile import FILE       # 從壓縮包匯入

每個 profile 用 HERMES_HOME 環境變數隔離，獨立的 config、記憶、技能、cron，互不干擾。

日誌和診斷👇

hermes logs              # 看日誌
hermes dump              # 匯出安裝和配置摘要，排錯或提交 issue 時用
hermes insights          # 看使用統計和分析
hermes insights --days 7 # 只看最近 7 天

Shell 自動補全👇

裝好之後可以開啟命令自動補全，輸入 hermes 按 Tab 就能提示子命令。把下面這行復制到終端執行一次就行，以後每次開啟終端都會自動生效。

hermes completion bash >> ~/.bashrc   # bash 使用者（大多數 Linux / WSL2）
hermes completion zsh >> ~/.zshrc     # zsh 使用者（大多數 Mac）

執行完之後關掉終端重新開啟，或者執行 source ~/.bashrc 讓它立即生效。

從 OpenClaw 遷移過來👇

之前用過 OpenClaw 的朋友，Hermes 提供了遷移工具。

hermes claw migrate

解除安裝👇

hermes uninstall

▍ 第三類：技能和工具管理

這是 Hermes 最有意思的地方，也是和其他 AI 工具差距最大的地方。

Skills技能包是什麼？

簡單說，就是一個 Markdown 檔案，裡面寫著「遇到這類任務，按這個流程做」。

Hermes 會在合適的時候自動載入對應的技能，不用你每次都重新解釋。

更厲害的是，它會自己建立技能。

你讓它做了一件複雜的事，用了 5 個以上的工具呼叫，它會自動把這個流程儲存成技能，下次遇到類似的任務直接用，不用重新摸索。

技能還支援條件啟用。

比如這個技能只在 Discord 里載入，或者只在當前目錄有 package.json 的時候才啟用，寫在技能檔案的頭部就行👇

---
name: deploy-to-vercel
description: 把 Next.js 專案部署到 Vercel
platforms: [cli]
conditions: [file_exists:vercel.json]
---

platforms 控制在哪個平臺載入，conditions 控制在什麼情況下啟用，不滿足條件的技能不會出現在提示裡，不佔系統提示空間。

自己寫一個技能也很簡單👇

mkdir -p ~/.hermes/skills/my-custom/

然後在裡面新建一個 .md 檔案，寫上 YAML 頭部和正文步驟就行。寫完重啟 Hermes，或者等它自動重新整理，就能用 /技能名 呼叫了。

技能商店現在有多少東西👇

644 個技能，4 個登錄檔，16 個分類。

圖：Skills Hub 頁面截圖

代表性的分類舉幾個：

分類	代表技能
AI Agents	claude-code、codex、hermes-agent、opencode
GitHub	github-pr-workflow、github-code-review、codebase-inspection、github-issues
MLOps	axolotl、dspy、gguf-quantization、unsloth、whisper、stable-diffusion、peft-fine-tuning
Productivity	notion、linear、google-workspace、ocr、powerpoint、nano-pdf
Research	arxiv、blogwatcher、llm-wiki、polymarket
Creative	ascii-art、manim-video、excalidraw、songwriting、p5js、ascii-video
Apple macOS	apple-notes、apple-reminders、findmy、imessage
Media	gif-search、youtube-content、heartmula、songsee
Gaming	minecraft-modpack-server、pokemon-player
DevOps	webhook-subscriptions
Data Science	jupyter-live-kernel
Note-taking	obsidian
Social Media	xitter
Smart Home	openhue
MCP	mcporter、native-mcp
Software Dev	plan、requesting-code-review、subagent-driven-development

你想找技能👇

hermes skills browse  # 瀏覽所有技能
hermes skills search kubernetes # 搜尋關鍵詞
hermes skills search react --source skills-sh # 搜尋社群目錄

你想裝技能👇

hermes skills install official/security/1password
hermes skills install skills-sh/vercel-labs/json-render/json-render-react --force
# --force 只在你審查過第三方技能之後再用

其他技能管理命令👇

hermes skills list       # 看已裝的技能
hermes skills inspect ID # 先預覽，不安裝
hermes skills update     # 更新過時技能
hermes skills uninstall  # 解除安裝
hermes skills publish    # 釋出自己寫的技能

工具管理👇

hermes tools             # 互動式啟用/禁用工具
hermes tools list        # 看所有工具和狀態
hermes tools enable NAME
hermes tools disable NAME
hermes toolsets          # 看工具集分組

▍ 第四類：訊息平臺和定時任務

很多人不知道 Hermes 能接訊息平臺，

這是它和大多數 AI 工具最不一樣的地方。

裝好之後，你可以在 Telegram 裡直接和它說話，它在伺服器上跑，你不用開電腦。

支援的平臺有 15 個以上，微信、Discord、飛書、釘釘、企微……

你想接微信👇

hermes gateway setup    # 互動式配置，跟著提示走
hermes gateway run      # 前臺啟動
hermes gateway install  # 安裝成後臺服務
hermes gateway start    # 啟動服務
hermes gateway stop     # 停止
hermes gateway restart  # 重啟
hermes gateway status   # 看狀態

你想讓 Hermes 定時跑任務👇

比如每天早上 9 點抓一下 Hacker News 的 AI 新聞，整理成摘要發到微信或飛書。

hermes cron create "09:00"   # 建立定時任務，跟著提示填提示詞和投遞平臺
hermes cron list             # 看所有任務
hermes cron edit ID          # 改時間、提示詞、投遞方式
hermes cron pause ID         # 暫停
hermes cron resume ID        # 恢復
hermes cron run ID           # 立即觸發一次
hermes cron remove ID        # 刪除
hermes cron status           # 看排程器狀態

時間格式很靈活，'30m'、'every 2h'、'0 9 *' 都行。

你想接 Webhook👇

hermes webhook subscribe 名字   # 建立一個 /webhooks/<名字> 路由
hermes webhook list
hermes webhook test 名字        # 發一次測試請求
hermes webhook remove 名字

▍ 語音模式

Hermes 支援語音輸入和語音播報，需要單獨安裝。

pip install "hermes-agent[voice]"

# 可選，裝了之後語音轉文字在本地跑，不用聯網
pip install faster-whisper

裝好之後，進入聊天，用斜槓指令控制👇

/voice on    # 開啟語音輸入，按 Ctrl+B 開始錄音
/voice tts   # 讓 Hermes 朗讀回覆
/voice off   # 關掉
/voice status # 看當前狀態

tg 和 Discord 裡也支援語音，Discord 還能接語音訊道，直接在頻道里說話。

▍ 接入 IDE（ACP 編輯器整合）

這塊是給用 VS Code、Zed、JetBrains 寫程式碼的朋友的，不寫程式碼的可以跳過。

Hermes 可以作為編輯器的 AI 助手執行，用的是 ACP 協議（Agent Client Protocol，可以理解成編輯器和 AI 之間的通用介面）。

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

裝好之後在編輯器裡配置 ACP 伺服器地址就行，和 Cursor、Copilot 的接入方式類似。

▍ 自定義 Agent 人格（SOUL.md）

Hermes 的預設語氣和風格可以透過 SOUL.md 檔案定義。

檔案放在 ~/.hermes/SOUL.md，每條訊息發出前都會重新讀取，改完不用重啟。

寫法很自由，比如👇

你是一個說話直接、偶爾用顏文字的助手。
你像一個什麼都懂的朋友，不是一個客服機器人。

每個 profile 可以有自己的 SOUL.md，不同場景用不同人格。

▍ 第五類：會話內斜槓指令

進入 Hermes 聊天之後，輸入 / 會彈出自動補全選單。

這些是日常最高頻的，按類整理好了。

會話控制👇

指令	說人話	頻率
/new	開一個全新對話	高
/retry	重試上一條，刪掉上次回覆重新發	高
/undo	撤銷上一輪，連你的訊息一起刪	高
/history	看當前會話的完整對話歷史	中
/compress	手動壓縮上下文，省 token	中
/background 提示詞	把任務扔到後臺跑，不打斷當前對話	中
/btw 問題	臨時提問，用當前上下文但不儲存，不調工具	中
/queue 提示詞	排隊到下一輪再處理	中
/rollback	回滾檔案改動，像時光機	中
/resume 名字	恢復某個命名會話	中
/stop	停掉所有後臺程序	低
/title 名字	給當前會話起個好記的名字	低
/save	把對話儲存到檔案	低

配置相關👇

指令	說人話	頻率
/model	檢視或切換當前模型	高
/yolo	切換是否跳過危險命令確認	中
/voice on	開語音輸入	中
/voice tts	讓 Hermes 朗讀回覆	中
/reasoning high	調高推理強度（none/low/medium/high/xhigh）	中
/personality 名字	切換人格風格	低
/verbose	切換工具進度顯示詳細程度	低
/prompt 文字	檢視或設定系統提示詞	低
/skin 名字	換介面主題	低
/statusbar	開關頂部狀態列	低

工具與技能👇

指令	說人話	頻率
/skill 名字	把某個技能載入進當前會話	高
/tools	管理工具	中
/skills	搜尋或安裝技能	中
/browser connect	連線本地 Chrome 瀏覽器（CDP 協議）	低
/paste	檢查剪貼簿裡的圖片並附加	低
/cron	管理定時任務	低
/reload-mcp	重新載入 MCP 伺服器	低
/plugins	看已裝的外掛	低

資訊檢視👇

指令	說人話	頻率
/help	看所有命令	高
/usage	看 token 用了多少	中
/profile	看當前用的是哪個配置檔案	低
/insights	看使用統計	低
/provider	看當前提供商資訊	低

退出用 /quit，或者 /exit，或者 /q，三個都行。

在 Telegram / Discord 等平臺裡，還有幾個專屬指令👇

指令	說人話
/approve	批准 Hermes 要執行的危險命令
/deny	拒絕
/sethome	把當前聊天設為主頻道，cron 任務預設推送到這裡
/status	看當前會話資訊
/commands	分頁瀏覽所有命令
/update	在平臺裡直接更新 Hermes

▍ 避坑 + 組合用法

幾個真實踩過的坑。

Windows 使用者目前必須走 WSL2。

不能直接在 PowerShell 或 CMD 裡裝，會報錯。

先以管理員身份開啟 PowerShell，

執行 wsl --install，重啟電腦，開啟 Ubuntu 終端，

再在 Ubuntu 裡執行安裝命令。

/rollback 要提前開啟。

這個功能預設是關的，需要啟動時加引數👇

hermes chat --checkpoints

開了之後每次檔案改動前會自動存檔，改壞了直接 /rollback 回來。

/yolo 用之前想清楚。

這個指令會跳過所有危險命令的確認提示，包括刪檔案、跑 SQL、執行指令碼。

除錯的時候方便，但別忘了關掉。

幾個好用的組合用法👇

# 單次提問 + 指定模型，不進入聊天介面
hermes chat -q "幫我寫一個 Python 爬蟲" -m deepseek/deepseek-chat

# 恢復上次會話 + 預載入技能
hermes --continue -s github-pr-workflow

# 安靜模式，適合指令碼呼叫，只輸出最終回答
hermes chat -q "今天天氣怎麼樣" --quiet

hermes gateway run 加上 cron 任務，就是一套全自動定時推送系統，不用你盯著。

想讓 Hermes 在 Docker 裡跑，更安全👇

hermes config set terminal.backend docker

改完之後 Hermes 執行終端命令都在容器裡，不會動你的本機環境。

也可以指定映象👇

# ~/.hermes/config.yaml
terminal:
  backend: docker
  docker:
    image: python:3.11
    persistent: true

想在指令碼或應用裡呼叫 Hermes👇

這塊是給開發者用的，想把 Hermes 嵌進自己的程式裡。普通使用者跳過就好。

pip install git+https://github.com/NousResearch/hermes-agent.git
from run_agent import AIAgent

agent = AIAgent()
result = agent.run_conversation("幫我分析這段程式碼")
print(result)

▍ 10 條原始碼洞見

翻了 Hermes 的原始碼之後，整理出 10 條覺得有意思的設計決策，給感興趣的朋友看。

1. 技能索引在系統提示裡，全文在使用者訊息裡。

說人話就是，它只把技能的「目錄」放在每次對話的背景裡，技能的完整內容只在你真正用到的時候才載入進來。這樣 AI 每次處理訊息的成本能降 80%。

2. 整個 Agent 迴圈是同步的，沒有 asyncio。

說人話就是，它選擇了「一件事做完再做下一件」的方式，而不是「多件事同時做」。好處是程式碼更簡單，別人更容易給它寫外掛。

3. 工具是自注冊的，不需要中心配置檔案。

說人話就是，加一個新工具，只需要寫那個工具本身，不用去改任何「工具列表」檔案，裝上就能用。

4. 技能是資料，不是程式碼。

說人話就是，技能就是一個普通的文字檔案，你可以直接用記事本開啟改，Hermes 自己也能改，這才是真正的「自學習」。

5. 記憶的目標是「減少未來的糾正」。

說人話就是，它不是把所有聊天記錄都存下來，而是隻存那些「下次如果忘了你會糾正它」的東西，比如你的偏好、習慣、約定。

6. 跨會話召回用的是 FTS5 全文搜尋加 LLM 摘要。

說人話就是，它能搜尋你所有歷史對話，找到相關內容，比你自己翻聊天記錄快多了，而且不需要把所有歷史都塞進當前對話裡。

7. 子 Agent 有工具限制和併發上限。

說人話就是，它可以同時派出多個「小助手」並行幹活，但每個小助手的許可權是受限的，最多同時跑 3 個，防止失控。

8. Gateway 會話 300 秒無活動自動觸發記憶重新整理。

說人話就是，你在 Telegram 裡和它聊完，5 分鐘沒動靜，它會自動把這次對話的重要內容存進記憶，不用你手動儲存。

9. MCP 客戶端有 2195 行。

說人話就是，接外部工具這個功能很強大，但實現起來很複雜，出問題了比較難排查，這是目前最難用的部分。

10. 每次檔案改動前自動 git commit。

說人話就是，它幫你改檔案之前會先存一個備份，改壞了用 /rollback 可以一步步撤回來，這個設計是從 Claude Code 借鑑來的。

← 返回首頁