โ† All skills
Tencent SkillHub ยท Developer Tools

Hybrid Deep Search

Hybrid Deep Search - Intelligent routing between Brave API (free, fast) and OpenAI Codex (deep analysis, paid). Auto-selects optimal search strategy based on...

skill openclawclawhub Free
0 Downloads
0 Stars
0 Installs
0 Score
High Signal

Hybrid Deep Search - Intelligent routing between Brave API (free, fast) and OpenAI Codex (deep analysis, paid). Auto-selects optimal search strategy based on...

โฌ‡ 0 downloads โ˜… 0 stars Unverified but indexed

Install for OpenClaw

Quick setup
  1. Download the package from Yavira.
  2. Extract the archive and review SKILL.md first.
  3. Import or place the package into your OpenClaw setup.

Requirements

Target platform
OpenClaw
Install method
Manual import
Extraction
Extract archive
Prerequisites
OpenClaw
Primary doc
SKILL.md

Package facts

Download mode
Yavira redirect
Package format
ZIP package
Source platform
Tencent SkillHub
What's included
README.md, SKILL.md, SKILL_CN.md, _meta.json, scripts/deep_search.py, scripts/router.py

Validation

  • Use the Yavira download entry.
  • Review SKILL.md after the package is downloaded.
  • Confirm the extracted package contains the expected setup assets.

Install with your agent

Agent handoff

Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.

  1. Download the package from Yavira.
  2. Extract it into a folder your agent can access.
  3. Paste one of the prompts below and point your agent at the extracted folder.
New install

I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.

Upgrade existing

I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.

Trust & source

Release facts

Source
Tencent SkillHub
Verification
Indexed source record
Version
1.0.1

Documentation

ClawHub primary doc Primary doc: SKILL.md 29 sections Open source page

Hybrid Deep Search ๐Ÿš€

Intelligent three-tier search system that automatically routes queries between Brave API and OpenAI Codex for optimal cost and quality.

Architecture

User Query โ†“ Query Analyzer (router.py) โ†“ โ”œโ”€โ†’ Simple Questions โ†’ Brave API (web_search) Fast, Free โ”œโ”€โ†’ Complex Questions โ†’ OpenAI Codex (gpt-5-codex) Deep Analysis, Paid โ””โ”€โ†’ Manual Mode โ†’ User Specified

1. Install Dependencies

pip install openai python-dotenv requests

2. Configure API Keys

Brave API (Already Built-in) No extra configuration needed. Uses OpenClaw's built-in web_search tool. OpenAI Codex API (Optional for Deep Search) # Get API Key from: https://platform.openai.com/api-keys export OPENAI_API_KEY="sk-your-openai-api-key" export OPENAI_BASE_URL="https://api.openai.com/v1" # Optional

Auto Mode (Recommended)

python3 scripts/deep_search.py "your query" # System automatically analyzes complexity and chooses: # - Simple questions โ†’ Brave API # - Complex questions โ†’ OpenAI Codex

Manual Mode

# Quick Search (Brave API) python3 scripts/deep_search.py "what is OpenClaw?" --mode quick # Deep Search (OpenAI Codex) python3 scripts/deep_search.py "compare LangChain vs LlamaIndex" --mode codex

Focus Modes

# Academic Search python3 scripts/deep_search.py "AI agent frameworks research" --mode codex --focus academic # News Search python3 scripts/deep_search.py "latest AI news" --mode quick --focus news # General Web Search python3 scripts/deep_search.py "OpenClaw documentation" --mode quick --focus web

Parameters

ParameterDescriptionOptionsDefaultquerySearch queryAny text---modeSearch modequick, codex, autoauto--focusSearch focusweb, academic, news, youtubeweb--max-resultsMax results1-2010--verboseVerbose output-false

Complexity Routing Rules

Auto mode routes based on query analysis:

โ†’ Brave API (quick)

Simple factual queries (what/who/when/where) Definition lookups Quick fact-finding Single-topic searches Examples: "what is OpenClaw?" "who created Python?" "latest AI news today"

โ†’ OpenAI Codex (codex)

Comparison analysis Deep reasoning Multi-source synthesis Complex questions Requires inference/summarization Examples: "compare LangChain vs LlamaIndex in detail" "analyze impact of AI on job market" "explain quantum computing applications in healthcare"

Brave API

โœ… Completely free โšก Fast response (<2s) ๐Ÿ“Š Controllable result count

OpenAI Codex (gpt-5-codex)

๐Ÿ’ฐ Usage-based pricing ๐Ÿง  Deep reasoning capabilities โฑ๏ธ Slower response (5-30s) ๐Ÿ’ก Free tier available for new users Recommendation: Use auto mode to let the system optimize costs for you.

Query Analyzer (router.py)

Analyzes query complexity using NLP rules: Keyword detection (compare/analyze/explain...) Sentence length Complexity scoring Automatic routing decisions

Brave API Integration

Uses OpenClaw's built-in web_search tool: Called via Bash tool Handles requests automatically No extra authentication needed

OpenAI Codex Integration

Uses gpt-5-codex model Built-in web search tool OpenAI Chat Completions API format

Case 1: Quick Fact Lookup

python3 scripts/deep_search.py "OpenClaw version 2026" # โ†’ Auto-uses Brave API # โ†’ Result: Fast return, free

Case 2: Deep Analysis

python3 scripts/deep_search.py "comprehensive analysis of AI agent architectures" # โ†’ Auto-uses OpenAI Codex # โ†’ Result: Deep analysis, multi-source synthesis

Case 3: Academic Research

python3 scripts/deep_search.py "recent papers on multi-agent systems" --mode codex --focus academic # โ†’ Uses OpenAI Codex # โ†’ Result: Focused on academic literature

Batch Search

# Create queries.txt echo "query 1" >> queries.txt echo "query 2" >> queries.txt # Batch execute for query in $(cat queries.txt); do python3 scripts/deep_search.py "$query" --mode auto done

Format Output

# JSON output python3 scripts/deep_search.py "query" --format json # Markdown output (default) python3 scripts/deep_search.py "query" --format markdown # Plain text output python3 scripts/deep_search.py "query" --format text

Brave API Not Responding

# Check OpenClaw web_search tool # No extra configuration needed

OpenAI Codex Authentication Failed

# Check environment variable echo $OPENAI_API_KEY # Reset export OPENAI_API_KEY="sk-..."

Python Dependencies

pip install --upgrade openai python-dotenv requests

Scoring Factors (0-10 total)

Keyword Matching (+6) compare/analyze/explain/why/how... Query Length (+2) 15 words = +2 8 words = +1 Question Pattern (+1) Complex wh-questions Technical Terms (+1) API/framework/architecture... Simple Keyword Penalty (-2) what is/who is/list of...

Decision Thresholds

0-2 score: Brave API (quick) 3+ score: OpenAI Codex (codex)

Config File

cp config.json.example config.json # Edit config.json with your settings Example config.json: { "search_settings": { "default_mode": "auto", "default_focus": "web", "max_results": 10, "router_threshold": 3, "verbose": false }, "openai_codex": { "enabled": true, "api_key": "YOUR_OPENAI_API_KEY_HERE", "base_url": "https://api.openai.com/v1", "model": "gpt-5-codex", "max_tokens": 4096, "temperature": 0.7 } }

Credits

Built by Office_bot Powered by OpenClaw

References

Brave Search API OpenAI GPT-5-Codex OpenAI API Docs

Category context

Code helpers, APIs, CLIs, browser automation, testing, and developer operations.

Source: Tencent SkillHub

Largest current source with strong distribution and engagement signals.

Package contents

Included in package
3 Docs2 Scripts1 Config
  • SKILL.md Primary doc
  • README.md Docs
  • SKILL_CN.md Docs
  • scripts/deep_search.py Scripts
  • scripts/router.py Scripts
  • _meta.json Config