了解如何配置 Hermes Agent,包括配置文件、LLM 提供商设置、工具配置和所有可用的配置选项。
配置文件位置
Hermes Agent 使用以下配置文件:
基本配置
设置 API 密钥
通过 CLI 设置 API 密钥:
hermes config set OPENROUTER _API_KEY sk-or-v1-your-key-here
或直接编辑 文件:~/.hermes/.env
# LLM 提供商 OPENROUTER_API_KEY=sk-or-v1-your-key-here # 可选工具 FIRECRAWL_API_KEY=fc-your-key FAL_KEY=your-fal-key
选择模型
hermes model # 交互式选择
或在配置文件中指定:
# ~/.hermes/config.yaml provider: name: openrouter model: anthropic/claude-sonnet-4-20250514
终端配置
终端后端
终端工具可以在不同的环境中执行命令:
配置示例
# ~/.hermes/config.yaml terminal: backend: local # 或: docker, ssh, singularity, modal, daytona cwd: "." # 工作目录 timeout: 180 # 命令超时时间(秒)
Docker 后端
terminal: backend: docker docker_image: python:3.11-slim
SSH 后端
terminal: backend: ssh
# 在 ~/.hermes/.env 中设置凭据 TERMINAL_SSH_HOST= my-server.example.com TERMINAL_SSH_USER=myuser TERMINAL_SSH_KEY=~/.ssh/id_rsa
容器资源
terminal: backend: docker container_cpu: 1 # CPU 核心数(默认:1) container_memory: 5120 # 内存 MB(默认:5GB) container_disk: 51200 # 磁盘 MB(默认:50GB) container_persistent: true # 跨会话持久化文件系统
容器安全
所有容器后端都使用安全加固运行:
工具配置
配置工具集
# 使用特定工具集 hermes chat --toolsets "web,terminal" # 配置每个平台的工具(交互式) hermes tools
常用工具集包括:、、、、、、、、、、、、、、 和 。webterminalfilebrowservisionimage_genskillsttstodomemorysession_searchcronjobcodeexecutiondelegationhomeassistantrl
可用工具分类
显示设置
# ~/.hermes/config.yaml display: busy_input_mode: "interrupt" # 或 "queue" tool_preview_length: 0 # 0 = 无限制 bell_on_complete: false
快速命令
定义自定义命令,无需调用 LLM 即可立即执行 shell 命令:
# ~/.hermes/config.yaml quick_commands: status: type: exec command: systemctl status hermes-agent gpu: type: exec command: nvidia-smi --query-gpu=utilization.gpu,memory.used --format=csv,noheader cdh: type: cd path: ~/projects/hermes-agent
然后在任何聊天中输入 或 。/status/gpu
人格设置
# ~/.hermes/config.yaml personalities: helpful: "You are a helpful, friendly AI assistant." kawaii: "You are a kawaii assistant! Use cute expressions..." pirate: "Arrr! Ye be talkin' to Captain Hermes..." # 添加您自己的!
使用 等命令激活。/personality pirate
上下文压缩
# ~/.hermes/config.yaml compression: enabled: true threshold: 0.50 # 在上下文限制的 50% 时压缩 summary_model: "google/gemini-3-flash-preview"
CLI 命令
提示:运行 可以诊断配置问题并提供修复建议。hermes doctor