EXPERIENCE.md

# Hermes-agent 部署经验总结

## 1. 删除 litellm 依赖

**问题**：PyPI 上 litellm 被隔离（quarantined），导致 Docker 构建失败

**解决**：删除 litellm 依赖，因为代码中实际没有使用它

需要修改的文件：
- `pyproject.toml`
- `requirements.txt`  
- `Dockerfile`

## 2. 风控问题解决

### 2.1 终端命令审批（ Dangerous Command Approval）

**问题**：执行 curl、rm 等命令时需要用户手动审批

**解决**：
1. `config.yaml` 中添加：
   ```yaml
   approvals:
     mode: off
   ```
2. `.env` 中添加：
   ```
   HERMES_YOLO_MODE=true
   ```

### 2.2 网页抓取 lookalike 域名检测

**问题**：Firecrawl API 会检测钓鱼/仿冒域名，阻止抓取

**解决**：将 web backend 改为 tavily

在 `config.yaml` 中添加：
```yaml
web:
  backend: tavily
```

需要确保 `.env` 中有 `TAVILY_API_KEY` 环境变量