安裝指南

2026 年 Hermes Agent Mac 版
最新安裝清單：週末動手前最該準備什麼？

nuzcloud 編輯部 2026-05-23 8 分鐘

導讀摘要

2026 年第一次在 M 系列 Mac 上裝 Hermes Agent，最怕裝到一半才發現執行環境不對、API key 沒備好、權限彈窗沒處理，或終端機一關服務就停。「安裝成功」與「長期穩定運行」是兩件事。本文依官方文件整理五段式清單，從第一條 curl 之前到 launchd 常駐與 24 小時觀察，幫你把週末安裝變成可驗證、可恢復、可持續的流程。（核對至 2026-05-23）

只想快速體驗，可按官方 Quickstart 走。若希望 Hermes 在 Mac 上長期可用，請先把下面清單勾完再執行安裝指令。

一Before you install：硬體、系統與備份

檢查項	建議	驗證
晶片 / 系統	Apple Silicon 或 Intel Mac；macOS 能跑 Xcode CLT	`uname -m`、`sw_vers`
記憶體 / 磁碟	建議 ≥16GB RAM；預留 ≥5GB（含 Skills 快取）	活動監視器 / `df -h ~`
網路	可存取 GitHub raw 與所選 LLM API	`curl -I https://github.com`
帳號權限	本機管理員（安裝 PATH、完全磁碟取用權等）	系統設定 → 使用者與群組
備份	Time Machine 或匯出 `~/.hermes` 快照	恢復演練一次

二Prepare dependencies：官方只要求 Git

依 Installation，一行安裝器會自動處理 uv、Python 3.11、Node.js v22、ripgrep、ffmpeg，無需事先安裝 Homebrew 版 Python/Node。你只需確認 Git 可用：

→Git：git --version 有輸出即可；避免裝到一半才裝 CLT。
→Shell：預設 zsh；安裝後需 source ~/.zshrc 重新載入 PATH。
→可選 Nix：使用 Nix 的讀者走 Nix 文件，與 curl 安裝二選一。

三Prepare accounts and secrets

安裝結束前會設定 LLM；事先準備可減少中斷：

→OpenRouter / Anthropic / OpenAI 等至少一個 provider 的 API key。
→金鑰寫入 ~/.hermes/.env，執行 chmod 600 ~/.hermes/.env。
→勿把金鑰放進專案 Git；Gateway 白名單用 TELEGRAM_ALLOWED_USERS 等，避免 GATEWAY_ALLOW_ALL_USERS=true。

⚠️安全預設：危險指令需人工核准（approvals.mode: manual）。正式環境勿開 YOLO；終端機後端優先考慮 docker 隔離。

四Create a safe workspace

官方 per-user 佈局：程式碼在 ~/.hermes/hermes-agent/，資料在 ~/.hermes/（config、logs、pairing、sandboxes）。

→用專用子目錄作 agent 工作區，勿直接授權整個使用者主目錄。
→日誌：~/.hermes/logs/（Gateway 用 gateway.log）。
→自訂路徑：HERMES_INSTALL_DIR=... 再跑安裝腳本（見官方文件）。

五Install & First run

Install（最小可用）：

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

接著 source ~/.zshrc → hermes 或 hermes setup → hermes model。

First run 驗證：

✓which hermes → ~/.local/bin/hermes
✓hermes doctor 無阻塞項（缺 API key 會提示跑 hermes model）
✓發一則真實對話，確認模型回覆與工具呼叫
✓若啟用檔案/終端機工具，在系統設定中按需授予「完全磁碟取用權」等權限

六Keep it running：launchd 常駐

在 CLI 裡跑 hermes 只等於目前工作階段；Messaging Gateway 需要守護行程：

1CLI 穩定後：hermes gateway setup（Telegram / Discord / Slack 等依目前支援列表設定）
2hermes gateway install → plist：~/Library/LaunchAgents/ai.hermes.gateway.plist
3hermes gateway start → hermes gateway status
4日誌：tail -f ~/.hermes/logs/gateway.log
5之後新裝 Homebrew/nvm 工具，需再跑 hermes gateway install 更新 PATH

💡整合邊界：Telegram、Discord、BlueBubbles（iMessage）等是否可用以官方 Messaging 文件為準；iMessage 需另有一台常開 Mac 跑 BlueBubbles Server，本文不承諾一鍵可用。

七Recovery：裝失敗先查什麼

現象	優先排查
`hermes: command not found`	Shell PATH → `source ~/.zshrc`
API 呼叫失敗	`hermes model` / `hermes config check`
Gateway 起不來	`hermes gateway status`、日誌、平台 token 與 allowlist
重開機後服務消失	是否只跑了前景 `hermes gateway`，未 `gateway install`
WhatsApp 報 node/ffmpeg 找不到	重跑 `hermes gateway install` 更新 plist PATH
更新後設定異常	`hermes config migrate`、`hermes update`

八24 小時觀察清單

①重新啟動 Mac → hermes gateway status 仍為 running
②斷網 5 分鐘再恢復，看 Gateway 是否自恢復或需手動 start
③抽查 ~/.hermes/logs/ 是否有異常堆疊
④核對 LLM 帳單，避免工具迴圈導致費用飆升
⑤故意觸發一次危險指令，確認核准流程仍生效

九在 Mac mini 上，Agent 更適合 7×24 常駐

Hermes 的 Gateway、BlueBubbles 橋接與本機工具鏈都依賴穩定的 macOS 環境。Mac mini M4 憑藉 Apple Silicon 統一記憶體與約 4W 級待機功耗，適合作為家庭或小團隊的靜默 Agent 節點：原生 Unix、Homebrew、Docker 與 launchd 無需 WSL；Gatekeeper 與 FileVault 降低長期暴露面的風險；當機率低於多數同價位 Windows 主機，更適合無人值守跑 Gateway。

若你計畫把本文清單落實為「週末裝完、下週一直線上」的 Agent 主機，Mac mini M4 是目前性價比很高的起點——現在即可入手，讓 Hermes 跑在真正為長期運行設計的硬體上。

五段式速查

①Before install：硬體、網路、備份
②Install：一行腳本 + hermes doctor
③First run：model、對話、權限
④Keep running：gateway install + launchd
⑤Recovery：PATH → API → Gateway → 日誌

nuzcloud · Mac 雲端伺服器

用 Mac mini 跑常駐 Hermes Agent

專屬 Mac mini M4 裸機，秒級開通 · 適合 Gateway 7×24、本機 Agent 與遠端開發。讓安裝清單真正長期線上。

立即開通 →

2026 年 Hermes Agent Mac 版最新安裝清單：週末動手前最該準備什麼？