開場(chǎng)：裝完就能用才是硬道理

這篇我手把手帶你裝上Hermes Agent，不廢話，5 分鐘跑通第一條指令。

先確認(rèn)一件事：你不需要買新電腦，也不需要高端配置。 一臺(tái)能跑 Linux/Mac/WSL 的機(jī)器就夠。

一、環(huán)境要求

先確認(rèn)你的系統(tǒng)滿足條件：

Windows 用戶務(wù)必用 WSL2，不要直接用 cmd 或 PowerShell。Hermes 的很多工具（terminal、file 操作）依賴 Unix 環(huán)境。我家里的機(jī)器就是 Windows + WSL2（Ubuntu），生產(chǎn)環(huán)境完全沒問題。

確認(rèn) Python 版本：

python3 --version
# 如果低于 3.11，需要先升級(jí) Python

二、安裝（2種方式）

方式1：一鍵安裝（推薦）

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

裝完驗(yàn)證：

hermes doctor

如果看到類似這樣的輸出，說明安裝成功：

? Python 3.11.7
? Hermes CLI installed
? Core dependencies OK
??  Browser tools not configured (optional)

方式2：國(guó)內(nèi)網(wǎng)絡(luò)加速

如果一鍵安裝卡住（GitHub 被墻），用鏡像：

# 方案A：先配置代理（如果你有）
export https_proxy=http://127.0.0.1:7890
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

# 方案B：手動(dòng)下載 install.sh 后本地執(zhí)行
curl -fsSL -o install.sh https://gh-proxy.com/raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh
bash install.sh

如果 pip 安裝也慢，切換國(guó)內(nèi) PyPI 鏡像：

pip config set global.index-url https://mirrors.aliyun.com/pypi/simple/

踩坑實(shí)錄： GitHub 在大陸的下載速度不穩(wěn)定，如果反復(fù)失敗，用 gh-proxy.com 這樣的鏡像加速。如果 hermes doctor 報(bào)錯(cuò)說缺 Playwright 等依賴，不要慌——后面會(huì)講到怎么處理。

三、配置 API 密鑰（最關(guān)鍵的一步）

Hermes 本身是"空殼"，需要接入大模型才能干活。你需要去模型廠商申請(qǐng) API Key。

推薦方案：DeepSeek（性價(jià)比之王）

對(duì)于國(guó)內(nèi)開發(fā)者，DeepSeek 是首選：

• 價(jià)格： 輸入 ¥0.5/百萬 tokens，輸出 ¥2/百萬 tokens
• 能力： 日常寫代碼、查資料完全夠用
• 注冊(cè)地址： https://platform.deepseek.com/

注冊(cè)后創(chuàng)建 API Key，然后配置：

# 查看 .env 路徑
hermes config env-path
# 輸出：/home/你的用戶名/.hermes/.env

# 寫入 API Key
echo 'DEEPSEEK_API_KEY=sk-你的密鑰' >> ~/.hermes/.env

# 選擇模型
hermes model
# 在彈出的界面中選擇 deepseek 和 chat 模型

# 檢查配置
hermes config check

其他方案（按推薦排序）

配置步驟通用版：

# 1. 編輯 .env 文件
hermes config env-path

# 2. 寫入對(duì)應(yīng)的 API Key 環(huán)境變量
# DeepSeek: DEEPSEEK_API_KEY=sk-xxx
# OpenRouter: OPENROUTER_API_KEY=sk-xxx
# 通義千問: DASHSCOPE_API_KEY=sk-xxx
# Claude: ANTHROPIC_API_KEY=sk-xxx

# 3. 選擇默認(rèn)模型
hermes model

# 4. 驗(yàn)證連通性
hermes chat -q "你好"

踩坑實(shí)錄： 有些教程說用 hermes setup，但那個(gè)向?qū)?huì)問很多問題。建議直接用 hermes model 選模型，簡(jiǎn)單粗暴。

四、跑通第一條指令

裝好了，密鑰配好了，來讓它干第一個(gè)活：

hermes chat -q "看下當(dāng)前系統(tǒng)狀態(tài)，告訴我CPU、內(nèi)存、磁盤使用情況"

你會(huì)看到這樣的輸出：

?? 讓我檢查一下當(dāng)前系統(tǒng)狀態(tài)...

CPU: 4核8線程，當(dāng)前使用率 23%
內(nèi)存: 總計(jì)16GB，已用6.2GB (39%)
磁盤: /dev/sda1 總計(jì)256GB，已用89GB (35%)
系統(tǒng)運(yùn)行時(shí)間: 15天3小時(shí)

看到這個(gè)輸出，恭喜你——Hermes Agent 正式跑通了！

注意它做了什么：它先理解你的指令 → 自己決定用 top、free、df 等命令查系統(tǒng)信息 → 整理成你看著舒服的格式輸出。這就是 Agent 和普通聊天的區(qū)別——它能操作你的電腦來獲取信息。

五、常見問題與避坑指南

這些都是我實(shí)際踩過的坑，一次幫你排完。

坑1：hermes doctor報(bào)錯(cuò)缺依賴

Error: Missing required dependencies: playwright

原因： Hermes 的 browser 工具集依賴 Playwright，這是可選的。解決：

# 方案A：安裝 Playwright（瀏覽器自動(dòng)化工具）
pip install playwright
playwright install chromium

# 方案B：直接禁用 browser 工具集（推薦新手）
hermes tools disable browser

# 重新運(yùn)行 doctor 確認(rèn)
hermes doctor

坑2：WSL 下終端報(bào)錯(cuò)

Error: /dev/pts/0: Operation not permitted

原因： WSL 默認(rèn)沒有完整的 /dev/pts 支持。

解決： 編輯 WSL 配置文件：

# 編輯 /etc/wsl.conf
sudo vi /etc/wsl.conf

# 添加：
[wsl2]
kernelCommandLine = vsyscall=emulate

# 重啟 WSL：在 PowerShell 執(zhí)行
wsl --shutdown

然后重新打開 WSL 終端。

坑3：API Key 報(bào) 401

Error: 401 Unauthorized - Invalid API key

原因 99% 是環(huán)境變量沒生效。 檢查：

# 查看 .env 內(nèi)容
cat ~/.hermes/.env

# 確認(rèn)密鑰正確（以 DeepSeek 為例，密鑰格式是 sk- 開頭）
grep DEEPSEEK ~/.hermes/.env

# 檢查是否拼寫錯(cuò)誤：環(huán)境變量名必須全大寫
# DEEPSEEK_API_KEY 不是 deepseek_api_key 或 DeepSeek_Api_Key

常見錯(cuò)誤：復(fù)制密鑰時(shí)帶了多余的空格或換行符。用 echo 寫入比手動(dòng)編輯更靠譜：

# 正確姿勢(shì)
echo 'DEEPSEEK_API_KEY=sk-xxxxx' > ~/.hermes/.env

# 不要這樣（容易多出空格）
echo "DEEPSEEK_API_KEY = sk-xxxxx" > ~/.hermes/.env

坑4：模型調(diào)用超時(shí)或不斷重試

Error: max retries exceeded with url

通常是網(wǎng)絡(luò)問題。可以：

• 換國(guó)內(nèi)模型（通義千問、DeepSeek）—— 國(guó)內(nèi)訪問速度最快
• 或者掛代理：export https_proxy=http://127.0.0.1:7890
• 或者降低 timeout 配置：hermes config set model.timeout 30
• 或者檢查 API 余額——DeepSeek 新注冊(cè)用戶有贈(zèng)送額度，但用完需要充值

坑5：安裝時(shí)「Permission denied」

mkdir: cannot create directory '/usr/local/lib': Permission denied

解決： 用普通用戶安裝，Hermes 會(huì)裝到 ~/.hermes/ 下，不需要 sudo。如果你用了 sudo 安裝，反而可能導(dǎo)致文件權(quán)限問題。

如果已經(jīng)用 sudo 裝了，建議卸載重裝：

# 卸載
sudo pip uninstall hermes-agent

# 重裝（不用 sudo）
pip install hermes-agent

坑6：hermes命令找不到

bash: hermes: command not found

原因： pip 安裝的二進(jìn)制文件不在 PATH 中。

解決： 找到安裝路徑并加入 PATH：

# 找到 hermes 的位置
python3 -m site --user-base
# 輸出類似 /home/user/.local

# 將 bin 目錄加入 PATH
export PATH=$PATH:/home/user/.local/bin

# 永久生效：寫入 .bashrc
echo 'export PATH=$PATH:/home/user/.local/bin' >> ~/.bashrc
source ~/.bashrc

六、測(cè)試一下：讓 Hermes 幫你寫個(gè)工具

跑通了基礎(chǔ)指令后，來一個(gè)真正的"干活"測(cè)試：

hermes chat -q "幫我寫一個(gè) Shell 腳本，監(jiān)控當(dāng)前服務(wù)器的 CPU、內(nèi)存、磁盤使用率，當(dāng)任一指標(biāo)超過80%時(shí)打印告警。輸出到 ~/monitor.sh"

不出意外的話，你會(huì)看到 Hermes 思考 → 寫出腳本 → 保存文件的全過程：

?? 讓我寫一個(gè)系統(tǒng)監(jiān)控腳本...

分析需求：
1. 檢查 CPU 使用率（top/uptime）
2. 檢查內(nèi)存使用率（free）
3. 檢查磁盤使用率（df）
4. 超 80% 告警

開始寫腳本...
#!/bin/bash
...

已保存到 ~/monitor.sh

如果它寫了但是沒保存成功，你可以說：

把腳本內(nèi)容保存到 ~/monitor.sh

它會(huì)立刻行動(dòng)。這就是 Agent 和聊天機(jī)器人的區(qū)別——它能操作你的電腦。

驗(yàn)證腳本是否真的寫入：

cat ~/monitor.sh
chmod +x ~/monitor.sh
./monitor.sh

七、安裝后的第一件事

裝好 Hermes 后，我建議你做三件事：

1. 運(yùn)行一次 hermes doctor

檢查所有組件是否正常，確認(rèn)依賴齊全。

2. 開啟常用工具集

hermes tools enable terminal file web vision

各工具集的作用：

3. 配置默認(rèn)模型

hermes model
# 選你喜歡的模型，不滿意隨時(shí)能換

做完這三步，你的 Hermes 就可以投入日常使用了。

八、你的第一個(gè) Hermes 工作流

裝完做一次完整的端到端測(cè)試，確保一切運(yùn)轉(zhuǎn)正常：

# 1. 系統(tǒng)信息查詢
hermes chat -q "當(dāng)前目錄下有哪些文件"

# 2. 文件操作
hermes chat -q "創(chuàng)建一個(gè) hello.py 文件，打印 Hello Hermes"

# 3. 代碼執(zhí)行
hermes chat -q "運(yùn)行 hello.py"

# 4. 網(wǎng)絡(luò)請(qǐng)求
hermes chat -q "請(qǐng)求 https://api.github.com 看看返回什么"

# 5. 多步任務(wù)
hermes chat -q "創(chuàng)建一個(gè)目錄 test_project，在里面創(chuàng)建一個(gè) README.md，寫入項(xiàng)目說明"

如果以上 5 步全部成功，你的 Hermes 已經(jīng)可以投入生產(chǎn)使用了。

到此這篇關(guān)于Hermes Agent本地快速部署流程和避坑指南的文章就介紹到這了,更多相關(guān)Hermes Agent本地部署內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論