Flaq AI 智能體指南

使用 Flaq AI API 服務設定 Hermes Agent 的實用指南

使用 Flaq AI 的 Hermes Agent 相容端點，你可以快速將 Hermes Agent 設定為連接 Flaq，並從終端機存取我們的模型服務。設定 API 金鑰後，依照本指南中的範例選擇目前支援的模型並驗證設定。

智能體指南

Claude Code/cc-apiOpenAI Codex/codex-api/v1Hermes Agent/api/v1

安裝

安裝 Hermes Agent

為你的系統安裝 Hermes Agent，必要時重新載入 shell，然後在加入 Flaq AI 設定前驗證 hermes 指令。如果安裝程式開啟設定精靈，你可以略過 Nous Portal 登入，之後手動設定 Flaq。

1

安裝 Hermes Agent

選擇符合你系統的安裝程式，然後執行下方的安裝指令。

安裝程式可能會開啟 Hermes 設定精靈。若要設定 Flaq，你可以略過 Nous Portal 登入，並繼續使用下方的手動設定。

官方安裝腳本

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

重新載入 shell profile

如果安裝後 hermes 指令仍無法使用，請執行此步驟。如果你的 shell 使用 bash，請使用 source ~/.bashrc。

重新載入 shell profile

source ~/.zshrc
3

驗證 Hermes Agent

加入 Flaq AI 憑證之前，確認 hermes 指令可以使用。

驗證安裝

hermes --version

配置

將 Hermes Agent 連接到 Flaq AI

選擇 Flaq 的 OpenAI 相容端點目前支援的模型，將你的 Flaq API 金鑰儲存在 ~/.hermes/.env，並讓 config.yaml 指向 Flaq API base URL。

推薦作為可靠預設 Hermes Agent 程式開發流程的文字模型。

使用 Hermes CLI 指令寫入 Flaq API 金鑰和模型設定，減少手動編輯檔案。這會更新你的本機 Hermes 設定，因此如果你已在使用 Hermes，請先備份現有 config。

透過 Hermes config 指令寫入 Flaq 金鑰、所選模型、自訂 provider、base URL 與 context length。

Hermes CLI 快速設定

hermes config set FLAQ_API_KEY Your_Api_Keyhermes config set model.default gpt-5.4-text-to-texthermes config set model.provider customhermes config set model.base_url https://api.flaq.ai/api/v1hermes config set model.api_key '${FLAQ_API_KEY}'hermes config set model.context_length 128000hermes config check

驗證

在 Hermes Agent 中驗證 Flaq

執行快速 Hermes one-shot 指令。若收到正常回答，代表 Hermes 可以透過 Flaq LLM 端點呼叫模型。

啟動互動模式

hermes

快速測試指令

hermes -m gpt-5.4-text-to-text -z "What is 2+2?"

設定診斷

hermes config check

將所選模型設為預設值

hermes config set model.default gpt-5.4-text-to-text

疑難排解

Hermes Agent FAQ

在本指南情境中使用時，可能會顯著增加 token 用量。