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

本指南目標：在 macOS 安裝 Hermes Agent（Nous Research 出品的本機 AI agent），並接上自己的 MYAI168 API，使用 Claude Opus 4.8。

端點與模型

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

重要安全須知

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

設定檔位置（macOS）

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

執行官方一行安裝腳本（會自動裝 uv、Python 3.11，不需 sudo）：

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

安裝完成後讓指令生效：

source ~/.zshrc
hermes --version

安裝完會進入設定精靈：

• How would you like to set up Hermes? → 選 Full setup（用自己的 key），不要選 Nous Portal。
• Select provider: 捲到最底選 custom (direct API)／Custom endpoint，依序輸入：
  • Base URL：https://www.myai168.com/rocna/api/anthropic
  • API Key：你的 MYAI168 金鑰
  • Model：claude-opus-4-8
  • api_mode：anthropic_messages
• 通訊平台 → 全部不選，直接 Enter。
• 工具（Tools）→ 可接受預設，或用 SPACE 關掉高權限工具。
• 各種 Choose a provider（瀏覽器／圖片／TTS／視覺／搜尋）→ 一律 Skip。

若曾裝過 OpenClaw，精靈可能偵測並詢問遷移；可選擇遷移，但遷移後設定常被預設值覆蓋，務必做下方「二-B、手動確認／修正設定」。

精靈可能沒把模型指到正確端點，直接檢查並編輯設定檔最確定。

先確認金鑰（沒有就補上，換成真正金鑰）：

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

編輯設定檔：

hermes config edit

把最上面的 model 區塊改成下面的內容：

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

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

providers: {}

★★ 貼上注意 ★★YAML 對縮排極度敏感。上面每行最前面的空格數「就是實際要的縮排」。model:／custom_providers:／providers: 這三個頂層項目必須「頂格」（前面 0 個空格）；它們底下的子項才縮排。複製時不要在每行前面多加空格，也不要用 Tab（只能用空格）。

說明：provider 對應下方 name 同名那筆；key_env 填「環境變數名稱」不是金鑰本身；Anthropic 端點 base_url 結尾用 .../anthropic（不含 /v1）。

若手動編輯後 hermes 報「Failed to parse config.yaml」之類的 YAML 錯誤（通常是縮排或多貼了空格），最保險的修法是用指令整個重寫——把下面「一整塊」複製、貼到終端機、按 Enter（heredoc 會自動處理好格式，不會有縮排問題）。注意：這會以乾淨內容覆蓋整份 config.yaml——若您原本有自訂的 model／toolsets／terminal／TTS／compression 等其他設定，會一併被清掉、回到預設值。僅建議在檔案已解析失敗、救不回來時使用；有自訂設定要保留的話，請改用手動編輯只修正縮排（只動 model／custom_providers／providers 三個區塊、其他區塊保留不動）。

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/rocna/api/anthropic
    key_env: MYAI168_CLAUDE_API_KEY
    api_mode: anthropic_messages
  - name: myai168
    base_url: https://www.myai168.com/rocna/api/openai/v1
    key_env: MYAI168_API_KEY
    api_mode: chat_completions

providers: {}
EOF

（這正是用 cat > 比手動編輯更不易出錯的原因——整段貼上即可，不需逐行對縮排。）

檢查設定並啟動：

hermes doctor
hermes

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

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

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

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