hermes agent核心配置需严格遵循config.yaml结构：主配置位于~/.hermes/config.yaml，含model、tools、security、gateway等必需一级键；model区块定义默认模型（如openai/gpt-4o）及参数；tools默认全禁用，须显式设true启用；security控制敏感词拦截与输出长度；memory决定记忆持久化策略；gateway配置多平台接入。

☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您正在为 Hermes Agent 配置模型、工具或安全策略，但发现功能未按预期生效，则很可能是 config.yaml 文件结构不规范或关键字段缺失。以下是编写和理解 Hermes Agent 核心配置文件的详细步骤：

一、主配置文件路径与基础结构

config.yaml 是 Hermes Agent 的核心配置文件，位于 ~/.hermes/config.yaml。该文件采用 YAML 格式，必须严格遵循缩进规则（使用空格，不可用 Tab）。文件顶层必须包含 model、tools、security、gateway 等一级键，缺失任一必要区块可能导致 Agent 启动失败或能力降级。

1、确保文件以 UTF-8 编码保存，无 BOM 头。

2、检查文件权限：运行 chmod 600 ~/.hermes/config.yaml 防止敏感配置被非授权读取。

3、验证 YAML 语法：使用在线 YAML linter 或执行 yamllint ~/.hermes/config.yaml 检查格式错误。

二、model 区块配置规范

model 区块定义 Agent 使用的默认模型及其行为参数，是启动时最先被加载的配置段。provider 与 model_name 必须严格匹配官方支持列表，且 temperature、max_tokens 等数值需在模型服务商允许范围内。

1、在 config.yaml 中定位或新建 model 区块，保持四级缩进对齐：

2、填写 default 字段，格式为 /，例如 openai/gpt-4o 或 openrouter/anthropic/claude-3.5-sonnet。

3、设置生成控制参数：

 temperature: 0.7

 max_tokens: 2048

 top_p: 0.9

4、如需多模型路由，可添加 fallback 字段：

 fallback: anthropic/claude-3-haiku

三、tools 区块启用与禁用内置工具

tools 区块决定 Agent 是否具备执行文件操作、Shell 命令、HTTP 请求、浏览器控制等能力。所有工具默认关闭，必须显式设为 true 才可调用，这是 Hermes Agent 的默认安全策略。

1、在 config.yaml 中添加 tools 键，并逐项声明布尔值：

tools:

 file_system: true

 shell_execute: false

 http_request: true

 browser_control: false

2、若启用了 shell_execute，请同步确认系统中已安装 ripgrep 和 jq 工具，并可通过 PATH 访问。

3、禁用某项工具后，Agent 在运行时将完全忽略对应 function calling 请求，不会抛出错误也不会回退。

One API key for 70+ AI models. Route to GPT, Claude, Gemini, Qwen, Deepseek, Grok and more

统一LLM网关 - 一个API对接70+AI模型，使用单一API密钥即可调用GPT、Claude、Gemini、Qwen、Deepseek、Grok等主流模型。

下载

四、security 与 memory 策略配置

security 区块用于设定上下文过滤、敏感词拦截、输出长度限制等防护机制；memory 区块则控制持久化记忆的启用状态与存储粒度，二者共同影响 Agent 的合规性与个性化表现。

1、在 config.yaml 中添加 security 子项：

security:

 enable_context_filtering: true

 max_output_length: 4096

 blocked_keywords: ["root", "rm -rf", "format"]

2、配置 memory 行为：

memory:

 enabled: true

 persist_frequency: "session"

 summary_strategy: "last_3_turns"

3、当 persist_frequency 设为 session 时，记忆仅在当前会话生命周期内有效；设为 always 则写入 state.db 并跨会话复用。

五、gateway 与 multi-channel 接入配置

gateway 区块定义 Hermes Agent 如何连接外部消息平台（如飞书、Telegram、企业微信），包括认证方式、事件订阅类型及消息路由规则。该区块直接影响 Agent 是否能接收用户输入并返回响应。

1、为飞书平台配置 gateway：

gateway:

 type: feishu

 app_id: cli_xxx

 app_secret: xxx

 verification_token: xxx

 encrypt_key: xxx

2、若接入 Telegram，需替换 type 为 telegram，并提供 bot_token 字段。

3、多个 channel 可通过数组形式声明，例如：channels: ["feishu", "terminal"]，表示同时启用飞书机器人和本地终端交互。