最近在開源 Agent 圈里，Hermes Agent 的名字反復(fù)出現(xiàn)在各種討論中。有人戲稱它為"愛馬仕 Agent"，起初我也以為這又只是一個(gè)新出的 AI CLI 工具。但在實(shí)際部署體驗(yàn)一周后，我發(fā)現(xiàn)它與普通 Agent 之間的差異很明顯——它不只是在"完成任務(wù)"，而是在每一次交互中沉淀經(jīng)驗(yàn)，用一套學(xué)習(xí)閉環(huán)讓自己變得越來越好用。

這篇文章將我從零開始部署 Hermes Agent 并接入飛書的完整過程做一個(gè)系統(tǒng)梳理，希望能幫助想入手的同學(xué)降低試錯(cuò)成本。

一、Hermes Agent 是什么

簡單來說，Hermes Agent 是由 AI 研究機(jī)構(gòu) Nous Research 開發(fā)的開源自主 AI 智能體框架，遵循 MIT 開源協(xié)議，這意味著使用上手門檻幾乎為零。它的核心定位是——一個(gè)運(yùn)行在你自己服務(wù)器上、越用越聰明的 AI Agent。

與常見 AI Agent 的關(guān)鍵區(qū)別在于，它內(nèi)置了一套閉環(huán)學(xué)習(xí)機(jī)制：

• 記住跨會(huì)話上下文：通過 FTS5 全文搜索與 LLM 摘要，能夠搜索數(shù)周前的對(duì)話細(xì)節(jié)，而不是"聊完就忘"。
• 自主沉淀技能文檔：完成復(fù)雜任務(wù)后，將經(jīng)驗(yàn)自動(dòng)提煉為可復(fù)用的結(jié)構(gòu)化 Skill 文件。
• 持續(xù)自我改進(jìn)：技能在使用中會(huì)持續(xù)優(yōu)化，越用越好用。

這套體系意味著，Hermes 不僅執(zhí)行任務(wù)，還能在實(shí)踐中不斷反思、學(xué)習(xí)、進(jìn)化，而無需用戶手動(dòng)來微調(diào)或編寫提示詞。

Hermes 支持 400+ 模型調(diào)用（包括 OpenAI、Claude、Ollama 本地模型、Kimi 等），并通過 Telegram、Discord、飛書等多個(gè)消息平臺(tái)與用戶交互，可 7×24 小時(shí)在服務(wù)器上自主運(yùn)行。

二、安裝前的環(huán)境準(zhǔn)備

在動(dòng)安裝前，先確認(rèn)環(huán)境滿足要求：

• 操作系統(tǒng)：Linux（主流發(fā)行版）、macOS、Windows WSL2、Android Termux 均可。
• Python：3.10+（不用手動(dòng)裝，安裝腳本會(huì)自動(dòng)處理）。
• Git：需要手動(dòng)裝一下。
• 內(nèi)存：建議 4GB+，如果打算本地跑 7B+ 模型的話建議 16GB+。
• 網(wǎng)絡(luò)：需要能夠正常訪問 GitHub（因?yàn)榘惭b腳本需要從倉庫下載）。

Windows 不支持原生環(huán)境，一定要先啟用 WSL2（管理員 PowerShell 中執(zhí)行 wsl --install）。

三、一行命令完成安裝

環(huán)境就緒后就可以開始安裝了。Hermes 的安裝方式是目前見過的開源 Agent 里最簡單的那檔——一條命令行搞定。

打開終端（Windows 用戶在 WSL2 的 Ubuntu 終端中），執(zhí)行：

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

這條命令會(huì)自動(dòng)檢測并安裝所有必需依賴：uv（Python 包管理）、Python 3.10+、Node.js、ripgrep、ffmpeg 等，無需逐一手動(dòng)安裝。

腳本跑完后，如果看到 “Starting setup wizard”，那恭喜你，安裝成功。

四、按照向?qū)瓿沙跏寂渲?/h2>

安裝成功后會(huì)自動(dòng)進(jìn)入交互式初始配置向?qū)?。這個(gè)過程決定了 Hermes 的"大腦"用哪個(gè)模型，以及一會(huì)兒要在哪些平臺(tái)上用。

4.1 選擇配置模式

向?qū)?huì)給出兩個(gè)選擇：

• Quick setup：適合新手，按流程一步步配就完事。
• Advanced setup：適合有經(jīng)驗(yàn)的老手，想細(xì)化配置的用這個(gè)。

新手同學(xué)直接選 Quick setup 就行。

4.2 配置模型供應(yīng)商

這里你根據(jù)自己的情況來選：

• 有 OpenAI / Anthropic / Kimi 等 API Key：在 provider 列表里直接選對(duì)應(yīng)服務(wù)商，然后填入 API Key 和 Model Name。
• 要用 Ollama 跑本地模型：選 Ollama provider，確認(rèn)本地服務(wù)地址（通常是 http://localhost:11434）。
• 使用自定義 API 端點(diǎn)（比如火山方舟、阿里云百煉）：選 “Custom endpoint (enter URL manually)”，然后手動(dòng)填 API Base URL 和 Key。

4.3 消息平臺(tái)選擇（建議先跳過）

在向?qū)У南⑵脚_(tái)列表中，可能沒有飛書選項(xiàng)，這屬于正常。建議在這個(gè)環(huán)節(jié)直接選擇 Skip，飛書的接入我們后面通過 hermes gateway setup 單獨(dú)來做。

4.4 驗(yàn)證安裝

配置完成后，在終端輸入：

hermes

進(jìn)入交互式 CLI 界面，隨便輸入一句，如果能正常收到響應(yīng)，就說明安裝和模型配置已經(jīng) OK 了。

五、飛書接入完整流程

安裝配置沒問題之后，接下來就是飛書對(duì)接。

整個(gè)飛書接入分為兩大步：飛書開放平臺(tái)側(cè)配置（獲取 App ID、App Secret、配置回調(diào)）和 Hermes 側(cè)配置（Gateway 設(shè)置）。

5.1 飛書開放平臺(tái)側(cè)配置

第一步：創(chuàng)建企業(yè)自建應(yīng)用

登錄 飛書開放平臺(tái)，進(jìn)入開發(fā)者后臺(tái)，點(diǎn)擊 「創(chuàng)建企業(yè)自建應(yīng)用」，輸入應(yīng)用名稱和應(yīng)用描述后點(diǎn)創(chuàng)建。應(yīng)用名稱會(huì)對(duì)應(yīng)之后用戶在飛書上搜到的機(jī)器人名，建議取一個(gè)好記的。

第二步：添加機(jī)器人能力

在應(yīng)用詳情頁左側(cè)，找到 「添加應(yīng)用能力」，然后勾選 「機(jī)器人」 能力添加。

第三步：配置必要權(quán)限

左側(cè)導(dǎo)航欄進(jìn)入 「權(quán)限管理」，至少需要添加：

• im:message — 獲取與發(fā)送消息的核心權(quán)限
• im:resource — 獲取消息中的資源文件

如果想讓機(jī)器人在群聊中也穩(wěn)定工作，建議再補(bǔ)上 im:chat:readonly 和 admin:app.info:readonly。

第四步：獲取 App ID 和 App Secret

左側(cè)導(dǎo)航欄進(jìn)入 「憑證與基礎(chǔ)信息」，找到 App ID 和 App Secret，這兩樣先存好，一會(huì)兒 Hermes 側(cè)配置就靠它了。

第五步：配置事件訂閱

左側(cè)導(dǎo)航欄進(jìn)入 「事件與回調(diào)」，在訂閱方式里選擇 「長連接」，然后添加事件 im.message.receive_v1。這樣每當(dāng)有用戶在飛書里給機(jī)器人發(fā)消息時(shí)，Hermes 就能第一時(shí)間收到回調(diào)事件。

第六步：發(fā)布應(yīng)用

完成以上配置后，在左側(cè)導(dǎo)航欄進(jìn)入 「版本管理與發(fā)布」，創(chuàng)建新版本并提交發(fā)布。審核通過后，飛書內(nèi)就能搜到并開始用了。

5.2 Hermes 側(cè)配置

飛書側(cè)的準(zhǔn)備工作都搞完了，現(xiàn)在回到 Hermes 的終端環(huán)境：

第一步：啟動(dòng) Gateway 配置向?qū)?/strong>

hermes gateway setup

hermes gateway start