使用手冊

常駐代理設定手冊 · Gmail · Slack · Mac mini

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

操作手冊:在 Mac mini 上常駐 Nous Research 的 Hermes Agent,透過 gateway 連接 Gmail 與 Slack、以本機工具操作整台主機、用自然語言排程無人值守任務。含 Gmail App Password 與 Slack manifest 設定步驟,以及 Reddit r/hermesagent 熱門討論整理。依官方文件與社群貼文整理。

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

閱讀時間
11 分
更新日期
開啟原始報告
訊息平台閘道
23
本機內建工具
60+
Gmail 收信輪詢
15s
r/hermesagent 週訪
125K
本頁章節

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 任務、以及上線前的安全邊界。

  1. 代理本體

  2. Gmail / Slack gateway

  3. 本機工具

  4. cron 排程

  5. 常駐助理

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 指令。

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

設定精靈與模型

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

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

讓 Mac mini 保持常駐

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

bash
hermes gateway install     # 安裝成使用者服務(登入自動啟動)
caffeinate -i -s &        # 防止系統待命(背景執行)

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 的主機與連接埠是固定值:

bash
# 用「應用程式密碼」,不是你的 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 上常駐。

bash
hermes gateway              # 前景模式,先測試
hermes gateway install      # 安裝成使用者服務,常駐

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。

bash
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:

bash
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 不會自己加入頻道,要明確邀請。在目標頻道輸入:

bash
/invite @Hermes Agent

必要的 scope

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

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;要隔離選其餘。

06排 Jarvis 任務

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

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

hermes · mac mini · gateway


# 一次設好兩個平台:Email 與 Slack
$ hermes gateway setup
  hl: ? 選擇平台:[x] Email   [x] Slack
  ok: ✓ Email(Gmail)已連線 · 輪詢 15s
  ok: ✓ Slack 已連線 · Socket Mode
$ hermes gateway install   # 常駐


# 從 Slack 頻道 @ 它下指令
$ #ops ›
  @Hermes 把 ~/Downloads 裡今天的發票 PDF 抽成文字,整理到 ~/invoices。


claude: Hermes ›
  [tool: filesystem · 找到 5 個 PDF]
  [tool: terminal · pdf→text · 5/5]
  ok: ✓ 已寫入 ~/invoices · 我把它存成技能,下次直接用。


# 用自然語言排每日任務
$ #ops ›
  @Hermes 每個工作日早上 9 點,彙整我的 Gmail 收件匣,貼到這個 Slack 頻道。


claude: Hermes ›
  已排程。每個工作日 09:00 讀取 Gmail、產生摘要,
  貼到 #ops。你不在也會自動跑。


# [schedule: 0 9 * * 1-5 · read=gmail · deliver=slack#ops]
ok: ✓ 已啟用 · 無人值守 · gateway 每 60s 檢查一次

幾個可直接照抄的排程

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

這是一個會重複的工作,我把它存成技能,下次直接用。

— Hermes 的閉環學習:排程化的任務會沉澱成可調用技能

07Reddit 上的討論

社群在 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

08上線前,先看清楚這些

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

延伸閱讀

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

The Agent That Grows With You.

— Nous Research,Hermes Agent

參考資料