Hermes 部署指南

適合終端機 AI Agent 場景，覆蓋環境安裝、模型設定與疑難排解。

**適用場景：**Hermes Agent 是 Nous Research 開源的終端機 AI Agent，適合需要本機指令列、檔案讀寫、網頁/圖片/語音工具、持久記憶和訊息閘道器的使用者。本文按“安裝環境 → 安裝 Hermes → 設定貴數 Token 模型 → 啟動聊天 / 閘道器 → 疑難排解”的順序整理。

設定項目推薦填寫說明
ProviderMore Provider / Custom / OpenAI Compatible不同版本叫法略有差異，選擇可填寫自訂 URL 的入口。
Base URLhttps://api.llm-token.cn/v1優先使用帶 /v1 的根路徑；若無法連線，再試 https://api.llm-token.cn。
API Keysk-xxxxxxxx貼上時終端機不顯示明文是正常現象。
推薦模型claude-sonnet-4-6回應快，支援 Agent、圖片辨識和大上下文；也可按模型清單選擇其他模型。

一、Hermes 是什麼

Hermes Agent 可以在終端機中對話、執行指令、讀寫檔案、搜尋檔案、呼叫網頁和多模態工具，並透過持久記憶儲存長期偏好。你可以把它理解成一個能在本機或伺服器上持續工作的 AI Agent。

**新手建議：**先完成指令列聊天的基本設定，再繼續設定 Telegram、Discord、微信等訊息管道。先確認最小流程可用，後續疑難排解會輕鬆很多。

二、安裝方式選擇

系統推薦方式指令 / 說明
Windows / macOS 一般使用者Hermes Desktop優先下載桌面安裝器，最省事。
Linux / macOS / WSL2 / Termux官方一鍵指令碼
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash
Windows 原生 PowerShell官方 PowerShell 指令碼
iex (irm https://hermes-agent.nousresearch.com/install.ps1)
Windows 穩妥方案WSL2 + Ubuntu如果原生 Windows 安裝不順，就使用 WSL2。

三、Windows 使用 WSL2 的安裝步驟

  1. 以管理員身分開啟 PowerShell。
  2. 執行 WSL 安裝指令。
wsl --install

如果安裝卡在 0%，可以改用下面指令：

wsl --install --web-download -d Ubuntu
  1. 按提示重新啟動電腦。
  2. 首次開啟 Ubuntu 時設定 Linux 使用者名稱和密碼。
  3. 按 Win 鍵搜尋 WSL 或 Ubuntu，能看到入口即可。

圖片展示的是Windows Subsystem for Linux（WSL）系統的圖示，圖示為紅色背景，左上角有藍色企鵝圖案，右側白色文字顯示“WSL系統”。該圖片位於文件中“按Win鍵搜尋WSL或Ubuntu，能看到入口即可”步驟之後，是對WSL系統入口的直觀呈現，用於輔助使用者確認WSL是否安裝成功，與上文提到的驗證WSL是否安裝成功的操作相呼應。圖片展示的是Windows Subsystem for Linux（WSL）系統的圖示，圖示為紅色背景，左上角有藍色企鵝圖案，右側白色文字顯示“…

驗證 WSL 是否安裝成功：

wsl --version

四、安裝 Git 與 Hermes

在 WSL2 / Ubuntu 終端機中執行：

sudo apt update
sudo apt install git -y
git --version

然後安裝 Hermes：

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

安裝完成後重新載入終端機設定，並驗證：

source ~/.bashrc
hermes version
hermes doctor

圖片展示了在WSL2/Ubuntu終端機中執行hermes --version指令的輸出結果。顯示Hermes Agent版本為v0.8.0，執行於2026年4月8日，專案路徑為/home/omen/.hermes/hermes-agent，Python版本為3.11.15，OpenAI SDK版本為2.30.0，並提示已更新。該圖片與文件中“安裝Git與Hermes”部分相關，用於驗證Hermes安裝成功，是安裝完成後驗證步驟的範例輸出。圖片展示了在WSL2/Ubuntu終端機中執行hermes --version指令的輸出結果

**注意：**舊文件裡的 hermes updata 是拼寫錯誤。正確更新指令是 hermes update。

五、設定貴數 Token 模型

  1. 在安裝 Hermes 的終端機裡執行：
hermes setup

圖片展示的是在安裝Hermes終端機執行指令的介面。指令為“hermes setup”，執行後終端機顯示“omen@LAPTOP-VMJ1GE8P:~”提示字元，表明指令已執行完畢。該圖片與文件中“在安裝Hermes的終端機裡執行：$ hermes setup”內容對應，是設定貴數Token模型步驟中，選擇快速設定或模型設定後，選擇“More Provider”/自訂供應商，再選擇OpenAI Compatible或可填寫自訂URL的通訊協定等操作後的終端機回饋畫面。圖片展示的是在安裝Hermes終端機執行指令的介面

  1. 選擇快速設定或模型設定。
  2. 選擇 More Provider / 自訂供應商。
  3. 選擇 OpenAI Compatible 或可填寫自訂 URL 的通訊協定。

這張圖片是設定Hermes時的終端機操作介面，介面為深色背景，頂部顯示目前處於hermes-chat的終端機環境。介面中明確給出設定指引，第一行提示需選擇對應的訊息平台，如Telegram、Discord等，下方有選項內容，其中包含“set up messaging one (recommended)”的相關設定項，該介面對應設定貴數Token模型步驟裡的操作環節，用於引導使用者完成訊息相關的設定選擇，是Hermes部署流程中對應設定步驟的終端機操作展示。這張圖片是設定Hermes時的終端機操作介面，介面為深色背景，頂部顯示目前處於hermes-chat的終端機環境

圖片展示的是在安裝Hermes終端機中選擇供應商的介面。介面上方顯示“Select provider:”，下方列出多個供應商選項，如Nous Portal、OpenRouter等，其中“More providers...”選項被綠色箭頭指向。該圖片與文件中“設定貴數Token模型”部分相關，對應步驟“選擇More Provider/自訂供應商”，用於指導使用者在安裝Hermes時選擇自訂供應商，以設定貴數Token模型。圖片展示的是在安裝Hermes終端機中選擇供應商的介面

圖片展示的是在安裝Hermes終端機中選擇供應商的介面。介面上方提示“Select provider:”，下方列出多種供應商選項，如GitHub Copilot ACP、Google AI Studio等，其中“Custom endpoint (enter URL manually)”以綠色箭頭突出顯示，表明可手動輸入URL。該圖片與文件中設定貴數Token模型的步驟相關，對應選擇自訂供應商這一步驟，使用者可根據需求選擇合適的供應商或選擇自訂供應商手動輸入URL。圖片展示的是在安裝Hermes終端機中選擇供應商的介面

填寫 URL 時優先使用：

https://api.llm-token.cn/v1

如果目前版本驗證失敗，再嘗試：

https://api.llm-token.cn

這張圖片展示了Hermes設定貴數Token模型環節裡，自訂相容OpenAI的介面設定頁面內容，核心是標註了“Custom OpenAI-compatible endpoint configuration”，對應設定項目為API base URL，範例格式為https://api.example.com/v1，目前已填寫的自訂位址為https://api.llm-token.cn/v1，該頁面是設定流程中選擇自訂供應商、OpenAI相容通訊協定後的具體URL輸入部分，用於完成串接對應介面的基礎設定。這張圖片展示了Hermes設定貴數Token模型環節裡，自訂相容OpenAI的介面設定頁面內容，核心是標註了“Custom OpenAI-com…

  1. 貼上 API Key。終端機不顯示明文是正常現象，貼上後直接按 Enter 鍵。
  2. 模型建議先選 claude-sonnet-4-6 測試。
  3. 如果詢問上下文長度，使用 claude-sonnet-4-6 時可按大上下文填寫；如果用戶端限制較嚴格，先填 32000 完成基本測試，再逐步調大。
  4. 第一次可先跳過聊天管道，確認終端機聊天可用後再設定閘道器。

圖片展示的是Hermes設定貴數Token模型後的終端機介面。介面上方顯示API base URL為https://api.example.com/v1，有API key可選，已驗證端點。下方列出可用模型，包括claude-sonnet-4-6、claude-sonnet-4-6-thinking等33個模型。底部提示選擇模型，數字序號對應模型名稱，如1為claude-sonnet-4-6，33為glm-4.6v。該圖片與文件中設定貴數Token模型後進入聊天的上下文相關，展示了模型選擇介面。圖片展示的是Hermes設定貴數Token模型後的終端機介面

圖片展示的是Hermes設定完成後進入聊天時的介面。介面提示“Connect a messaging platform? (Telegram, Discord, etc.)”，並給出兩個選項：一個是“Set up messaging now (recommended)”，另一個是“Skip — set up later with 'hermes setup gateway'”。目前選中的是“Skip”選項，箭頭指向該選項。該圖片與上下文緊密相關，上下文提到設定完成後可直接進入聊天，此圖展示了進入聊天前的平台連線選擇介面，使用者可根據需求選擇是否立即設定或稍後設定。圖片展示的是Hermes設定完成後進入聊天時的介面

六、啟動聊天與閘道器

設定完成後，可以直接進入聊天。如果介面提示是否開始聊天，輸入 Y。

圖片展示的是Hermes部署完成後在終端機的提示介面。介面上方顯示“Ready to go!”，下方列出三條指令及其用途，分別是“hermes”用於開始聊天，“hermes gateway”用於啟動訊息管道，“hermes doctor”用於檢查問題。最下方提示“Launch hermes chat now? [Y/n]：”，詢問是否立即啟動Hermes聊天，以Y/n形式作答。該圖片與文件中Hermes部署指南中“七、常用指令速查”部分相關，直觀呈現了部署完成後可執行的指令及功能。圖片展示的是Hermes部署完成後在終端機的提示介面

如果設定了訊息管道但沒有反應，啟動或檢查 gateway：

hermes gateway
hermes gateway status

七、常用指令速查

指令用途
hermes開始聊天。
hermes setup重新進入完整設定嚮導。
hermes model切換模型或供應商。
hermes doctor診斷依賴、設定和服務狀態。
hermes update更新 Hermes。
hermes --continue恢復上一次對話。

八、常見問題

問題處理方式
hermes: command not found執行 source ~/.bashrc 或重新開啟終端機；仍不行再檢查 PATH。
驗證模型失敗檢查 URL、API Key、模型 ID。優先使用 https://api.llm-token.cn/v1。
回覆中斷、上下文太小回到 hermes setup 或設定檔調整 context length。先完成基本測試，再調大上下文。
WSL2 無法存取 Windows 本機服務Windows 11 可嘗試 WSL mirrored networking；Windows 10 可用 WSL 預設閘道器 IP 替代 localhost。
更新後設定缺失執行 hermes config check 和 hermes config migrate。
[wsl2]
networkingMode=mirrored
wsl --shutdown

Codex 部署指南

講清 CLI 工具安裝、API 串接和開發環境設定。

gpt-image-2 生圖模型設定指南

適合 Cherry Studio、技能包和指令碼串接的圖片生成教學。

本頁章節

一、Hermes 是什麼二、安裝方式選擇三、Windows 使用 WSL2 的安裝步驟四、安裝 Git 與 Hermes五、設定貴數 Token 模型六、啟動聊天與閘道器七、常用指令速查八、常見問題