A comprehensive interface for searching, browsing, and programmatically downloading high-quality photos from the Unsplash library.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install unsplash
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install unsplash using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Unsplash API?
The Unsplash API skill enables developers and AI agents to tap into a massive library of millions of high-quality, free-to-use images. By integrating this through Openclaw Skills, users can automate visual content discovery, manage photographer attribution, and retrieve extensive metadata for every asset. This skill is built to handle everything from simple keyword searches to complex filtering by color, orientation, and resolution.
Beyond simple retrieval, this skill provides tools for modern web development, such as BlurHash placeholders for smooth loading states and dynamic resizing parameters. Whether you are building a content management system or an automated marketing pipeline, using Openclaw Skills with Unsplash ensures your application has access to professional-grade photography with minimal configuration.
Unsplash API Use Cases
- Automating the selection of header images for blog posts based on content keywords.
- Building dynamic image galleries that filter by specific color schemes or orientations.
- Generating placeholder images for UI/UX prototypes using dynamic resizing.
- Curating editorial feeds or specific user collections for digital marketing displays.
How Unsplash API Works
- The skill authenticates using a registered Access Key stored in the local environment or configuration files.
- Users initiate a search or request a random photo using parameters like query, color, or orientation.
- The API returns a detailed JSON object containing multiple URL variants (raw, full, regular, etc.) and photographer details.
- For performance, the skill can utilize BlurHash strings to display blurred placeholders while high-res images load.
- To maintain compliance, the skill triggers a mandatory download tracking endpoint whenever a photo is downloaded for use.
- Developers can append dynamic parameters to image URLs to perform on-the-fly transformations like cropping or format conversion.
Unsplash API Setup
To get started with this Openclaw Skills integration, you must first obtain an Access Key from the Unsplash Developer Dashboard.
Store Credentials
mkdir -p ~/.config/unsplash
echo "YOUR_ACCESS_KEY" > ~/.config/unsplash/access_key
chmod 600 ~/.config/unsplash/access_key
Environment Variable Option
export UNSPLASH_ACCESS_KEY="your_access_key_here"
Unsplash API Data Schema & Taxonomy
The skill returns structured data for each photo to ensure compatibility across Openclaw Skills workflows:
| Attribute | Description |
|---|---|
| id | The unique identifier for the photo. |
| urls | A dictionary containing raw, full, regular, small, and thumb URLs. |
| blur_hash | A string representation used for generating blurred placeholders. |
| user | Metadata about the photographer, including name and profile links. |
| exif | Technical metadata like camera model, aperture, and focal length (detailed view only). |
| links | Direct API links for tracking downloads and viewing on Unsplash. |
Unsplash API Advanced Features
- Dynamic Resizing: Modify width, height, quality, and format (AVIF/WebP) directly via URL parameters.
- Download Tracking: Automated compliance with Unsplash API guidelines through required endpoint triggers.
- BlurHash Support: Implementation of compact strings for high-performance UI placeholders.
- Advanced Filtering: Narrow results by specific hex colors, landscape/portrait orientations, or collection IDs.
- Rate Limit Monitoring: Transparent tracking of API usage via X-Ratelimit headers within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
JobTread via Pave Query API
A powerful Openclaw Skills integration for managing JobTread construction data, accounts, and documents via the Pave Query API.
Webchat Audio Notifications
A sophisticated audio notification system for webchat platforms that triggers alerts with five intensity levels exclusively when the browser tab is in the background.
Supermemory Free Cloud Knowledge Backup
A specialized tool for persisting high-value AI insights and configuration data to the Supermemory.ai cloud using free tier endpoints.
Repo Onboarding
A comprehensive repository bootstrapping skill that combines technical architecture analysis with structured project management governance.
Async Programming Task Handler
A high-performance skill that enables AI agents to delegate coding tasks to background sub-agents for non-blocking execution.
git-workflow
A comprehensive automation skill for Git that handles change detection, commit message generation, and remote synchronization.
Featured*
