<!-- Source: https://hermesbible.com/docs/getting-started/quickstart -->

本指南引導你從零開始建立一個能在實際使用中穩定運作的 Hermes 設定。安裝、選擇供應商、驗證聊天功能正常運作，並在遇到問題時知道該怎麼做。

偏好觀看教學？

Onchain AI Garage 製作了一個關於安裝、設定和基本指令的精華教學——如果你更喜歡跟著影片操作，這是本頁面的好幫手。更多內容請參閱完整的 Hermes Agent 教學與使用案例 播放清單。

影片： 在 YouTube 上觀看

適用對象

• 完全新手，想要最短路徑建立可用的設定
• 切換供應商，不想因設定錯誤浪費時間
• 為團隊、機器人或常駐工作流程設定 Hermes
• 受夠了「安裝了，但什麼都沒用」

最快路徑

選擇符合你目標的那一列：

**經驗法則：**如果 Hermes 無法完成正常的對話，先不要加入更多功能。先讓一段乾淨的對話正常運作，然後再加入閘道、定時任務、技能、語音或路由。

---

1. 安裝 Hermes Agent

使用 Hermes Desktop 安裝器（macOS 或 Windows）（建議）

要輕鬆安裝命令列和桌面應用程式，請從我們的網站下載 Hermes Desktop 安裝器並執行它。

不使用 Hermes Desktop：

若要僅透過命令列安裝（不使用 Hermes Desktop），請執行：

Linux / macOS / WSL2 / Android (Termux)

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

Windows (原生)

在 powershell 中執行：

iex (irm https://hermes-agent.nousresearch.com/install.ps1) 

提示——Android / Termux

如果你在手機上安裝，請參閱專用的 Termux 指南 了解經過測試的手動路徑、支援的附加元件和目前 Android 特定的限制。

安裝完成後，重新載入你的 shell：

source ~/.bashrc   # 或 source ~/.zshrc

如需詳細的安裝選項、前置需求和疑難排解，請參閱安裝指南。

2. 選擇供應商

這是最重要的設定步驟。使用 hermes model 透過互動方式進行選擇：

hermes model

提示——最簡單路徑：Nous Portal

一個訂閱即可涵蓋 300 多個模型以及 Tool Gateway（網路搜尋、圖片生成、TTS、雲端瀏覽器）。全新安裝時：

hermes setup --portal

這會在一個指令中完成登入、將 Nous 設為你的供應商，並啟用 Tool Gateway。

好的預設值：

對於大多數初次使用者：選擇一個供應商，除非你知道為什麼要改變預設值，否則接受預設值。完整的供應商目錄和設定步驟請參閱供應商頁面。

注意——最低上下文：64K tokens

Hermes Agent 需要一個具有至少 64,000 tokens 上下文的模型。較小上下文視窗的模型無法為多步驟工具呼叫工作流程維護足夠的工作記憶，並會在啟動時被拒絕。大多數託管模型（Claude、GPT、Gemini、Qwen、DeepSeek）都能輕鬆滿足。如果你使用本地模型，請將其上下文大小設定為至少 64K（例如 llama.cpp 使用 --ctx-size 65536，Ollama 使用 -c 65536）。

提示

你可以隨時使用 hermes model 切換供應商——不會被綁定。如需完整的支援供應商和設定詳情列表，請參閱 AI 供應商。

設定如何儲存

Hermes 將密鑰與一般設定分開儲存：

• 密鑰和 token → ~/.hermes/.env
• 非機密設定 → ~/.hermes/config.yaml

正確設定值最簡單的方式是透過 CLI：

hermes config set model anthropic/claude-opus-4.6
hermes config set terminal.backend docker
hermes config set OPENROUTER_API_KEY sk-or-...

正確的值會自動寫入正確的檔案。

3. 執行你的第一次對話

hermes            # 經典 CLI
hermes --tui      # 現代 TUI（建議）

你會看到一個歡迎橫幅，顯示你的模型、可用工具和技能。使用具體且容易驗證的提示：

提示——選擇你的介面

Hermes 附帶兩個終端機介面：經典的 prompt_toolkit CLI 和較新的 TUI，具有模態覆蓋、滑鼠選擇和非阻塞輸入。兩者共享相同的工作階段、斜線指令和設定——分別用 hermes 和 hermes --tui 試試看。

用 5 個要點總結這個儲存庫，並告訴我主要進入點是什麼。

檢查我目前的目錄，告訴我什麼看起來是主要的專案檔案。

幫我為這個程式碼庫建立一個乾淨的 GitHub PR 工作流程。

成功的样子：

• 橫幅顯示你選擇的模型/供應商
• Hermes 無誤地回覆
• 需要時可以使用工具（終端機、檔案讀取、網路搜尋）
• 對話可以正常持續超過一個回合

如果以上都正常，你已經過了最困難的部分。

4. 驗證工作階段運作正常

在繼續之前，確保恢復功能正常：

hermes --continue    # 恢復最近的工作階段
hermes -c            # 簡短形式

這應該會帶你回到你剛才的對話。如果沒有，檢查你是否在正確的配置檔中，以及工作階段是否真的被儲存了。這在你之後管理多個設定或機器時很重要。

5. 試試關鍵功能

使用終端機

❯ 我的磁碟使用量是多少？顯示最大的 5 個目錄。

代理會代表你執行終端機指令並顯示結果。

斜線指令

輸入 / 查看所有指令的自動完成下拉選單：

多行輸入

按 Alt+Enter、Ctrl+J 或 Shift+Enter 新增新的一行。Shift+Enter 需要終端機將其作為獨立序列發送（Kitty / foot / WezTerm / Ghostty 預設支援；iTerm2 / Alacritty / VS Code 終端機在啟用 Kitty 鍵盤協定後支援）。Alt+Enter 和 Ctrl+J 在所有終端機中都能運作。

中斷代理

如果代理花費時間太長，輸入新的訊息並按 Enter——它會中斷目前的任務並切換到你的新指示。Ctrl+C 也有效。

6. 加入下一層

只有在基本聊天正常運作後。選擇你需要的：

機器人或共享助理

hermes gateway setup    # 互動式平台設定

連接 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant 或 Microsoft Teams。

自動化和工具

• hermes tools — 調整每個平台的工具存取權限
• hermes skills — 瀏覽和安裝可重用的工作流程
• 定時任務——僅在你的機器人或 CLI 設定穩定後

沙箱終端機

為了安全，在 Docker 容器或遠端伺服器中執行代理：

hermes config set terminal.backend docker    # Docker 隔離
hermes config set terminal.backend ssh       # 遠端伺服器

語音模式

# 從 Hermes 安裝目錄（curl 安裝器將其放在
# Linux/macOS 上的 ~/.hermes/hermes-agent 或 Windows 上的 %LOCALAPPDATA%\hermes\hermes-agent）：
cd ~/.hermes/hermes-agent
uv pip install -e ".[voice]"
# 包含 faster-whisper 用於免費本地語音轉文字

然後在 CLI 中：/voice on。按 Ctrl+B 錄音。參閱語音模式。

技能

技能是隨選的指令文件，教導 Hermes 如何執行特定任務——部署到 Kubernetes、開啟 GitHub PR、微調模型、搜尋 GIF。每個都是一個 SKILL.md 檔案，包含名稱、描述和逐步程序。代理免費讀取簡短描述，只在任務實際需要時才載入技能的完整內容，所以新增技能不會膨脹每個請求。

Hermes 附帶一個已安裝在 ~/.hermes/skills/ 中的內建技能目錄。你可以從 Skills Hub 新增更多，或撰寫自己的技能。

從中心瀏覽和安裝：

hermes skills browse                      # 列出所有可用項目
hermes skills search kubernetes           # 按關鍵字搜尋技能
hermes skills install openai/skills/k8s   # 安裝一個（先執行安全掃描）

安裝參數是來自中心的 source/path 代碼——openai/skills/k8s 表示 OpenAI 目錄中的 k8s 技能。hermes skills browse 顯示確切可用的代碼。

使用技能——每個已安裝的技能會自動成為斜線指令：

/k8s deploy the staging manifest          # 用請求執行技能
/k8s                                       # 載入它並讓 Hermes 詢問你需要什麼

這在 CLI 和任何已連接的訊息平台上都能運作。你不必一次安裝所有東西——代理在正常對話中會在任務匹配時自動選擇正確的內建技能。

參閱技能系統了解如何撰寫自己的技能、外部技能目錄和完整的中心來源列表。

MCP 伺服器

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

編輯器整合（ACP）

ACP 支援內建於標準 [all] 附加元件中，所以 curl 安裝器已經包含它。只需執行：

hermes acp

（如果你安裝時沒有包含 [all]，請先執行 cd ~/.hermes/hermes-agent && uv pip install -e ".[acp]"。）

參閱 ACP 編輯器整合。

---

常見故障模式

這些是最浪費時間的問題：

修復工具包

當感覺不對勁時，按此順序操作：

1. hermes doctor
2. hermes model
3. hermes setup
4. hermes sessions list
5. hermes --continue
6. hermes gateway status

這個序列能讓你從「出問題的感覺」快速回到已知狀態。

---

快速參考

下一步

• CLI 指南 — 精通終端機介面
• 設定 — 自訂你的設定
• 訊息閘道 — 連接 Telegram、Discord、Slack、WhatsApp、Signal、Email、Home Assistant、Teams 等
• 工具與工具組 — 探索可用功能
• AI 供應商 — 完整供應商列表和設定詳情
• 技能系統 — 可重用的工作流程和知識
• 提示與最佳實踐 — 進階使用者提示

---

---

學習路徑