跳到主要内容

配置指南

完整配置示例

# ~/.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 列表中