brave-images

What This Skill Does

The brave-images skill provides the OpenClaw agent with the ability to perform high-quality visual discovery directly from the web using the Brave Search API. By integrating this skill, the agent gains a dedicated interface for image retrieval, allowing it to move beyond text-based responses to deliver visual context. The skill handles complex search parameters like regional biasing and safety filtering, ensuring that results are both relevant and appropriate. It processes raw JSON responses from the Brave API, extracting essential metadata like image dimensions, source origins, and direct URLs for both thumbnails and full-resolution assets.

Installation

To integrate this skill into your OpenClaw environment, execute the following command in your terminal: clawhub install openclaw/skills/skills/zats/brave-images After installation, ensure you have an active Brave Search API subscription. You must set the BRAVE_API_KEY environment variable in your OpenClaw configuration to authorize your requests. Without this key, the skill will fail to authenticate with the search endpoint.

Use Cases

• Research Assistance: Quickly pull reference images for design projects, technical documentation, or historical research.
• Content Creation: Find royalty-free or public visual assets (within the constraints of search filters) to accompany drafted blog posts or reports.
• Visual Verification: Assist users in identifying objects, landmarks, or items by providing visual examples alongside descriptive text.
• Market Analysis: Compare visual branding or product aesthetics across different regions by leveraging the country parameter.

Example Prompts

1. "Find me 5 high-quality photos of urban architecture in Berlin for my design project."
2. "Show me images of the latest electric vehicle models, keep it to strict safe search."
3. "Search for images of 'golden retriever puppies' and display them for me."

Tips & Limitations

• Rate Limiting: Be aware that your Brave API subscription tier determines your usage limits. Avoid spamming requests.
• URL Encoding: Always ensure queries containing spaces or special characters are properly encoded (e.g., replace spaces with %20) to prevent request errors.
• Safety: Always utilize the safesearch parameter when working in professional or educational environments. Default is 'moderate', but can be set to 'strict' for better content filtering.
• Efficiency: Request only the number of images you intend to display to save bandwidth and API credits. You can always ask the agent for 'more' if the initial batch is insufficient.