Hermes Agent 的核心配置文件是 ~/.hermes/config.yaml。該文件采用 YAML 格式，結(jié)構(gòu)清晰，允許你全面定制智能體的行為，包括模型選擇、工具啟用、安全策略、消息網(wǎng)關(guān)等。

本指南將深入解析 config.yaml 的每一個(gè)關(guān)鍵部分，并提供可直接使用的配置示例。

一、配置文件位置與管理

• Linux / macOS / WSL2: ~/.hermes/config.yaml
• Windows (原生): %USERPROFILE%\.hermes\config.yaml (通常為 C:\Users\<你的用戶名>\.hermes\config.yaml)

管理命令

Hermes 提供了便捷的 CLI 命令來管理配置：

• hermes config edit: 在默認(rèn)編輯器中打開配置文件。
• hermes config: 查看當(dāng)前生效的配置。
• hermes doctor: 運(yùn)行診斷，檢查配置和依賴是否正常。

重要安全提示：切勿在 config.yaml 中硬編碼你的 API Key。應(yīng)使用環(huán)境變量（如 OPENROUTER_API_KEY）并通過 api_key_env 字段引用。

二、核心配置項(xiàng)詳解

1. 模型配置 (model)

這是最核心的部分，決定了 Hermes 使用哪個(gè)大語言模型。

示例 1：使用 OpenRouter

model:
  provider: custom
  base_url: "https://openrouter.ai/api/v1"
  api_key_env: "OPENROUTER_API_KEY" # 從環(huán)境變量讀取
  model_name: "anthropic/claude-3.5-sonnet"
  max_tokens: 8192
  temperature: 0.7

示例 2：使用 Ollama (本地模型)

model:
  provider: ollama
  model_name: "llama3.1:8b"
  base_url: "http://localhost:11434"
  temperature: 0.7

示例 3：使用 OpenAI

model:
  provider: openai
  api_key_env: "OPENAI_API_KEY"
  model_name: "gpt-4o"
  max_tokens: 4096

關(guān)鍵字段說明:

• provider: 模型提供商，可選 openai, anthropic, google, custom, ollama 等。
• base_url: 對于 custom 提供商（如 OpenRouter），必須指定 API 端點(diǎn)。
• api_key_env: 強(qiáng)烈推薦使用此字段指向一個(gè)環(huán)境變量名，而非直接寫入密鑰。
• model_name: 模型的完整標(biāo)識符。對于 OpenRouter，需使用其目錄中的完整路徑（如 anthropic/claude-3.5-sonnet）。

2. 工具配置 (tools)

Hermes 內(nèi)置了多種工具，你可以按需啟用或禁用。

tools:
  # 代碼解釋器：允許 Agent 執(zhí)行 Python 代碼
  code_interpreter:
    enabled: true
    timeout: 120 # 代碼執(zhí)行超時(shí)時(shí)間（秒）
  # 瀏覽器自動(dòng)化：允許 Agent 控制瀏覽器
  browser:
    enabled: true
    # WSL2 用戶需要指定 Windows 瀏覽器的路徑
    # executable_path: "/mnt/c/Program Files/Google/Chrome/Application/chrome.exe"
  # 文件系統(tǒng)訪問：允許 Agent 讀寫文件
  file_system:
    enabled: true
    allowed_directories:
      - "~" # 允許訪問家目錄
      - "./projects" # 允許訪問當(dāng)前目錄下的 projects 文件夾
  # 終端后端：決定代碼和命令在何處執(zhí)行
  terminal:
    backend: "local" # 可選: local, docker, ssh
    # 如果 backend 是 docker，可以指定鏡像
    # docker:
    #   image: "python:3.11-slim"
    #   timeout: 300

3. MCP 服務(wù)器配置 (mcp_servers)

MCP (Model Context Protocol) 是一種標(biāo)準(zhǔn)協(xié)議，用于將外部服務(wù)（如 GitHub, Notion）集成到 AI 工作流中。

mcp_servers:
  github:
    command: npx
    args: ["-y", "@modelcontextprotocol/server-github"]
    env:
      GITHUB_TOKEN: "${GITHUB_TOKEN}" # 從環(huán)境變量 GITHUB_TOKEN 讀取

要啟用此功能，你需要先安裝對應(yīng)的 MCP 服務(wù)器：

npm install -g @modelcontextprotocol/server-github

4. 消息網(wǎng)關(guān)配置 (gateways)

此部分用于將 Hermes 連接到 Slack、飛書、微信等外部通訊平臺(tái)，使其能監(jiān)聽和回復(fù)群聊消息。

gateways:
  feishu:
    app_id: "cli_a1b2c3d4e5f6g7h8"
    app_secret: "${FEISHU_APP_SECRET}" # 從環(huán)境變量讀取
    verification_token: "your_verification_token"
    # 默認(rèn)情況下，Agent 需要被 @ 才會(huì)響應(yīng)
    require_mention: true
    # 可以設(shè)置默認(rèn)的群組策略
    default_group_policy: "open" # 或 "closed"

5. 記憶與用戶畫像 (memory)

Hermes 的“自我進(jìn)化”能力依賴于其記憶系統(tǒng)。

memory:
  # 啟用 MEMORY.md 文件，Agent 會(huì)在此記錄學(xué)到的知識和技能
  memory_enabled: true
  # 啟用 USER.md 文件，Agent 會(huì)在此構(gòu)建你的個(gè)人畫像
  user_profile_enabled: true
  # 啟用對話歷史搜索
  conversation_search_enabled: true

這些文件會(huì)生成在 ~/.hermes/ 目錄下，你可以隨時(shí)查看和編輯它們。

6. 安全與審批 (approvals,security)

為了防止意外操作，Hermes 提供了安全審批機(jī)制。

# 審批模式
approvals:
  mode: "manual" # 可選: "manual", "auto"
  timeout: 60 # 審批超時(shí)時(shí)間（秒），超時(shí)后自動(dòng)拒絕
# 安全策略
security:
  # 啟用 Tirith 安全策略引擎
  tirith_enabled: true
  # 自定義安全規(guī)則文件路徑
  policy_file: "~/.hermes/tirith-policy.rego"

在 manual 模式下，每當(dāng) Agent 嘗試執(zhí)行高風(fēng)險(xiǎn)操作（如刪除文件、發(fā)送郵件）時(shí)，它會(huì)暫停并等待你的確認(rèn)。

7. 其他全局設(shè)置

# 是否開啟詳細(xì)日志輸出
verbose: false
# 任務(wù)規(guī)劃的遞歸深度限制
max_reflection_depth: 3
# 技能庫的存儲(chǔ)路徑
skills_dir: "~/.hermes/skills"

三、最佳實(shí)踐總結(jié)

1. 安全第一：始終通過 .env 文件或系統(tǒng)環(huán)境變量管理所有密鑰。
2. 漸進(jìn)式配置：初次使用時(shí)，建議只啟用 code_interpreter 和 file_system，熟悉后再逐步開啟 browser 和 mcp_servers。
3. 利用記憶：定期查看 ~/.hermes/MEMORY.md，了解 Agent 學(xué)到了什么，并可以手動(dòng)修正或補(bǔ)充。
4. 善用審批：在生產(chǎn)或重要環(huán)境中，務(wù)必保持 approvals.mode 為 manual，以防止不可逆的操作。
5. 模型選擇：對于需要強(qiáng)推理和代碼能力的任務(wù)，推薦使用 claude-3.5-sonnet 或 gpt-4o；對于本地運(yùn)行，llama3.1:8b 是一個(gè)不錯(cuò)的起點(diǎn)。

通過精心配置 config.yaml，你可以將 Hermes Agent 從一個(gè)通用的聊天機(jī)器人，轉(zhuǎn)變?yōu)橐粋€(gè)高度專業(yè)化、安全可靠且能持續(xù)學(xué)習(xí)的個(gè)人 AI 助手。

到此這篇關(guān)于Hermes Agent 配置大全的文章就介紹到這了,更多相關(guān)Hermes Agent 配置內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論