Hermes Agent 安裝與使用教學：以戰國策 OpenClaw VPS 為例

本文以 戰國策 OpenClaw VPS 主機 作為實作情境，說明如何在一台可透過 SSH 管理、具備 root 權限與公開 IP 的 Linux VPS 上安裝並使用 Hermes Agent。戰國策官網指出，其 OpenClaw VPS 提供完整 root 權限、明確 CPU 與記憶體配置、公開 IP，以及可 24/7 持續運作的 VPS 環境，因此很適合拿來部署需要長時間在線的 AI agent 1。另一方面，Hermes Agent 官方文件說明，Linux / macOS / WSL2 都可使用一行指令快速安裝，且安裝器會自動處理 Python、Node.js、ripgrep、ffmpeg、虛擬環境與 hermes 命令設定等工作 2。

「The installer handles everything automatically — all dependencies (Python, Node.js, ripgrep, ffmpeg), the repo clone, virtual environment, global hermes command setup, and LLM provider configuration.」2

一、先理解這個範例環境

若您使用的是戰國策 OpenClaw VPS，可以把它理解為一台適合自託管 AI 助手的 Linux 主機。官網頁面指出，該服務強調 完整系統權限、公開 IP、穩定網路與 24/7 運作，並提供從 2 vCPU / 4GB RAM 起跳的方案 1。這代表您可以用最標準的 VPS 管理方式來部署 Hermes Agent：先以 SSH 連入伺服器，再用官方安裝腳本完成安裝，最後將 Hermes 設成 CLI 使用或背景常駐服務。

項目	戰國策 OpenClaw VPS 可提供的條件	對 Hermes Agent 的意義
管理方式	可視為可 SSH 登入的 Linux VPS 1	方便用終端機安裝與維運
權限	完整 root 存取權限 1	可安裝系統相依套件與背景服務
網路	公開 IP、穩定連線 1	方便接 Telegram、Slack、Discord 等通訊平台
運作型態	24/7 持續運作 1	適合讓 Hermes gateway 長期在線
入門方案	2 Core / 4GB RAM / 100GB SSD 1	足以作為入門測試與輕量使用起點

二、安裝前準備

實作前，建議先準備三項資料。第一項是 VPS 登入資訊，也就是主機 IP、SSH 帳號與密碼或 SSH key。第二項是至少一組 LLM 供應商金鑰。Hermes 官方文件指出，您至少需要設定一個模型供應來源，常見選項包括 Nous Portal、OpenRouter、Anthropic、OpenAI Codex、GitHub Copilot、DeepSeek 或自訂 OpenAI 相容端點等；此外，Hermes 需要使用 至少 64K context window 的模型 3。第三項是確認主機內已具備 git；官方文件特別指出，快速安裝法唯一明確前提就是 Git，其他依賴大多會由安裝器自動處理 2。

在戰國策 OpenClaw VPS 上，您可以先用以下方式登入主機：

ssh root@你的主機IP

登入後，先做基礎更新，並確認 git 與 curl 可用：

apt update && apt install -y git curl

如果系統回應 git version ... 與 curl ...，就代表可以進入 Hermes 安裝步驟。

三、最快速的安裝方式：官方一行指令

對大多數第一次接觸 Hermes Agent 的使用者而言，最推薦的做法是直接使用官方安裝腳本。官方安裝頁與 Quickstart 頁都提供相同的一行指令 2：

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

這個安裝器會自動完成多項工作，包括下載 Hermes 原始碼、建立 Python 3.11 虛擬環境、安裝所需 Python 套件、安裝 Node.js 相關支援、設定全域 hermes 命令，並引導您設定模型供應商 2。如果您是在 VPS 上遠端操作，這種方式通常是最省時間的。

安裝完成後，依官方說明重新載入 shell：

source ~/.bashrc

然後先做健康檢查：

hermes doctor

若診斷正常，再查看版本：

hermes version

到這一步為止，代表 Hermes Agent 已經安裝到 VPS 上了。

四、第一次設定：模型供應商與 API Key

Hermes 安裝完之後，最重要的下一步是 設定模型提供者。官方建議直接執行下列命令，以互動方式選擇 provider 與 model 2：

hermes model

如果您想用較通用、相對好上手的方案，可以先使用 OpenRouter。官方安裝文件示範了兩種配置方式：一種是在 ~/.hermes/.env 內放入 API key；另一種是直接用命令寫入設定 2。

hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here

若您偏好手動編輯，也可以這樣建立設定：

mkdir -p ~/.hermes
echo 'OPENROUTER_API_KEY=sk-or-v1-your-key-here' >> ~/.hermes/.env

設定完成後，再執行一次：

hermes model

選好供應商與模型之後，可用以下命令檢查目前狀態：

hermes status

常見 provider	適用情境	設定方式
OpenRouter	最容易快速上手，模型選擇多	hermes model 或設定 OPENROUTER_API_KEY 2
Anthropic	想直接使用 Claude	透過 hermes model 完成授權或填 API key 3
GitHub Copilot	已有 Copilot 訂閱	透過 OAuth 或設定 GH_TOKEN / COPILOT_GITHUB_TOKEN 3
Custom Endpoint	您已有自架或第三方 OpenAI-compatible API	在 hermes model 中填入 base URL、API key 與 context size 3

五、開始使用 Hermes：CLI 模式

若您只是要先在 VPS 內測試 Hermes 是否正常工作，最簡單的方法就是直接啟動 CLI：

hermes

官方 Quickstart 說明，啟動後您會看到目前使用的模型、可用工具與已安裝技能，接著就可以直接輸入任務 3。例如，您可以先從最基本的主機管理問題開始：

What can you help me with?

或是請它直接檢查這台 OpenClaw VPS 的磁碟與目錄使用狀況：

What's my disk usage? Show the top 5 largest directories.

Hermes 官方文件指出，它在 CLI 中就具備網路搜尋、檔案操作與終端命令執行能力，因此很適合當作 VPS 管理與任務自動化助手 3。

在日常使用上，您應優先記住幾個最重要的互動命令：

命令	用途
hermes	啟動互動式聊天 3
/help	查看可用指令 3
/tools	查看目前工具 3
/model	在聊天中切換模型 3
hermes --continue	回到上一個工作階段 3
Ctrl+C 或送出新訊息	中斷目前任務 3

如果您是把 Hermes 裝在戰國策 OpenClaw VPS 上，CLI 最適合做兩件事。第一，是在正式串接 Telegram、Slack、Discord 之前先測試模型與工具是否正常。第二，是把它當成一個能操作 Linux 主機的「命令助手」，例如請它整理 log、查詢磁碟空間、彙整系統資訊，或產出作業紀錄。

六、進階使用：把 Hermes 變成 24/7 在線助理

若您希望 Hermes 不只是登入 SSH 時才可用，而是能像 OpenClaw 一樣，持續在 Telegram、Slack、Discord、WhatsApp 等平台上回應訊息，就要使用官方的 Messaging Gateway。官方說明明確指出，gateway 是一個單一背景程序，專門用來連接各個訊息平台、維持 session、執行 cron 工作與傳送語音訊息，而且特別適合跑在 server、VPS 或 cloud instance 上 4。

最簡單的設定方式是執行：

hermes gateway setup

這個互動精靈會引導您選擇要串接的平台，例如 Telegram、Discord、Slack、WhatsApp 或 Signal，並在設定完成後詢問是否啟動或重新啟動 gateway 4。

在 VPS 上，常見的背景服務管理流程如下：

hermes gateway setup
sudo hermes gateway install --system
hermes gateway start
hermes gateway status --system

上面這組流程的邏輯是：先完成平台設定，再把 gateway 安裝為 Linux 開機自啟動的系統服務，最後確認服務狀態 4。如果您只是先測試，也可以先前景執行：

hermes gateway

確認沒有報錯之後，再改成 system service。

Telegram 範例理解方式

以 Telegram 為例，概念上您需要先建立 bot、取得 token，然後在 hermes gateway setup 裡選擇 Telegram，照精靈完成設定。設定完成後，Hermes 就能在 Telegram 中接收訊息，並把請求送進同一個 VPS 上的 agent 執行。由於戰國策 OpenClaw VPS 具備公開 IP 與持續在線能力，這種部署方式很適合做企業內部通知、自動化工作回報、系統監控摘要與內容生產工作流 1。

七、安全設定：一定要做的使用者限制

這一段非常重要。官方 Messaging Gateway 文件明確提醒，gateway 預設應拒絕未列入 allowlist 或未完成配對的使用者，因為 Hermes 可能具備終端機與工具呼叫能力 4。換句話說，若您把 Hermes 裝在可執行命令的 VPS 上，就不應讓任何人都能直接對它下指令。

例如，若您要限制 Telegram 只有特定帳號能用，可以配置允許清單。官方文件示例如下 4：

TELEGRAM_ALLOWED_USERS=123456789,987654321

若是不想先找使用者 ID，也可以採用配對碼核准方式：

hermes pairing approve telegram XKGH5N7P

因此，若您要在戰國策 OpenClaw VPS 上把 Hermes 提供給公司同仁、助理或特定部門使用，最好的做法是：先限制允許名單，再逐一核准使用者，而不是直接對外完全開放。

八、手動安裝法：適合想完整掌控環境的人

如果您希望更細緻地掌握 Hermes 的安裝結構，例如要自己決定安裝目錄、PATH、Python 環境與可選功能，也可以使用官方手動安裝法 2。精簡流程如下：

git clone --recurse-submodules https://github.com/NousResearch/hermes-agent.git
cd hermes-agent
curl -LsSf https://astral.sh/uv/install.sh | sh
uv venv venv --python 3.11
export VIRTUAL_ENV="$(pwd)/venv"
uv pip install -e ".[all]"
npm install
mkdir -p ~/.hermes/{cron,sessions,logs,memories,skills,pairing,hooks,image_cache,audio_cache,whatsapp/session}
cp cli-config.yaml.example ~/.hermes/config.yaml
touch ~/.hermes/.env
hermes config set OPENROUTER_API_KEY sk-or-v1-your-key-here
mkdir -p ~/.local/bin
ln -sf "$(pwd)/venv/bin/hermes" ~/.local/bin/hermes
source ~/.bashrc
hermes doctor

這種做法的優點是比較透明，也比較容易做版本控管與客製化；缺點則是步驟較多。若您只是要在戰國策 OpenClaw VPS 上快速落地，仍建議先用官方一行安裝法，等運作穩定後再改手動管理。

九、推薦的實戰上線流程

如果您的目標是「在戰國策 OpenClaw VPS 上，把 Hermes 變成企業可用的 AI 助理」，建議照下面順序進行，成功率會比較高。

階段	建議動作	原因
1	先 SSH 登入 VPS，安裝 git、curl	建立最基本安裝條件
2	先跑官方一行安裝指令	最快完成 Hermes 本體安裝 2
3	用 hermes doctor 與 hermes status 檢查狀態	先排除環境問題 2
4	用 hermes model 設定可用模型	沒有 provider 就無法正常工作 3
5	先用 CLI 測試幾個簡單任務	先確認模型、工具、檔案與終端功能正常 3
6	再執行 hermes gateway setup 串接 Telegram / Slack 等平台	降低一次到位造成的排錯難度 4
7	用 sudo hermes gateway install --system 設成常駐服務	符合 VPS 24/7 在線的使用方式 4
8	設定 allowlist 或 pairing	避免未授權使用者操作您的 agent 4

十、常見問題與排除方式

Hermes 官方安裝文件已列出幾個高頻錯誤，以下整理成更適合 VPS 操作的排除表格 2。

問題	可能原因	建議處理方式
hermes: command not found	PATH 尚未更新，或 shell 尚未重新載入	執行 source ~/.bashrc，再確認 ~/.local/bin 已加入 PATH 2
API key not set	尚未設定模型供應商或 API key	執行 hermes model 或 hermes config set OPENROUTER_API_KEY ... 2
啟動後模型報 context 不足	選到小於 64K context 的模型	改用符合 64K 以上上下文的模型 3
gateway 能啟動但外部無法使用	平台 token、allowlist 或配對未完成	重跑 hermes gateway setup，並檢查 allowlist 與 pairing 4
系統重開後 gateway 不見了	尚未安裝為 system service	執行 sudo hermes gateway install --system，再啟動服務 4

十一、給戰國策 OpenClaw VPS 使用者的實務建議

若您是第一次把 agent 類工具裝上 VPS，最務實的做法不是一次把所有功能都開滿，而是分成三步。第一步，先讓 CLI 可正常使用；第二步，再讓 單一訊息平台 可以正常收發；第三步，最後才進入 排程、自動化與多人協作。這樣做的好處是每個階段都能明確知道問題出在哪裡，也比較符合 VPS 上線的穩健流程。

如果您的使用情境以企業內部為主，我會建議先從 Telegram 或 Slack 開始，因為這兩種平台在官方文件中的支援度高，且 gateway 架構本身就是為多平台訊息入口設計 4。若只是要把 Hermes 當作您個人的 Linux 助理，其實先停留在 hermes CLI 就已經很有價值。

十二、最短版指令總表

若您只想先把 Hermes 在戰國策 OpenClaw VPS 上跑起來，可直接照下面執行：

ssh root@你的主機IP
apt update && apt install -y git curl
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.bashrc
hermes doctor
hermes model
hermes

若您接著要改成 VPS 常駐服務，則再補上：

hermes gateway setup
sudo hermes gateway install --system
hermes gateway start
hermes gateway status --system

到這裡，您就已經完成了 在戰國策 OpenClaw VPS 上安裝 Hermes Agent、設定模型、啟用基本互動模式，以及切換到 24/7 在線 gateway 模式 的完整流程。

References

---

若您希望將 Hermes Agent 部署為可長時間穩定運作、支援 24/7 在線服務的企業級 AI 助理，本文建議優先採用 戰國策 OpenClaw VPS 作為正式上線環境。相較於自駕主機還需要自行處理硬體採購、網路環境、對外連線與持續維運，OpenClaw VPS 直接提供企業部署更在意的 公開 IP、完整 root 權限、明確資源配置與 24/7 持續運作條件，可大幅縮短 Hermes Agent 的建置時間，也更適合用於 AI 助理、訊息串接、自動化任務與長時間在線服務 1。