Hermes Agent 是 Nous Research 推出的 AI 自主智能體（AI Autonomous Agent），能輕松執(zhí)行各類復(fù)雜任務(wù)，比如自動編寫代碼、執(zhí)行終端命令、操作瀏覽器、規(guī)劃并完成任務(wù)，以及進(jìn)行文件讀寫和腳本生成，是開發(fā)、運(yùn)維和研究的得力助手。

本文將詳細(xì)介紹如何通過 Docker 快速部署 Hermes Agent，部署前先為大家提供 Docker 一鍵安裝與鏡像加速方案，適配絕大多數(shù)場景，新手也能輕松上手。

一、Docker 一鍵安裝與鏡像加速（推薦方案）

本方案支持 ?? 測試環(huán)境和 ?? 生產(chǎn)環(huán)境（需提前審計），提供的 Linux Docker & Docker Compose 一鍵安裝配置腳本，可適配 13 種主流 Linux 發(fā)行版（含國產(chǎn)系統(tǒng)），能一鍵完成 Docker、Docker Compose 的安裝，以及軒轅鏡像加速配置，全程無需手動操作，極大提升部署效率。

1. 執(zhí)行命令

?? 測試環(huán)境（快速體驗(yàn)，僅限非生產(chǎn)場景）

bash <(wget -qO- https://xuanyuan.cloud/docker.sh)

?? 生產(chǎn)環(huán)境（推薦，安全優(yōu)先）

# 1. 下載腳本到本地
wget https://xuanyuan.cloud/docker.sh -O docker-install.sh
# 2. （可選）審計腳本源碼（建議企業(yè)環(huán)境必做）
less docker-install.sh  # 或使用vim、cat查看腳本內(nèi)容
# 3. 執(zhí)行腳本
bash docker-install.sh

2. 安全強(qiáng)制提示

?? 請注意：curl | bash / wget | bash 這種直接執(zhí)行遠(yuǎn)程腳本的方式，僅建議用于測試、個人學(xué)習(xí)或非核心環(huán)境，生產(chǎn)環(huán)境嚴(yán)禁直接使用；

?? 金融、政務(wù)、內(nèi)網(wǎng)等敏感環(huán)境，必須先將腳本下載到本地，進(jìn)行全面的安全審計，確認(rèn)無惡意代碼后，再執(zhí)行安裝操作。

二、準(zhǔn)備環(huán)境

完成 Docker 安裝后，需確認(rèn)環(huán)境已滿足以下條件：

• 已安裝 Docker（Linux 系統(tǒng)通過上述一鍵腳本安裝即可）；
• Windows / Mac 系統(tǒng)需安裝 Docker Desktop。

驗(yàn)證 Docker 是否正常運(yùn)行，執(zhí)行以下命令：

docker version

若能正常顯示 Docker 版本信息，說明環(huán)境準(zhǔn)備就緒。

三、拉取 Hermes Agent 鏡像

Hermes Agent 鏡像國內(nèi)地址：https://xuanyuan.cloud/zh/r/nousresearch/hermes-agent

使用以下命令拉取 Hermes Agent 最新鏡像，通過軒轅鏡像加速，拉取速度更快、更穩(wěn)定：

docker pull docker.xuanyuan.run/nousresearch/hermes-agent:latest

拉取成功后，會顯示類似如下輸出，說明鏡像拉取完成：

Status: Downloaded newer image
docker.xuanyuan.run/nousresearch/hermes-agent:latest

四、創(chuàng)建數(shù)據(jù)目錄

Hermes Agent 運(yùn)行過程中，需要持久化存儲配置文件、會話數(shù)據(jù)等，因此需提前創(chuàng)建一個本地目錄，用于掛載到容器中，避免容器刪除后數(shù)據(jù)丟失。

Linux / Mac 系統(tǒng)

mkdir -p ~/.hermes

Windows 系統(tǒng)（PowerShell 中執(zhí)行）

mkdir C:\Users\用戶名\hermes

說明：將命令中的“用戶名”替換為你自己的 Windows 用戶名即可。該目錄主要用于存儲以下內(nèi)容：

• config.yaml（核心配置文件）
• .env（環(huán)境變量配置文件）
• sessions（會話數(shù)據(jù)）
• logs（運(yùn)行日志）
• memories（Agent 記憶數(shù)據(jù)）

五、初始化 Hermes Agent

首次運(yùn)行 Hermes Agent 時，需要執(zhí)行初始化向?qū)?，配置核心參?shù)（如模型提供商、API Key 等），步驟簡單，跟著提示操作即可。

Linux / Mac 系統(tǒng)

docker run -it --rm \
-v ~/.hermes:/opt/data \
docker.xuanyuan.run/nousresearch/hermes-agent:latest setup

Windows 系統(tǒng)（PowerShell 中執(zhí)行）

docker run -it --rm `
-v C:\Users\用戶名\hermes:/opt/data `
docker.xuanyuan.run/nousresearch/hermes-agent:latest setup

說明：同樣需將“用戶名”替換為你自己的 Windows 用戶名，執(zhí)行命令后，會進(jìn)入初始化向?qū)Ы缑妗?/p>

六、初始化配置說明

初始化向?qū)е饕?3 個核心步驟，下面為大家詳細(xì)說明，新手可直接參考推薦選項(xiàng)操作：

1. 選擇初始化方式

向?qū)峁┒喾N初始化方式，推薦選擇以下選項(xiàng)，適合快速啟動，無需配置復(fù)雜參數(shù)：

Quick setup — provider, model & messaging

該模式僅配置模型提供商、模型版本和消息相關(guān)的核心參數(shù)，上手速度最快，適合首次體驗(yàn)和本地測試。

2. 選擇模型 Provider

Hermes Agent 支持多種主流模型服務(wù)，大家可根據(jù)自己的需求和擁有的 API Key 選擇，常見選項(xiàng)包括：

• OpenAI
• Anthropic
• DeepSeek
• xAI
• Alibaba Cloud（阿里云）
• Google

選擇對應(yīng) Provider 后，按照提示填寫該平臺的 API Key 即可（API Key 需提前在對應(yīng)平臺申請）。

3. 是否連接消息平臺

Hermes Agent 支持接入 Telegram、Discord 等聊天平臺，方便通過聊天工具操作 Agent。如果只是在本地測試，不打算接入外部聊天平臺，建議選擇：

Skip — set up later

后續(xù)如果需要接入消息平臺，可通過后續(xù)的管理命令重新配置。

七、初始化完成

按照向?qū)瓿伤信渲煤?，會看到以下提示，說明初始化成功：

? Setup Complete!

初始化生成的配置文件，會自動存儲在容器的 /opt/data 目錄下，由于我們之前配置了本地目錄掛載，實(shí)際對應(yīng)本地的：

• Linux / Mac：\~/\.hermes 目錄
• Windows：C:\\Users\\用戶名\\hermes 目錄

后續(xù)如果需要修改配置，直接編輯本地目錄下的 config.yaml 和 .env 文件即可。

八、啟動 Hermes Agent

初始化完成后，執(zhí)行以下命令，即可啟動 Hermes Agent 并進(jìn)入 CLI 交互模式，開始使用 Agent 完成各類任務(wù)。

docker run -it --rm \
-v ~/.hermes:/opt/data \
docker.xuanyuan.run/nousresearch/hermes-agent:latest

啟動成功后，會看到以下提示，說明已進(jìn)入交互模式：

Welcome to Hermes Agent!
Type your message or /help for commands

此時輸入任意指令，即可與 Hermes Agent 交互，比如輸入“hello”測試對話，或輸入任務(wù)指令讓 Agent 執(zhí)行。

九、常用命令

為大家整理了 Hermes Agent 最常用的幾個命令，方便日常使用：

• 查看幫助（了解所有可用命令）：/help
• 測試對話：hello
• 生成代碼示例（如監(jiān)控 CPU 使用率的 Python 腳本）：create a python script that monitors cpu usage
• 生成 Docker Compose 配置（如 WordPress + MySQL）：write a docker\-compose for wordpress and mysql

十、Hermes Agent 能力概覽

Hermes Agent 內(nèi)置多種實(shí)用工具能力，能滿足不同場景的需求，核心能力包括：

• Browser Automation（瀏覽器自動化：自動操作網(wǎng)頁、爬取數(shù)據(jù)等）
• Terminal Commands（終端命令執(zhí)行：直接執(zhí)行系統(tǒng)命令，完成運(yùn)維任務(wù)）
• Task Planning（任務(wù)規(guī)劃：拆分復(fù)雜任務(wù)，逐步執(zhí)行并完成）
• File Operations（文件讀寫：創(chuàng)建、編輯、刪除本地文件）
• Code Execution（代碼執(zhí)行：運(yùn)行各類編程語言代碼，驗(yàn)證效果）

除此之外，Hermes Agent 還支持?jǐn)U展能力，比如網(wǎng)頁搜索、圖像識別、圖像生成、GitHub 相關(guān)操作等，這些擴(kuò)展功能可通過以下命令配置：

hermes setup tools

十一、常用管理命令

如果后續(xù)需要修改配置、檢查系統(tǒng)狀態(tài)，可使用以下管理命令，無需重新初始化：

• 重新運(yùn)行配置向?qū)Вㄐ薷乃信渲茫?code>hermes setup
• 修改模型配置（更換模型 Provider 或 API Key）：hermes setup model
• 配置消息網(wǎng)關(guān)（后續(xù)接入 Telegram、Discord 等）：hermes setup gateway
• 檢查系統(tǒng)狀態(tài)（排查運(yùn)行異常）：hermes doctor

總結(jié)

通過 Docker 部署 Hermes Agent 非常簡單，全程只需三個核心步驟，新手也能快速上手：

• 拉取 Hermes Agent 鏡像（通過軒轅鏡像加速，速度更快）；
• 運(yùn)行初始化向?qū)?，配置核心參?shù)（模型、API Key 等）；
• 啟動 Agent，進(jìn)入交互模式，開始使用。

Hermes Agent 特別適合以下場景：

• AI 自動化任務(wù)（替代重復(fù)手動操作）；
• 開發(fā)輔助（自動生成代碼、調(diào)試腳本）；
• DevOps 自動化（執(zhí)行運(yùn)維命令、部署服務(wù)）；
• 研究與實(shí)驗(yàn)環(huán)境（快速驗(yàn)證 AI 任務(wù)執(zhí)行效果）。

如果需要在生產(chǎn)環(huán)境部署，也可以結(jié)合 Docker Compose 或 Kubernetes 進(jìn)行擴(kuò)展，實(shí)現(xiàn)更穩(wěn)定、可擴(kuò)展的部署架構(gòu)。

到此這篇關(guān)于Docker 部署 Hermes Agent 完整實(shí)戰(zhàn)指南(Windows / Linux 通用)的文章就介紹到這了,更多相關(guān)Docker 部署 Hermes Agent 內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論