正文内容
混合深度搜索（Hybrid Deep Search）
一种智能的三层搜索系统，可自动在 Brave API 与 OpenAI Codex 之间路由用户查询，在成本控制与结果质量之间实现最优平衡。
架构
User Query ↓ Query Analyzer（router.py） ↓ ├─→ 简单问题 → Brave API（web_search） 快速、免费 ├─→ 复杂问题 → OpenAI Codex（gpt-5-codex） 深度分析、按量计费 └─→ 手动模式 → 用户显式指定
快速上手
1. 安装依赖
pip install openai python-dotenv requests
2. 配置 API 密钥
Brave API（已内置）
无需额外配置。直接复用 OpenClaw 内置的 web_search 工具。
OpenAI Codex API（深度搜索可选）
# 在 https://platform.openai.com/api-keys 获取 API Key export OPENAI_API_KEY="sk-your-openai-api-key" export OPENAI_BASE_URL="https://api.openai.com/v1" # 可选
使用方式
自动模式（推荐）
python3 scripts/deep_search.py "your query" # 系统自动分析查询复杂度，并智能选择： # - 简单问题 → Brave API # - 复杂问题 → OpenAI Codex
手动模式
# 快速搜索（Brave API） python3 scripts/deep_search.py "what is OpenClaw?" --mode quick # 深度搜索（OpenAI Codex） python3 scripts/deep_search.py "compare LangChain vs LlamaIndex" --mode codex
聚焦模式（Focus Modes）
# 学术搜索 python3 scripts/deep_search.py "AI agent frameworks research" --mode codex --focus academic # 新闻搜索 python3 scripts/deep_search.py "latest AI news" --mode quick --focus news # 通用网页搜索 python3 scripts/deep_search.py "OpenClaw documentation" --mode quick --focus web
参数说明
| 参数 | 说明 | 可选值 | 默认值 |
|---|---|---|---|
| query | 搜索查询语句 | 任意文本 | - |
| --mode | 搜索模式 |
quick、codex、auto
|
auto |
| --focus | 搜索焦点类型 |
web、academic、news、youtube
|
web |
| --max-results | 最大返回结果数 | 1–20 | 10 |
| --verbose | 启用详细输出 | 无参数 | false |
复杂度路由规则
自动模式基于查询语义分析进行路由：
→ Brave API（quick 模式）
- 简单事实类问题（what/who/when/where 类型）
- 术语定义查询
- 快速事实检索
- 单主题、低歧义搜索
示例：
- "what is OpenClaw?"
- "who created Python?"
- "latest AI news today"
→ OpenAI Codex（codex 模式）
- 对比分析类问题
- 需多步推理或逻辑推演
- 跨来源信息整合与综合
- 开放式、高抽象层级问题
- 需模型执行归纳、总结或解释
示例：
- "compare LangChain vs LlamaIndex in detail"
- "analyze impact of AI on job market"
- "explain quantum computing applications in healthcare"
成本优化策略
Brave API
- ✅ 完全免费
- ⚡ 响应迅速（