A powerful REST API bridge for managing self-hosted Immich photo instances, enabling seamless automation for media assets and libraries.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install immich-api
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 immich-api 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 Immich API Bridge?
The Immich API Bridge is a specialized technical tool designed to interface with self-hosted Immich instances. As part of the Openclaw Skills ecosystem, it allows developers and power users to programmatically interact with their photo libraries. This skill bridges the gap between raw REST endpoints and actionable automation, facilitating everything from simple photo uploads to complex album management and server-side job triggers.
By leveraging this skill, you can integrate Immich into broader workflows, ensuring your media is organized, searchable, and backed up according to your specific needs. It provides a structured way to handle authentication and endpoint communication without manually crafting every request, making it an essential component for any Openclaw Skills based automation stack.
Immich API Bridge Use Cases
- Automating bulk photo and video uploads from local storage to an Immich instance.
- Synchronizing external libraries with Immich for centralized media management.
- Building custom search interfaces or discovery tools for private photo collections.
- Managing user permissions and server-side jobs like thumbnail generation.
- Downloading entire albums for offline backup or secondary processing.
How Immich API Bridge Works
- Configure the connection by providing your instance URL and API key as environment variables or CLI arguments.
- Authenticate with the Immich server using the provided credentials to establish a secure session.
- Execute REST commands to interact with specific resources like /api/albums, /api/assets, or /api/users.
- Utilize bundled Python scripts for high-level operations such as bulk synchronization or album downloads.
- Monitor server jobs and library scans to ensure media is correctly processed and indexed within the Openclaw Skills environment.
Immich API Bridge Setup
Configuration
Set up your environment variables to connect to your instance:
Linux/macOS:
export IMMICH_URL="https://your-immich-instance.com"
export IMMICH_API_KEY="your-api-key-here"
Windows (PowerShell):
$env:IMMICH_URL = "https://your-immich-instance.com"
$env:IMMICH_API_KEY = "your-api-key-here"
CLI usage example:
python scripts/upload_photos.py --url "https://your-immich.com" --api-key "your-key" --folder ./photos
Immich API Bridge Data Schema & Taxonomy
| Component | Description | Data Managed |
|---|---|---|
| Assets | Media files | Uploads, Thumbnails, Original Files, Metadata |
| Albums | Logic groups | Album names, Asset IDs, Shared users |
| Users | Access control | User profiles, API Keys, Permissions |
| Libraries | Storage paths | Scan status, Library IDs, File paths |
| Jobs | Background tasks | Queue status, Thumbnail generation, Transcoding |
Immich API Bridge Advanced Features
- Support for bulk asset synchronization via sync_library.py script.
- Direct management of server-side background jobs and queues via the API.
- Advanced search filtering and pagination for large-scale media libraries using Openclaw Skills patterns.
- Flexible deployment via environment variables or direct CLI arguments for seamless integration.
- Capability to generate and download thumbnails in various formats for high-performance previews.
SKILL.md
Loading
Related Openclaw Skills
Skill Security Reviewer
An advanced security auditing tool designed to detect malicious behaviors and obfuscated code within AI agent skills.
Clown Suit (clown-suit)
An operational framework for AI agents that prioritizes direct function and authentic pattern recognition over corporate image management.
openclaw-direct
A lightweight, secure, one-click installer for the OpenClaw ecosystem that bypasses the need for Docker.
CNINFO Announcement Scraper
An automated scraper and analyzer for extracting positive market catalysts from official CNINFO A-share disclosures.
Writing Inspiration
A heuristic writing assistant that helps users brainstorm, structure, and draft articles through interactive, step-by-step questioning.
Writing Proofreading
An advanced 6-step professional proofreading and polishing workflow designed for high-quality Chinese article creation within the Openclaw Skills ecosystem.
Featured*
