首頁›開發者中心›Hermes Agent Windows

Hermes Agent Windows

API 說明文件OpenAI ChatGPT APIAnthropic (Claude) APIGoogle Gemini APIGoogle Search APIGoogle News APIOpenRouter APIAPI 收費
CLI 與 Agent 教學cc-switch macOScc-switch Windowscc-switch LinuxOpenCode macOSOpenCode WindowsOpenCode LinuxOpenClaw macOSOpenClaw WindowsOpenClaw LinuxHermes Agent macOSHermes Agent WindowsHermes Agent LinuxClaude Code CLI macOSClaude Code CLI WindowsClaude Code CLI LinuxCodex CLI macOSCodex CLI WindowsCodex CLI Linux
MYAI168 API 與 MCPMYAI168 MCP CLIMYAI168 MCP 網頁及應用程式
本頁沒有符合的問題。改用全站搜尋
安裝總覽(Windows 版)

Hermes Agent 安裝與 MYAI168 設定指南 — Windows 版

本指南目標:在 Windows 安裝 Hermes Agent(Nous Research 出品的本機 AI agent),並接上自己的 MYAI168 API,使用 Claude Opus 4.8。

Windows 原生安裝器(不用 WSL)會自動裝好 uv、Python、Node、ripgrep、ffmpeg、可攜式 Git,不需事先安裝。全程用 PowerShell 操作,設定檔用記事本編輯。

端點與模型

Anthropic 原生端點   https://www.myai168.com/cgu/api/anthropic   (不含 /v1)
OpenAI 相容端點      https://www.myai168.com/cgu/api/openai/v1
主模型               claude-opus-4-8(走 Anthropic 端點)

重要安全須知

  • Hermes 是有實際系統權限的 agent,可讀寫檔案、執行指令、控制瀏覽器。不建議裝在存有大量敏感資料的主力機;初期 token 消耗可能偏高,記得到 MYAI168 後台設用量上限。
  • API Key 視同密碼,不要外流;外流就到 MYAI168 後台撤銷換新。

⚠ 重要提醒:安裝過程會自動跳出「Nous Portal 登入」

安裝中(可能在中途任何一步)會自動開啟瀏覽器,並在 PowerShell 顯示類似:

To continue: 1. Open: https://portal.nousresearch.com/...
Waiting for approval (polling every 1s)...

那是 Nous 自家訂閱服務,不是我們要用的 MYAI168。看到就:在 PowerShell 按 Ctrl + C 中斷、把瀏覽器頁面關掉,「不要登入、不要輸入畫面上的 code」。略過不影響後續設定(詳見「二、略過 Nous Portal 登入」)。

設定檔位置(Windows)

  • 設定檔:%LOCALAPPDATA%\hermes\config.yaml
  • 金鑰:%LOCALAPPDATA%\hermes\.env
  • (通常是 C:\Users\你的帳號\AppData\Local\hermes\)
一、安裝 Hermes(PowerShell)

開 PowerShell(不需系統管理員),執行:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

安裝中會問是否安裝系統套件:

  • Install ripgrep / ffmpeg? → Y(搜尋加速+語音,建議裝)。
  • Install build tools? → Y(編譯 Python 套件需要,務必裝)。

安裝程式會自動處理相依套件的下載與安裝(官方文件明載不需手動安裝 ripgrep/ffmpeg),全程不需系統管理員權限、也不會要求輸入密碼。

接著(若登入步驟沒被中斷的話)會進設定精靈;但通常你會在登入那步按 Ctrl + C 略過,精靈也會「跟著一起中斷」——這完全沒關係,因為本指南的 MYAI168 設定「不靠設定精靈」,而是用「三、接上 MYAI168」手動編 config.yaml。所以精靈有沒有跑完都無所謂,不需要重裝。

(若精靈有跑完,選項為:Terminal backend → Keep current (local);通訊平台 → 全不選;工具/各種 provider → 一律 Skip。)

只要下面這個指令能顯示版本號,就代表 Hermes 本體已裝好,可直接進「三、接上 MYAI168」設定——開「新的」PowerShell 視窗,確認:

hermes --version
二、略過 Nous Portal 登入(補充)

如「安裝總覽」的提醒所述:安裝過程自動跳出「Not logged into Nous Portal / Starting login」並開瀏覽器要登入時——那是 Nous 自家訂閱服務,不是 MYAI168。

  • 在 PowerShell 按 Ctrl + C 中斷。
  • 瀏覽器頁面直接關掉,不要登入、不要輸入畫面上的 user_code。
  • 略過不影響後續設定。
三、接上 MYAI168(用記事本手動設定)

第一步:寫金鑰到 .env(換成真正金鑰,兩行各貼一次、Enter):

echo 'MYAI168_CLAUDE_API_KEY=你的-key' >> $env:LOCALAPPDATA\hermes\.env
echo 'MYAI168_API_KEY=你的-key' >> $env:LOCALAPPDATA\hermes\.env

第二步:用記事本開 config.yaml:

notepad $env:LOCALAPPDATA\hermes\config.yaml

檔案最上面通常是這 5 行預設值:

model:
  default: anthropic/claude-opus-4.6
  provider: auto
  base_url: https://openrouter.ai/api/v1
providers: {}

把這 5 行「選取刪除」,改成下面的內容(下方原有的 fallback_providers、toolsets、agent 等區塊全部保留不動):

model:
  provider: custom:myai168_claude
  default: claude-opus-4-8
  context_length: 200000

custom_providers:
  - name: myai168_claude
    base_url: https://www.myai168.com/cgu/api/anthropic
    key_env: MYAI168_CLAUDE_API_KEY
    api_mode: anthropic_messages

providers: {}

★★ 貼上注意 ★★YAML 對縮排極度敏感。model:/custom_providers:/providers: 這三個頂層項目必須「頂格」(前面 0 個空格);它們底下的子項才縮排。在記事本貼上後,檢查這三個項目有沒有頂到最左邊、前面沒有空格;縮排只能用空格,不要用 Tab。

存檔 Ctrl + S(若問編碼選 UTF-8),關閉。

設定重點

  • YAML 縮排用「空格」,不要用 Tab。
  • model:/custom_providers:/providers: 三個頂層項目要頂格,前面不能有空格(最常見的錯就是整段被多縮排,導致 parse 失敗)。
  • Anthropic 端點 base_url 結尾用 .../anthropic(不含 /v1)。
  • key_env 填「環境變數名稱」,不是金鑰本身。

若存檔後 hermes 報「Failed to parse config.yaml」之類錯誤,多半是縮排跑掉或頂層項目前面多了空格——重開 notepad 檢查那三個頂層項目有沒有頂格,修正後再存。

注意:cc-switch 對 Hermes 的寫入可能失效(設定不會真的寫進 config.yaml),因此 Hermes 建議用本節「記事本手動設定」,不要依賴 cc-switch。

四、驗證與啟動(Windows)

開新的 PowerShell,直接打:

hermes

進畫面後直接打字送出。底部狀態列顯示 claude-opus-4-8 即成功。(若出現 "Auxiliary title generation failed: HTTP 404",那是輔助模型小功能失敗,不影響主對話,可忽略。)

確認設定有寫入(可選):

Get-Content $env:LOCALAPPDATA\hermes\config.yaml -TotalCount 12
五、常見問題速查
  • hermes 指令找不到(command not found) → 開新的 PowerShell 視窗讓 PATH 生效。(macOS 為 source ~/.zshrc 或重開終端機。)
  • 互動模式 chat 報 unrecognized arguments(中文) → 中文輸入法把引號變全形。直接打 hermes 進互動介面,在裡面打字。
  • 在 nano/記事本裡貼不上去 → Windows 終端機貼上用滑鼠右鍵或 Ctrl+Shift+V(不是 Ctrl+V);或用指令(echo/cat >)直接寫入。
  • 回話報 404/not found → 把 myai168_claude 的 base_url 從 .../anthropic 改成 .../anthropic/v1 再試。
  • 回話報 401/unauthorized → .env 裡的 MYAI168_CLAUDE_API_KEY 沒填或填錯。
  • No inference provider configured(已設卻仍出現) → config.yaml 的 model 區塊還是預設值,沒改成 custom:myai168_claude。
  • Auxiliary title generation failed: HTTP 404 → 輔助模型小功能失敗,不影響主對話,可忽略。
  • 切換模型 → 對話中用 /model;新增供應商則離開後跑 hermes model。
六、維護

更新到最新版:

hermes update

更換 API Key(外流或定期輪替)

  1. 到 MYAI168 後台撤銷舊 key、產新 key。
  2. 改 %LOCALAPPDATA%\hermes\.env 的 MYAI168_CLAUDE_API_KEY/MYAI168_API_KEY。(macOS 為 ~/.hermes/.env。)
  3. 重開 Hermes。

官方文件:https://hermes-agent.nousresearch.com/docs

‹ 上一頁:Hermes Agent macOS下一頁:Hermes Agent Linux ›
↑
已複製此問題的連結

其他常見問題頁面

API 說明文件

  • OpenAI ChatGPT API
  • Anthropic (Claude) API
  • Google Gemini API
  • Google Search API
  • Google News API
  • OpenRouter API
  • API 收費

CLI 與 Agent 教學

  • cc-switch macOS
  • cc-switch Windows
  • cc-switch Linux
  • OpenCode macOS
  • OpenCode Windows
  • OpenCode Linux
  • OpenClaw macOS
  • OpenClaw Windows
  • OpenClaw Linux
  • Hermes Agent macOS
  • Hermes Agent Linux
  • Claude Code CLI macOS
  • Claude Code CLI Windows
  • Claude Code CLI Linux
  • Codex CLI macOS
  • Codex CLI Windows
  • Codex CLI Linux

MYAI168 API 與 MCP

  • MYAI168 MCP CLI
  • MYAI168 MCP 網頁及應用程式