Hybrid Deep Search

混合深度搜索（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

参数说明

复杂度路由规则

自动模式基于查询语义分析进行路由：

→ 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

• ✅ 完全免费
• ⚡ 响应迅速（

命令行