Hermes Agent 是 Nous Research 發布的 MIT 協議 Agent，具備自進化循環：從經驗中建立 Skill、週期性 nudge 持久化記憶、透過 FTS5 檢索歷史會話，並借助 Honcho 建模使用者上下文。在 macOS 上它以原生 CLI 安裝，並可透過單個 hermes gateway 程序連接 Telegram、Discord、Slack、WhatsApp、Signal 與 Email 等訊息閘道。
本指南介紹在 Apple Silicon 或 Intel Mac 上的 macOS 安裝、首次設定、閘道接入，以及用 launchd 保持閘道線上。假設 macOS 15+ 且你控制該機器（MacBook、Mac mini、Mac Studio 或可 SSH 的遠端 Mac）。若已在雲端執行 Agent，請參閱單獨的 Hermes Mac mini M4 教學 了解無頭主機模式；下文命令在任何 Mac 上相同。
安裝前準備
| 要求 | 說明 |
|---|---|
| macOS | 建議 15+；上游安裝腳本支援 Apple Silicon（arm64）與 Intel |
| Shell | zsh（預設）或 bash；安裝器會追加到 ~/.zshrc 或 ~/.bashrc |
| 網路 | 出站 HTTPS（模型 API、可選 Nous Portal OAuth、訊息平台 webhook）；台灣存取 Telegram/部分 API 需自備網路環境 |
| 磁碟 | 為 uv、Python 3.11、Node.js 與 ~/.hermes/ 狀態預留 2–5GB；TTS 資產或大型 Skill 庫需更多空間 |
| 記憶體 | CLI + 閘道 + 一次重度工具呼叫建議 16GB；並行 subagent 或 MCP 伺服器建議 24GB |
安裝器會在缺失時拉取 uv、Python 3.11、Node.js、ripgrep 與 ffmpeg。完成後用 hermes doctor 驗證。
Hermes 在 macOS 上的目錄結構
安裝後狀態位於 ~/.hermes/：
~/.hermes/
├── config.toml # 提供商、工具、終端後端、閘道設定
├── skills/ # 使用者與自動建立的 Skill
│ └── openclaw-imports/ # hermes claw migrate 之後
├── memory/ # 策展記憶檔案
└── logs/ # 閘道與 CLI 日誌（路徑見上游文件）
hermes 二進位連結到 ~/.local/bin/hermes。日常使用涉及三個介面：
- CLI（
hermes） — 互動式 TUI；斜線命令（/model、/skills、/compress、/new）。 - Gateway（
hermes gateway） — 將訊息平台橋接到同一 Agent 循環。 - 終端後端 — shell/檔案工具執行位置：local（macOS 預設）、Docker、SSH、Singularity、Modal 或 Daytona。
模型路由與提供商無關：hermes model 可在 Nous Portal、OpenRouter（200+ 模型）、OpenAI、Anthropic 與 BYO 端點間切換，無需改程式碼。
macOS 分步安裝設定
1. 安裝 Hermes
管道執行前請先在組織內審閱安裝腳本。上游一鍵命令：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
source ~/.zshrc # 或: source ~/.bashrc
hermes doctor
hermes doctor 應報告 uv、Python 3.11、Node、ripgrep 與 ffmpeg 檢查通過。修復標記項後重新執行。
2. 首次設定
完整精靈或 Portal OAuth：
hermes setup # 互動式：提供商、工具、閘道提示
# 或
hermes setup --portal # Nous Portal OAuth + Tool Gateway（搜尋、影像、瀏覽器、TTS）
精靈會偵測 ~/.openclaw 並提示遷移——全新安裝可跳過。
3. 選擇模型與工具
hermes model # 選擇 provider:model（如 openrouter:anthropic/claude-sonnet-4）
hermes tools # 啟用/停用工具集（上游 40+ 工具）
hermes config set KEY VALUE # 細粒度覆寫用短 CLI 會話確認：
hermes
# TUI 內：提問、執行 /usage、Ctrl+D 或 /quit 退出4. 從 OpenClaw 遷移（可選）
若已有 OpenClaw 工作區：
hermes claw migrate --dry-run
hermes claw migrate
通常匯入 SOUL.md 人格、MEMORY.md / USER.md 條目、使用者 Skill、命令白名單、訊息設定與 API 金鑰到 ~/.hermes/。預設見 hermes claw migrate --help。
5. 設定訊息閘道
hermes gateway setup # 平台 token、DM 配對、允許使用者
hermes gateway start # 前台測試
從 Telegram（或你的平台）測試：傳送 /new 再發提示。若機器人顯示線上但無回覆，從訊息側用 /status——常見為配對或白名單問題（見上游 Security 文件）。
6. 用 launchd 持久化閘道
前台 hermes gateway start 在登出後停止。對常開 Mac（桌面 Mac mini、工作室機器或遠端主機），建立使用者 LaunchAgent。範例 plist 骨架——用 which hermes 調整路徑：
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
<key>Label</key><string>com.hermes.gateway</string>
<key>ProgramArguments</key>
<array>
<string>/Users/YOU/.local/bin/hermes</string>
<string>gateway</string>
<string>start</string>
</array>
<key>RunAtLoad</key><true/>
<key>KeepAlive</key><true/>
<key>StandardOutPath</key><string>/Users/YOU/.hermes/logs/gateway.stdout.log</string>
<key>StandardErrorPath</key><string>/Users/YOU/.hermes/logs/gateway.stderr.log</string>
</dict>
</plist>載入：
mkdir -p ~/.hermes/logs
launchctl bootstrap gui/$(id -u) ~/Library/LaunchAgents/com.hermes.gateway.plist
launchctl kickstart -k gui/$(id -u)/com.hermes.gateway
將 Telegram/Discord token 寫入 plist 的 EnvironmentVariables 字典或啟動時引用的 env 檔——避免僅在 SSH 會話中 export。
7. 啟用 cron 式自動化（可選）
Hermes 內建 cron 排程器，可投遞到訊息平台。透過 CLI 或設定用自然語言定義任務，見上游 cron 文件。macOS 上 cron 任務需要閘道（或 CLI）程序持續執行——這也是在不休眠 Mac 上使用 launchd 的原因。
8. 備份 ~/.hermes/
tar -czf hermes-backup-$(date +%Y%m%d).tar.gz -C ~ .hermesSkill 與記憶比聊天日誌更難重建。大版本升級前快照：
hermes update
hermes doctor故障排查
hermes doctor 在 Python 或 uv 上失敗
現象：Doctor 報告缺少 uv 或 Python 版本錯誤。
修復：重新執行安裝腳本。Hermes 透過 uv 需要 Python 3.11。macOS 上也可用 Homebrew：brew install ripgrep ffmpeg node，再執行 hermes doctor。
閘道啟動但機器人不回覆
現象：hermes gateway start 日誌顯示 running；私訊無回應且無聊天內錯誤。
修復：在 hermes gateway setup 中完成 DM 配對 與白名單。更改 token 後重啟閘道。若用 launchd，確認 env 寫入 plist——launchctl print gui/$(id -u)/com.hermes.gateway 可查看注入環境。
CLI 工具權限錯誤
現象：檔案或 shell 工具存取工作區外 macOS 路徑時報錯。
修復：檢查設定中的命令審批設定（上游 Security）。全碟路徑可能觸發 macOS TCC「檔案與資料夾」授權——在執行 local 後端的機器上授予。
何時需要常開 Mac
休眠的 MacBook 會暫停閘道投遞與 cron。從 Telegram 與 Agent 對話而 Agent 在別處執行的團隊，常會備一台小型常開 Mac——桌面 Mac mini 或託管 macOS 實例——由 launchd 管理 hermes gateway。本指南步驟不變；僅睡眠策略與網路可達性不同。SSH 後端工作流（筆電 CLI、遠端 Mac 執行工具）在 config.toml 中指向該主機，見上游 Tools 文件。
安裝完成後，可用
Hermes 多智能體委派一人企業指南
跑通「老闆 + 三名 AI 員工」週報流水線（delegate_task）。
閘道安裝完成後，用 Hermes 跨裝置 Gateway 指南 串聯手機 Telegram 與桌面 Discord。
常見問題
Hermes 能替代 OpenClaw 或 OpenHuman 嗎？
不能——設計不同。Hermes 強調 Skill + 記憶 nudge + 內建 cron；OpenClaw 是 閘道優先自動化；OpenHuman 是 帶 OAuth 自動抓取的桌面記憶。可用 hermes claw migrate 遷移 OpenClaw 資料。對比手冊見 Hermes Mac mini M4 教學 與 OpenClaw macOS 安裝指南。
必須用 Nous Portal 嗎？
不必。Portal（hermes setup --portal）透過一次 OAuth 打包模型與 Tool Gateway。也可直接設定 OpenRouter、OpenAI 或 Anthropic 金鑰並按需啟用工具。
macOS 上設定存在哪？
主目錄：~/.hermes/，含 config.toml、Skill、記憶與日誌。hermes 位於 ~/.local/bin/hermes。請用 hermes config 子命令，勿盲目編輯——精靈值對應文件鍵名。
Hermes 能在 Apple Silicon Mac mini 上執行嗎？
可以——安裝腳本支援 Apple Silicon 上的 macOS。閘道與 local 後端原生執行；uv 安裝的 Python 棧無需 Rosetta。
如何更新 Hermes？
hermes update
hermes doctor更新後重啟 launchd 管理的閘道：launchctl kickstart -k gui/$(id -u)/com.hermes.gateway。