Skip to main content

配置指南

完整配置示例​

# ~/.hermes/config.yaml

# 基本设置
app:
  name: Hermes Agent
  version: 1.0.0
  debug: false

# 模型配置
model:
  provider: openrouter
  name: claude-3-sonnet
  temperature: 0.7
  max_tokens: 4096

# 工具配置
tools:
  enabled:
    - terminal
    - browser
    - file
    - web
    - todo
  
  terminal:
    timeout: 300
    max_output: 50000
  
  browser:
    headless: true
    timeout: 30

# 平台集成
platforms:
  feishu:
    enabled: true
    app_id: ${FEISHU_APP_ID}
    app_secret: ${FEISHU_APP_SECRET}
  
  dingtalk:
    enabled: true
    app_id: ${DINGTALK_APP_ID}
    app_secret: ${DINGTALK_APP_SECRET}

# 存储配置
storage:
  type: sqlite
  path: ~/.hermes/data.db

# 日志配置
logging:
  level: info
  format: json
  output: ~/.hermes/logs/hermes.log

环境变量​

在 ~/.hermes/.env 中设置：

# API 密钥
OPENROUTER_API_KEY=sk_...

# 平台凭证
FEISHU_APP_ID=cli_...
FEISHU_APP_SECRET=...

DINGTALK_APP_ID=...
DINGTALK_APP_SECRET=...

# 其他配置
DEBUG=false
LOG_LEVEL=info

配置验证​

hermes config validate

重新加载配置​

hermes config reload

常见配置问题​

问题：配置文件找不到​

解决： 确保文件位于 ~/.hermes/config.yaml

问题：环境变量未读取​

解决： 重启 Hermes 或运行 hermes config reload

问题：工具无法使用​

解决： 检查工具是否在 enabled 列表中