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

章節：快速入門 · 網址：https://hermesbible.com/docs/getting-started/quickstart

本指南將帶你從零開始，完成可在實際使用中穩定運作的 Hermes 設定。安裝、選擇供應商、驗證對話功能正常運作，並在出問題時知道該如何排除。

想用看的？

Onchain AI Garage 製作了安裝、設定與基本指令的完整 Masterclass 示範影片，如果你想跟著影片操作，這是本頁面的好幫手。更多內容請參閱完整的 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 將密鑰與一般設定分開存放：

• 密鑰和權杖 → ~/.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 — 瀏覽和安裝可重用的工作流程
• Cron — 只在你的機器人或 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 新增更多，或撰寫自己的技能。

從 Hub 瀏覽和安裝：

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

安裝參數是 Hub 的 source/path 短網址 — openai/skills/k8s 表示 OpenAI 目錄中的 k8s 技能。hermes skills browse 會顯示可用的確切短網址。

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

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

這在 CLI 和任何已連接的訊息平台中都能運作。你不必事先安裝所有技能 — 代理會在正常對話中自動選擇合適的內建技能。

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

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 供應商 — 完整供應商列表和設定詳情
• 技能系統 — 可重用的工作流程和知識
• 秘訣與最佳實踐 — 進階使用者技巧

---

---

學習路徑