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.
Why use this skill?
Learn how to set up your Brave Search API key and resolve web_search fetch failures in OpenClaw. A complete guide to proxy configuration for macOS.
Install via CLI (Recommended)
clawhub install openclaw/skills/skills/qingliu1617-art/brave-search-setupWhat This Skill Does
The brave-search-setup skill is an essential configuration and troubleshooting tool for OpenClaw users who rely on the web_search and web_fetch capabilities. It manages the integration of the Brave Search API, ensuring your agent can retrieve real-time data from the internet. Beyond initial setup, this skill provides a structured framework for diagnosing and resolving common network connectivity errors, such as "fetch failed" statuses, which are frequently caused by local network restrictions or proxy configurations in restricted environments. It streamlines the process of port detection, environment variable configuration, and gateway service management on macOS systems.
Installation
To integrate this tool into your OpenClaw environment, use the built-in CLI installation command:
clawhub install openclaw/skills/skills/qingliu1617-art/brave-search-setup
Ensure that you have your Brave Search API key ready from the official Brave developer portal before proceeding with the configuration commands provided in the quick setup section of the tool's documentation.
Use Cases
This skill is specifically designed to address four primary scenarios:
- Initial API setup: Configuring the
openclaw.jsonconfiguration file to enable the Brave Search provider. - Proxy troubleshooting: Helping users who operate behind complex network topologies (such as the GFW) to correctly route agent traffic through local clients like Clash, V2Ray, or Surge.
- Environment synchronization: Ensuring that shell-level proxy environment variables like
HTTPS_PROXYare correctly propagated to the OpenClaw gateway daemon, preventing common connectivity failures. - Service Lifecycle Management: Providing commands to cleanly restart the gateway to refresh network settings without requiring a full system reboot.
Example Prompts
- "I'm getting a 'fetch failed' error whenever I try to use the web_search tool, can you help me troubleshoot my proxy settings?"
- "I just got my Brave Search API key. How do I configure it correctly in my OpenClaw config?"
- "My internet works fine in my browser, but OpenClaw can't connect to the web. Help me verify my proxy port and restart the gateway."
Tips & Limitations
Always remember that setting HTTPS_PROXY at the session level is often insufficient for background processes; ensure you follow the launchctl instructions or update your ~/.zshrc file to guarantee persistence. If you are using a mixed-port proxy configuration, verify the port number in your client's YAML configuration file as default ports can change. Note that this skill primarily supports macOS workflows; users on Linux or Windows may need to adapt the proxy environment variable injection methods accordingly. Regularly test connectivity using the provided verify commands to ensure your agent remains capable of fetching live data.
Metadata
Not sure this is the right skill?
Describe what you want to build — we'll match you to the best skill from 16,000+ options.
Find the right skillPaste this into your clawhub.json to enable this plugin.
{
"plugins": {
"official-qingliu1617-art-brave-search-setup": {
"enabled": true,
"auto_update": true
}
}
}Tags(AI)
Flags: network-access, file-write, file-read, external-api, code-execution