Hermes Agent配置核心模块说明
Hermes Agent的配置文件全部集中在~/.hermes/目录下，整体分为四大核心模块，不同模块对应不同的功能场景，新手可以先完成基础模块配置，后续再按需扩展进阶模块。
| 模块名称 | 作用 | 适用场景 |
|---|---|---|
| 模型配置 | 设置调用的AI模型地址、密钥、参数 | 所有场景必配 |
| 执行环境配置 | 设置终端路径、依赖环境、权限 | 需要调用本地工具时必配 |
| 记忆能力配置 | 设置对话历史存储方式、长度 | 需要多轮对话上下文时配置 |
| 工具集成配置 | 设置可调用第三方工具、API地址 | 需要扩展Agent能力时配置 |
基础配置：交互式向导快速上手
如果是第一次使用Hermes Agent，推荐使用官方提供的交互式向导完成基础配置，不需要手动编辑配置文件，跟着提示一步步操作即可。
步骤1：初始化配置目录
首先打开终端执行初始化命令，会自动创建~/.hermes/目录并生成默认配置文件：
# 执行初始化命令 hermes init # 输出示例： # 正在创建配置目录 ~/.hermes/ ... # 默认配置文件已生成：~/.hermes/config.yaml # 是否启动交互式配置向导？(y/n)
步骤2：跟随向导配置模型
输入y进入向导后，首先会要求选择模型类型，这里以常用的OpenAI兼容接口为例：
# 向导交互示例 请选择模型类型： 1. OpenAI兼容接口 2. 本地部署模型 3. 自定义模型 输入选项编号：1 请输入模型接口地址（默认https://api.ipipp.com/v1）： 请输入模型密钥：sk-xxxxxx 请输入默认使用的模型名称：gpt-3.5-turbo
步骤3：验证基础配置
配置完成后可以执行测试命令，验证模型是否能正常调用：
# 测试模型调用 hermes test model # 输出示例： # 正在调用模型 gpt-3.5-turbo ... # 模型返回：你好，我是Hermes Agent，请问有什么可以帮你？ # 基础模型配置验证通过
进阶配置：手动修改配置文件
如果需要定制更复杂的功能，比如添加本地工具、配置多轮对话记忆，可以手动修改~/.hermes/config.yaml文件，以下是常见进阶配置示例。
配置执行环境与本地工具
如果需要让Agent调用本地终端命令或者自定义脚本，需要在配置文件中添加执行环境相关配置：
# ~/.hermes/config.yaml 执行环境配置片段
execution:
work_dir: ~/hermes_workspace # Agent工作目录
allowed_commands: # 允许调用的终端命令列表
- ls
- cat
- python
python_path: /usr/bin/python3 # Python解释器路径配置记忆能力
默认情况下Agent只会保留当前对话的上下文，如果需要跨会话保留记忆，可以配置记忆存储模块：
# ~/.hermes/config.yaml 记忆配置片段 memory: type: sqlite # 记忆存储类型，支持sqlite、redis max_history: 20 # 最大保留对话轮数 storage_path: ~/.hermes/memory.db # sqlite存储路径
配置第三方工具集成
如果需要让Agent调用第三方API工具，比如天气查询、搜索引擎，可以在工具配置模块添加对应信息：
# ~/.hermes/config.yaml 工具集成配置片段
tools:
- name: weather_query # 工具名称
type: http # 工具类型
endpoint: https://api.ipipp.com/weather # 工具接口地址
api_key: tool_key_xxxxxx # 工具密钥
description: 查询指定城市的实时天气常见配置避坑点
- 模型接口地址如果填写错误，会导致调用超时，OpenAI兼容接口注意路径要带
/v1后缀 - 本地工具配置时，如果
allowed_commands没有添加对应命令，Agent调用时会提示权限不足 - 修改配置文件后需要执行
hermes reload命令让配置生效，不需要重启终端 - 记忆存储路径如果权限不足，会导致对话历史无法保存，建议设置为当前用户有读写权限的目录
完整配置验证
完成所有配置后，可以启动Agent进行完整功能验证：
# 启动Hermes Agent hermes start # 输入测试问题：北京今天天气怎么样？ # 如果配置了天气工具，Agent会调用对应接口返回结果，说明工具集成配置生效
Hermes Agent的配置文件支持热更新，后续如果需要新增工具或者调整模型参数，直接修改config.yaml后执行hermes reload即可，不需要重新初始化。
Hermes_AgentAI_Agent配置模型配置工具集成终端环境修改时间：2026-05-31 04:10:13