設定手冊 · Field Manual 2026
hermes-agent.nousresearch.com · gmail · slack · mac mini
H
常駐代理設定手冊 · Gmail · Slack · Mac mini

把 Mac mini 變成
會收信、會回 Slack 的常駐代理。

所謂「Jarvis」拆開來是四件具體的事:一個常駐在 Mac mini 上的代理、一個連接 Gmail 與 Slack 的訊息閘道、一組能操作整台主機的本機工具,以及用自然語言排定的無人值守任務。Hermes Agent 把這四件事整合在同一套開源系統裡。本手冊依官方文件整理安裝、Gmail App Password 設定、Slack manifest 設定、本機工具與排程的完整步驟,最後附上 Reddit r/hermesagent 的熱門討論。

23
訊息平台閘道
60+
本機內建工具
15s
Gmail 收信輪詢
125K
r/hermesagent 週訪
01
先搞清楚架構

「Jarvis」是四個元件
疊在一台 Mac mini 上。

Hermes Agent 是 Nous Research 開源的自主型 AI 代理,授權為 MIT,定位是常駐在你自己機器上、會記住所學、執行越久越強的代理。把它變成「Jarvis」不是一個按鈕,而是把四個元件接起來:代理本體(常駐行程,存於 ~/.hermes)、gateway(連接 Gmail、Slack 等 23 個平台的單一背景行程)、本機工具(讓代理讀寫檔案、執行終端機與瀏覽器,操作整台 Mac mini)、以及 cron 排程(以自然語言排定無人值守任務,gateway 每 60 秒檢查一次)。

關鍵在於 gateway。它是一個獨立的背景行程,同時掛載多個平台 adapter——你可以一邊接 Gmail、一邊接 Slack,訊息進來後經各自的 session store 路由到代理處理,完成後再從同一管道送回。這也是為什麼「從 Slack 下指令、結果寄到 Gmail」這類跨平台流程可以一次設定:它們共用同一個 gateway。

為什麼選 Mac mini:它低耗電、可以長期不關機,適合當 always-on 主機。代理需要的是一台 24 小時開著、能跑終端機與本機工具的機器,Mac mini 正好符合。下面六節依序處理:安裝與常駐、連 Gmail、連 Slack、開放本機操作、排 Jarvis 任務、以及上線前的安全邊界。

Jarvis = 四個元件
代理本體+ Gmail / Slack gateway+ 本機工具+ cron 排程= 常駐助理
we really got jarvis at home in 2026 but strangely enough no one seems to care
— @mishig25 · X · 2026 年 4 月(搭配 Hermes Agent 的實測貼文)
02
安裝與常駐

在 Mac mini 上裝好,
並讓它不睡覺。

Mac mini 需 macOS 12 以上。到官方網站 hermes-agent.nousresearch.com/desktop 下載 DMG 安裝桌面版,或在終端機貼下方一行腳本安裝命令列版本。兩者共用同一份 ~/.hermes 設定,擇一即可。安裝後重新載入 shell 設定就能使用 hermes 指令。

# 一行安裝腳本(官方來源) curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash source ~/.zshrc

設定精靈與模型

執行 hermes setup 走完設定精靈,涵蓋模型存取與工具。再用 hermes model 選模型供應商,或 hermes setup --portal 直接走 Nous Portal。模型有硬性門檻:上下文視窗需至少 64,000 tokens,不足會在啟動時被拒絕。

hermes setup # 完整設定精靈 hermes model # 選擇模型供應商(需 ≥ 64k 上下文) hermes --tui # 開啟終端介面確認可用

讓 Mac mini 保持常駐

Jarvis 的前提是主機一直開著。把 gateway 安裝成使用者服務,登入後自動啟動;再用系統內建的 caffeinate 防止待命,讓代理在你離開時仍能收信、回 Slack、跑排程。在「系統設定 → 能源」把「電源中斷後自動開機」「進入睡眠時間」一併設成不睡眠更穩。

hermes gateway install # 安裝成使用者服務(登入自動啟動) caffeinate -i -s & # 防止系統待命(背景執行)
模型怎麼選。官方支援 30 種以上供應商,包含 Nous Portal、Anthropic Claude、OpenAI、OpenRouter、Qwen、DeepSeek、Gemini、xAI Grok,以及本機的 Ollama 與 LM Studio。社群現多用 OpenRouter 上的免費或低價模型(如 DeepSeek)壓低 always-on 成本;只要上下文達 64k 即可。可在設定精靈隨時切換。
03
連接 Gmail

讓代理會收信、
也會回信。

Gmail 走 Email 閘道,以 IMAP 收信、SMTP 寄信。Gmail 不接受用一般密碼做程式登入,必須先開兩步驟驗證、再產生一組 16 碼的「應用程式密碼」(App Password)給代理用。設定有兩條路:互動精靈 hermes gateway setup 選 Email,或手動把變數寫進 ~/.hermes/.env。

步驟一:取得 Gmail App Password

到 Google 帳號開啟兩步驟驗證,再到 myaccount.google.com/apppasswords 產生一組應用程式密碼,選「Mail」或「Other」,複製那 16 碼字串。後面用它取代一般密碼。

步驟二:寫入閘道設定

執行精靈會逐項問你信箱、密碼、IMAP/SMTP 主機與允許的寄件人;或直接編輯 ~/.hermes/.env。Gmail 的主機與連接埠是固定值:

# 用「應用程式密碼」,不是你的 Gmail 一般密碼 EMAIL_ADDRESS=hermes@gmail.com EMAIL_PASSWORD=abcd efgh ijkl mnop # 16 碼 App Password EMAIL_IMAP_HOST=imap.gmail.com EMAIL_SMTP_HOST=smtp.gmail.com EMAIL_IMAP_PORT=993 EMAIL_SMTP_PORT=587 EMAIL_ALLOWED_USERS=you@email.com,boss@work.com # 只接受這些寄件人 EMAIL_POLL_INTERVAL=15 # 每 15 秒檢查收件匣

步驟三:啟動閘道

設定完成後啟動 gateway。前景模式適合先確認連線;確認無誤後改用服務模式,讓它在 Mac mini 上常駐。

hermes gateway # 前景模式,先測試 hermes gateway install # 安裝成使用者服務,常駐
別用你的主信箱。官方文件明確建議不要把代理接到個人 Gmail——它需要儲存密碼、並擁有完整收件匣存取權。較安全的做法是開一個專用 Gmail 給代理,再用 EMAIL_ALLOWED_USERS 把可下指令的寄件人限制成只有你自己。EMAIL_POLL_INTERVAL 預設 15 秒,決定它多久檢查一次新信。
04
連接 Slack

在 Slack 裡
@Hermes 就能下指令。

Slack 走 Socket Mode,需要兩組 token:Bot Token(xoxb-)與 App-Level Token(xapp-)。最快的方式不是手動勾權限,而是用 Hermes 產生 app manifest——它把所有需要的 scope、事件訂閱與斜線指令都預先寫好,直接上傳到 Slack 即可。

步驟一:用 manifest 建立 Slack App

產生 manifest JSON,到 Slack 的 Create New App → From an app manifest 上傳。它會建立一個已設定好 Socket Mode 與權限的 App。

hermes slack manifest --write # 產生含所有 scope 的 manifest JSON # 到 api.slack.com/apps → Create New App → From an app manifest 上傳

步驟二:填入兩組 token

安裝 App 到工作區後取得 Bot Token;在 Socket Mode 設定裡用 connections:write scope 產生 App-Level Token。走 hermes gateway setup 選 Slack 會逐項問你,或手動寫進 ~/.hermes/.env:

SLACK_BOT_TOKEN=xoxb-your-bot-token SLACK_APP_TOKEN=xapp-your-app-token # Socket Mode SLACK_ALLOWED_USERS=U01ABC2DEF3 # 限制可下指令的 Slack 使用者 # 多個工作區?token 用逗號串接,共用同一個 app token # SLACK_BOT_TOKEN=xoxb-ws1-token,xoxb-ws2-token

步驟三:邀請 bot 進頻道

bot 不會自己加入頻道,要明確邀請。在目標頻道輸入:

/invite @Hermes Agent

必要的 scope

manifest 已含這些權限,手動建立時別漏:chat:write(送訊息)、channels:history 與 groups:history(收頻道訊息,缺這兩個 bot 收不到任何訊息)、app_mentions:read(偵測 @ 提及)、files:read(讀附件)。

Gmail 與 Slack 共用同一個 gateway。兩者都設定好後,同一個 hermes gateway 行程會同時掛載 Email 與 Slack adapter。這讓「在 Slack 下指令、把結果寄到 Gmail」這種跨平台流程不需額外接線——它們本來就在同一條管道上。第三方教學(Alex Merced,iceberglakehouse.com)記載在已啟動的代理上加 Slack 約需 10 分鐘。
05
掌控整台 Mac mini

把主機交給代理:
它能讀檔、跑指令、開瀏覽器。

「掌控整台 Mac mini」實際上是兩件事:一是代理用哪些本機工具,二是這些工具跑在哪個沙箱後端。Hermes 內建工具超過 60 種,其中操作本機的核心是檔案系統、終端機與瀏覽器自動化。執行後端則決定代理的指令落在哪裡——直接動主機(local)、或框在容器/遠端裡(Docker、SSH、Modal)。要當 Jarvis 通常用 local 後端,代價是它對主機的權限較大,務必搭配第 08 節的邊界設定。

本機 · 01
Filesystem
讀寫檔案
讀取、整理、轉換 Mac mini 上的檔案與資料夾。整理下載、批次改名、抽取文件內容皆走這組工具。
本機 · 02
Terminal
執行指令
開終端機跑 shell 與 Python。安裝套件、跑腳本、SSH 到別台機器、部署專案,都由代理在主機上實際執行。
本機 · 03
Browser
操作瀏覽器
透過 CDP 驅動本機 Chrome / Brave / Edge,或用 headless Chromium。導覽網站、填表單、抓資料。亦支援雲端瀏覽器 Browserbase。
本機 · 04
Web Search
查網路
web_search 與 web_extract,後端可選 Firecrawl、Tavily、Exa、Parallel。讓代理在執行任務時即時取得外部資訊。
本機 · 05
Voice
語音進出
文字轉語音(Edge TTS、ElevenLabs、OpenAI 等)與語音轉文字(含本機 faster-whisper)。語音下指令、語音回報。
擴充 · 06
MCP
接外部系統
以 Model Context Protocol(stdio / SSE)接 GitHub、資料庫、檔案系統、內部 API。內建工具不夠時從這裡補。
擴充 · 07
Subagents
子代理
委派隔離子代理跑平行工作,各自有對話、終端機與 Python RPC 腳本,彼此不污染脈絡。重活分流。
後端 · 08
Sandbox
執行後端
local、Docker、SSH、Singularity、Modal 五種後端,並有容器強化。要它動整台主機選 local;要隔離選其餘。
local 後端 = 完整主機權限。選 local 時,代理跑的指令就跟你在終端機裡敲的一樣有效力——這正是「掌控整台 Mac mini」的意思,也是風險所在。第 08 節會給出限縮做法。要先試水溫,可先用 Docker 後端讓它在容器裡跑,確認行為符合預期再放開。
06
排 Jarvis 任務

用自然語言排程,
結果送到 Gmail 或 Slack。

最後一塊拼圖是排程。Hermes 的 cron 由 gateway 每 60 秒檢查一次;你不必寫 cron 語法,直接用自然語言交代「什麼時候、做什麼、送到哪」,代理會把它登記成排程。以下是一段串起前面所有設定的示意流程:從 Slack 下指令、代理操作主機、並排定每日把收件匣摘要貼回 Slack。指令為官方記載的 hermes 子指令;對話內容為說明用途的改寫。

hermes · mac mini · gateway
# 一次設好兩個平台:Email 與 Slack $ hermes gateway setup ? 選擇平台:[x] Email [x] Slack ✓ Email(Gmail)已連線 · 輪詢 15s ✓ Slack 已連線 · Socket Mode $ hermes gateway install # 常駐
# 從 Slack 頻道 @ 它下指令 #ops › @Hermes 把 ~/Downloads 裡今天的發票 PDF 抽成文字,整理到 ~/invoices。
Hermes › [tool: filesystem · 找到 5 個 PDF] [tool: terminal · pdf→text · 5/5] ✓ 已寫入 ~/invoices · 我把它存成技能,下次直接用。
# 用自然語言排每日任務 #ops › @Hermes 每個工作日早上 9 點,彙整我的 Gmail 收件匣,貼到這個 Slack 頻道。
Hermes › 已排程。每個工作日 09:00 讀取 Gmail、產生摘要, 貼到 #ops。你不在也會自動跑。
[schedule: 0 9 * * 1-5 · read=gmail · deliver=slack#ops] ✓ 已啟用 · 無人值守 · gateway 每 60s 檢查一次

幾個可直接照抄的排程

以下指令型態取自官方 user stories 與社群貼文,改寫成中文:
·「每個工作日 9am,彙整我的 inbox 並貼到 Slack。」
·「每天早上掃 Hacker News 的 AI 新聞,用 Telegram DM 我。」
·「每天早晚各做一次 standup,把各專案進度彙整給我。」
重點在最後一句的「送到哪」——指定 Gmail、Slack 或其他已連的平台,代理就會用對應 adapter 送達。

這是一個會重複的工作,我把它存成技能,下次直接用。
— Hermes 的閉環學習:排程化的任務會沉澱成可調用技能
07
Reddit 上的討論

社群在 r/hermesagent
聊些什麼。

Hermes 的討論主場是非官方版 r/hermesagent,每週約 125K 訪客、5.6K 則貼文與留言,並設有 Hermes Desktop megathread 與「這週你用 Hermes 做了什麼」固定主題。以下整理該版熱門貼文(標題、作者、分類為實際觀察;Reddit 阻擋自動抓取,故不列票數)。內容反映社群觀點,非官方說明。

熱門 01

用一個月後,我希望早點知道的事

作者最大心得:別在第一天就想把整套機器建好。先讓一個小工作流穩定到無聊,再加下一塊。並指出 profiles 不只是方便功能,而是控制代理的關鍵;「設定不是雜務,是產品本身」——很多「Hermes 怪怪的」其實是設定問題。

r/hermesagent · u/itsdodobitch · Discussion
熱門 02

真的被它能做的事震撼到

三週的基本設定:幾個 cron 跑新聞與提醒、做些 side project 的 dev 工作,主要用 OpenRouter 免費模型,只花了 10 美元額度。整個週末用 Telegram 語音訊息與截圖,讓它規劃、實作、測試、部署一個小生意用的 bot,token 成本約 1.5 美元。

r/hermesagent · u/Little-Tea7664 · Use Case
熱門 03

Hermes 的價值是「你自己擁有的編排器」

討論雲端模型計費收緊後,主張 Hermes 真正的賣點是:它是跑在你自己硬體上、可換任何工具的 orchestrator。建議把雲端模型當「租來的算力」,設計成可隨時換供應商(OpenRouter、抽象層),讓編排器本身成為你真正擁有的那一塊。

r/hermesagent · u/kenduffy · Discussion
熱門 04

Hermes 衝上 OpenRouter 全球 token 用量第一

社群貼出 Hermes Agent 登上 OpenRouter 全球 token 排行榜第一名,作為使用量與熱度的佐證。搭配多篇「哪個免費模型最適合 Hermes」「DeepSeek v4 幾乎免費還無限」的成本討論,反映多數人靠 OpenRouter 低價模型維持 always-on。

r/hermesagent · u/Dismal_Hair_6558 · Discussion
熱門 05

用 Obsidian 當 AI 助理的長期記憶骨幹

Workshop 類貼文,分享把 Obsidian 當作代理長期記憶後端的做法:讓 Hermes 把脈絡與筆記寫進 Obsidian vault,形成跨 session 可檢索的知識庫。屬於「如何把 Hermes 接進既有工作流」的代表性實作。

r/hermesagent · u/Jonathan_Rivera · Workshop
熱門 06

很多人搞混:拿到 Hermes 後第一件該做的事

Help 類熱帖,針對新手最常見的混淆,說明裝好之後優先該設定什麼(模型、工具、profile)才不會一開始就卡住。版上另有「Hermes agent setup guide」「Kanban 內建功能」等入門與新功能討論串。

r/hermesagent · u/itsdodobitch · Help · Tools/Skills/MCP
版外的一個討論點:「Jarvis at home」。本手冊開頭引用的那句「we really got jarvis at home in 2026 but strangely enough no one seems to care」來自 X(@mishig25)搭配 Hermes 的實測貼文,常被用來概括這類「能力已到位、但多數人還沒注意」的社群情緒。若要追最新討論,r/hermesagent 的固定 megathread 是更新最快的入口。
08
上線前,先看清楚這些

給它權限之前,
知道這些邊界。

  • Gmail 用專用信箱,別接主帳號。官方文件明確建議不要把代理接到你的個人 Gmail——它要儲存密碼並擁有完整收件匣存取。開一個專用 Gmail,並用 EMAIL_ALLOWED_USERS / SLACK_ALLOWED_USERS 把可下指令的人限制成只有你。
  • 閘道等於一個遠端入口。Gmail、Slack 接上後,能對代理下指令的就不只你本人。妥善保管 App Password 與 xoxb / xapp token,別寫進會 commit 的檔案;留意誰能存取那個信箱或頻道。
  • local 後端會直接動到 Mac mini。代理能開終端機、跑 Python、改檔案。要它當 Jarvis 就得給這層權限,但別把它指向不可逆的操作。先用 Docker 後端試水溫,確認行為再放開;重要資料夾另做備份。
  • 排程任務在你不在場時自動執行。cron 任務無人值守。設定「自動刪除」「自動寄送」「自動部署」這類有副作用的任務前,先確認指令範圍,避免非預期的破壞性動作。
  • 雲端模型會累積 API 費用。always-on 代理長對話加排程會持續燒 token。社群多用 OpenRouter 免費 / 低價模型(如 DeepSeek)壓成本;在意花費可改本機 Ollama / LM Studio,前提是上下文達 64k。
  • 把程式化呼叫的計費看清楚。社群討論指出,以 claude -p 之類把外部模型當工具串接時,計費規則與額度可能與訂閱不同、且會變動。讓 Hermes 轉手呼叫付費 API 前,先確認該供應商當前的計費方式。
  • 記憶與設定都在本機 ~/.hermes。持久記憶、技能、.env 憑證都在這個目錄。換機或重灌前先備份;它也包含你的 Gmail / Slack token,務必納入磁碟加密。
  • 版本演進很快。Hermes 更新頻繁(社群提到近期加入 Curator、Kanban、Spotify、Google Meet、Teams 等)。供應商、工具與旗標可能隨版本變動;遇到與本文不符,以 官方文件 與 GitHub 為準。

延伸閱讀

① Messaging Gateway——Gmail、Slack 等 23 平台的設定總覽。
② User Stories——官方整理的使用情境(收件匣彙整、Slack 通報、排程)。
③ r/hermesagent——社群討論、設定指南與 megathread。

The Agent That Grows With You.
— Nous Research,Hermes Agent