Tencent SkillHub · Developer Tools

Brave Search Setup

Configure Brave Search API and troubleshoot network/proxy issues for web_search functionality. Use when user needs to (1) Set up Brave Search API key, (2) Fix web_search fetch failures, (3) Configure proxy for OpenClaw tools on macOS with Clash/V2Ray/Surge, or (4) Diagnose "fetch failed" errors with web_search/web_fetch tools.

skill openclawclawhub Free

0 Downloads

0 Stars

0 Installs

0 Score

High Signal

⬇ 0 downloads ★ 0 stars Unverified but indexed

Install for OpenClaw

Quick setup

Download the package from Yavira.
Extract the archive and review SKILL.md first.
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: SKILL.md, scripts/detect-proxy.sh

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.

Download the package from Yavira.
Extract it into a folder your agent can access.
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. 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. Summarize what changed and any follow-up checks I should run.

Open Send to Agent page Open JSON manifest Open Markdown brief

Trust & source

Release facts

Source: Tencent SkillHub
Verification: Indexed source record
Version: 1.0.0

Provenance

Publisher: qingliu1617-art
Source page: View original listing
Canonical URL: Open canonical page

Documentation

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

Brave Search Setup & Proxy Configuration

Setup Brave Search API and resolve network connectivity issues for OpenClaw web tools.

Prerequisites

Brave Search API key (get from https://brave.com/search/api/) OpenClaw CLI installed macOS with proxy client (Clash/V2Ray/Surge) if behind GFW

Step 1: Configure API Key

# Option A: Via config.patch (key will be stored securely) openclaw gateway config.patch --raw '{"tools":{"web":{"search":{"apiKey":"YOUR_BRAVE_API_KEY","enabled":true,"provider":"brave"}}}}' Or edit ~/.openclaw/openclaw.json directly: { "tools": { "web": { "search": { "enabled": true, "provider": "brave", "apiKey": "YOUR_BRAVE_API_KEY" } } } }

Step 2: Test Without Proxy

openclaw web.search --query "test" --count 1 If works → Done. If "fetch failed" → Continue to proxy setup.

Step 3: Detect Proxy Port

Common proxy ports by client: Clash: 7890 (HTTP), 7891 (SOCKS5), 7897 (mixed-port) Surge: 6152, 6153 V2Ray: 1080, 10808 Detect actual port: # Check if Clash is running ps aux | grep -i clash # Find mixed-port from Clash config cat "~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/clash-verge.yaml" | grep mixed-port # Or test common ports for port in 7890 7891 7897 6152 6153 1080 10808; do if nc -z 127.0.0.1 $port 2>/dev/null; then echo "Port $port is open" fi done

Step 4: Set System Proxy

Method A: launchctl (Recommended - survives restart) # Set for current session and future sessions launchctl setenv HTTPS_PROXY http://127.0.0.1:7897 launchctl setenv HTTP_PROXY http://127.0.0.1:7897 Method B: Shell export (Session only) export HTTPS_PROXY=http://127.0.0.1:7897 export HTTP_PROXY=http://127.0.0.1:7897 Method C: Add to shell profile (Permanent) echo 'export HTTPS_PROXY=http://127.0.0.1:7897' >> ~/.zshrc echo 'export HTTP_PROXY=http://127.0.0.1:7897' >> ~/.zshrc source ~/.zshrc

Step 5: Enable Gateway Restart

openclaw gateway config.patch --raw '{"commands":{"restart":true}}'

Step 6: Restart Gateway with Proxy

# Restart to pick up proxy env vars openclaw gateway restart # Or use SIGUSR1 kill -USR1 $(pgrep -f "openclaw gateway")

Step 7: Verify

# Test web search openclaw web.search --query "Brave Search test" --count 1 # Test web fetch openclaw web.fetch --url "https://api.search.brave.com" --max-chars 100

"fetch failed" but proxy works in browser

Symptom: Browser can access Google, but OpenClaw tools fail. Cause: Gateway process started before proxy env vars were set. Solution: Restart Gateway after setting HTTPS_PROXY.

Permission denied on Gateway restart

Enable restart command: openclaw gateway config.patch --raw '{"commands":{"restart":true}}'

API key errors

Verify key is set: openclaw gateway config.get | grep -A5 'web.*search' Test directly with curl: curl -s "https://api.search.brave.com/res/v1/web/search?q=test&count=1" \ -H "Accept: application/json" \ -H "X-Subscription-Token: YOUR_API_KEY"

Mixed-port vs dedicated ports

Clash "mixed-port" (default 7897) handles both HTTP and SOCKS5. If using dedicated ports: HTTP proxy: 7890 SOCKS5 proxy: 7891 (requires different handling)

Advanced: Per-Tool Proxy

Not all tools respect HTTPS_PROXY. For tools that don't: # Use proxychains-ng brew install proxychains-ng # Configure sudo tee /usr/local/etc/proxychains.conf <<EOF strict_chain proxy_dns [ProxyList] http 127.0.0.1 7897 EOF # Run with proxy proxychains4 openclaw web.search --query "test"

Workflow Summary

Configure API key → config.patch or edit JSON Test → If fails, proxy needed Detect port → Check Clash/Surge config Set env vars → launchctl setenv or shell export Restart Gateway → openclaw gateway restart Verify → Run test search

References

Brave Search API Docs: https://api.search.brave.com/app/docs OpenClaw Config: https://docs.openclaw.ai/config Clash Verge: https://github.com/clash-verge-rev/clash-verge-rev

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

1 Docs1 Scripts

SKILL.md Primary doc
scripts/detect-proxy.sh Scripts