Hermes Agent · 中文入口
非官方中文下載、安裝與新手學習入口
整理官方下載、安裝教學、Skill / MCP 推薦、高手使用摘要與 GitHub Issue 精選問答,幫中文使用者從安裝到進階工作流一次上手。
Unofficial community guide Not affiliated with Nous Research
常見問題排解
1
遇到 "Command not found" 或無法執行 npx?
如果你是 Windows 用戶，請確認你已經安裝了 Node.js (建議版本 20 以上)。若是 macOS/Linux 用戶，這通常代表你的 npm bin 資料夾沒有在環境變數 `$PATH` 中。請參考[官方 FAQ 取得詳細解法](https://hermes-agent.nousresearch.com/docs/reference/faq)。
2
API 金鑰無效或被拒絕 (401 Unauthorized)
確保你的環境變數 `OPENAI_API_KEY` 或 `ANTHROPIC_API_KEY` 已正確設定。如果是本機模型 (Ollama 等)，請檢查 API base URL 是否指向 `http://localhost:11434/v1`。你可以在啟動時使用 `--api-base` 參數覆寫。
3
MCP Server 連線失敗或 Timeout
MCP Server 需要在背景正常運作。請先單獨啟動 MCP Server 並確認沒有報錯。若錯誤持續發生，請到[官方 Issues 區](https://github.com/NousResearch/hermes-agent/issues)搜尋相關的錯誤訊息或回報。