# Send Brave Search Setup to your agent Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually. ## Fast path - 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. ## Suggested prompts ### New install ```text 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 ```text 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. ``` ## Machine-readable fields ```json { "schemaVersion": "1.0", "item": { "slug": "brave-search-setup", "name": "Brave Search Setup", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/qingliu1617-art/brave-search-setup", "canonicalUrl": "https://clawhub.ai/qingliu1617-art/brave-search-setup", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/brave-search-setup", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=brave-search-setup", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md", "scripts/detect-proxy.sh" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "brave-search-setup", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-01T01:18:05.693Z", "expiresAt": "2026-05-08T01:18:05.693Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=brave-search-setup", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=brave-search-setup", "contentDisposition": "attachment; filename=\"brave-search-setup-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "brave-search-setup" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "primaryActionLabel": "Download for OpenClaw", "primaryActionHref": "/downloads/brave-search-setup" }, "validation": { "installChecklist": [ "Use the Yavira download entry.", "Review SKILL.md after the package is downloaded.", "Confirm the extracted package contains the expected setup assets." ], "postInstallChecks": [ "Confirm the extracted package includes the expected docs or setup files.", "Validate the skill or prompts are available in your target agent workspace.", "Capture any manual follow-up steps the agent could not complete." ] } }, "links": { "detailUrl": "https://openagent3.xyz/skills/brave-search-setup", "downloadUrl": "https://openagent3.xyz/downloads/brave-search-setup", "agentUrl": "https://openagent3.xyz/skills/brave-search-setup/agent", "manifestUrl": "https://openagent3.xyz/skills/brave-search-setup/agent.json", "briefUrl": "https://openagent3.xyz/skills/brave-search-setup/agent.md" } } ``` ## Documentation ### 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 <