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

本指南目標：在 Linux 桌面（Ubuntu／Debian 為例）安裝 Hermes Agent（Nous Research 出品的本機 AI agent），並接上自己的 MYAI168 API，使用 Claude Opus 4.8。

Linux 上 Hermes 用官方一行腳本安裝（會自動裝 uv、Python 等）。設定方式與 macOS 幾乎相同（設定檔同樣在 ~/.hermes/），差別只在 shell 設定檔可能是 ~/.bashrc（bash）或 ~/.zshrc（zsh）。

端點與模型

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

重要安全須知

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

設定檔位置（Linux）

• 設定檔：~/.hermes/config.yaml
• 金鑰：~/.hermes/.env

先看你的登入 shell 是哪一種：

echo $SHELL

• 結尾是 /bash → 用 ~/.bashrc
• 結尾是 /zsh → 用 ~/.zshrc

下面凡是提到「shell 設定檔」，就換成你的那個。

執行官方一行安裝腳本：

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

安裝過程若需要系統套件（ripgrep／ffmpeg／build tools），同意安裝（會用 sudo 透過 apt 安裝，可能問密碼）。

⚠ 同 macOS／Windows：安裝中若自動跳出 Nous Portal 登入（瀏覽器開啟、終端機顯示 portal 連結與 user_code）——那是 Nous 自家訂閱服務，不是 MYAI168。按 Ctrl + C 略過、關掉瀏覽器，不要登入。

讓指令生效（換成你的 shell 設定檔），再確認版本：

source ~/.bashrc       # 或 source ~/.zshrc
hermes --version

若 hermes 找不到：確認 ~/.local/bin 在 PATH 裡。可加：

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

第一步：寫金鑰到 .env（換成真正金鑰）：

echo 'MYAI168_CLAUDE_API_KEY=你的-key' >> ~/.hermes/.env
echo 'MYAI168_API_KEY=你的-key' >> ~/.hermes/.env

第二步：寫 config.yaml。全新安裝（config.yaml 還沒有您的個人設定）用 heredoc 一次寫入最不易出錯（整塊貼上、Enter；heredoc 會自動處理格式，不必煩惱縮排）：

cat > ~/.hermes/config.yaml << 'EOF'
model:
  provider: custom:myai168_claude
  default: claude-opus-4-8
  context_length: 200000

custom_providers:
  - name: myai168_claude
    base_url: https://www.myai168.com/cier/api/anthropic
    key_env: MYAI168_CLAUDE_API_KEY
    api_mode: anthropic_messages
  - name: myai168
    base_url: https://www.myai168.com/cier/api/openai/v1
    key_env: MYAI168_API_KEY
    api_mode: chat_completions

providers: {}
EOF

注意：這會以乾淨內容覆蓋整份 config.yaml——若檔案裡已有您自訂的 model／toolsets／terminal／TTS／compression 等設定，會一併被清掉、回到預設值。已有自訂設定要保留的話，請勿整段覆蓋，改用下一段的編輯方式只改對應區塊。base_url 結尾用 .../anthropic（不含 /v1）。

（保留原本檔案只改 model 區塊的做法：用 hermes config edit 編輯，只改 model:／custom_providers:／providers: 三個區塊、其他區塊保留不動，並務必讓這三個頂層項目頂格，前面不要有空格。）

檢查設定並啟動：

hermes doctor
hermes

（若 doctor 只提醒「Run hermes setup to configure missing API keys for full tool access」，那是指還沒設 key 的工具，與模型無關，可忽略；不要因此重跑 hermes setup，以免覆蓋設定。）

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

• hermes 指令找不到（command not found） → 執行 source ~/.bashrc（或 source ~/.zshrc）或重開終端機；仍找不到就確認 ~/.local/bin 在 PATH（見「一、安裝 Hermes」）。（Windows 為開新的 PowerShell 視窗讓 PATH 生效。）
• 互動模式 chat 報 unrecognized arguments（中文） → 中文輸入法把引號變全形。直接打 hermes 進互動介面，在裡面打字。
• 在 nano 裡貼不上去 → 用指令（echo／cat >）直接寫入（見「二、接上 MYAI168」）。
• 回話報 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. 改 ~/.hermes/.env 的 MYAI168_CLAUDE_API_KEY／MYAI168_API_KEY（與 macOS 相同；Windows 為 %LOCALAPPDATA%\hermes\.env）。
3. 重開 Hermes。

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