Unsplash

What This Skill Does

The Unsplash skill for OpenClaw integrates the powerful Unsplash API directly into your AI agent's workflow. It allows you to search, browse, and retrieve high-quality, royalty-free images from a massive library of millions of professional photographs. Whether you are generating content, building dynamic applications, or sourcing visual assets for creative projects, this skill provides a seamless, programmatic way to fetch visual media. It handles the complexity of API authentication and provides standardized access to photo metadata, including EXIF data, photographer attribution, and direct download links.

Installation

To integrate this skill into your environment, follow these steps:

1. Execute the installation command: clawhub install openclaw/skills/skills/brokenwatch24/unsplash.
2. Create an account at https://unsplash.com/developers and register your application to obtain an Access Key.
3. Securely store your credentials. You can save the key to ~/.config/unsplash/access_key with restricted permissions (chmod 600) or set the environment variable UNSPLASH_ACCESS_KEY in your shell configuration.

Use Cases

• Automated Content Generation: Programmatically fetch relevant images to accompany blog posts or social media updates.
• UI Prototyping: Pull placeholder imagery for web or mobile application designs.
• Dynamic Mood Boards: Create curated collections of images based on specific colors, themes, or orientations.
• Metadata Analysis: Retrieve technical details (EXIF) from images to assist in photography research or analysis.

Example Prompts

• "Search for 5 high-quality landscape photos of mountains in portrait orientation for my mobile wallpaper."
• "Find me a bright, yellow-themed image of a city street for a design mockup."
• "Get details for photo ID 'abc12345' and trigger the download tracking endpoint."

Tips & Limitations

Be mindful of the Unsplash API rate limits: the demo tier is restricted to 50 requests per hour, while production keys allow 5,000. Always ensure you trigger the download endpoint whenever a user downloads an image to remain compliant with Unsplash developer guidelines. Note that while searching and fetching metadata is straightforward, you must handle API errors (like 404s or 401s) gracefully in your agent's logic. Remember to respect attribution requirements as outlined in the Unsplash licensing terms.