Requirements
- Target platform
- OpenClaw
- Install method
- Manual import
- Extraction
- Extract archive
- Prerequisites
- OpenClaw
- Primary doc
- SKILL.md
Connect to self-hosted Immich instances to manage photos, albums, users, search media, upload/download files, and handle jobs via REST API.
Connect to self-hosted Immich instances to manage photos, albums, users, search media, upload/download files, and handle jobs via REST API.
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
Windows (PowerShell): $env:IMMICH_URL = "https://your-immich-instance.com" $env:IMMICH_API_KEY = "your-api-key-here" Linux/macOS (bash): export IMMICH_URL="https://your-immich-instance.com" export IMMICH_API_KEY="your-api-key-here" Generate API Key in Immich: User Profile โ API Keys โ Create API Key
python scripts/upload_photos.py --url "https://your-immich.com" --api-key "your-key" --folder ./photos python scripts/download_album.py --url "https://your-immich.com" --api-key "your-key" --album-id "abc123" --output ./downloads
# Test connection curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/server-info/ping"
{IMMICH_URL}/api
# List albums curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/albums" # Create album curl -X POST -H "x-api-key: $IMMICH_API_KEY" -H "Content-Type: application/json" \ -d '{"albumName":"My Album"}' "$IMMICH_URL/api/albums" # Get album assets curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/albums/{albumId}"
# Get all assets (paginated) curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/assets?limit=100" # Upload asset curl -X POST -H "x-api-key: $IMMICH_API_KEY" \ -F "file=@/path/to/photo.jpg" \ "$IMMICH_URL/api/assets" # Get thumbnail curl -H "x-api-key: $IMMICH_API_KEY" \ "$IMMICH_URL/api/assets/{assetId}/thumbnail?format=jpeg" -o thumb.jpg # Get original file curl -H "x-api-key: $IMMICH_API_KEY" \ "$IMMICH_URL/api/assets/{assetId}/original" -o original.jpg
# List users curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/users" # Get current user curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/user/me"
# Search assets curl -X POST -H "x-api-key: $IMMICH_API_KEY" -H "Content-Type: application/json" \ -d '{"query":"beach","take":10}' "$IMMICH_URL/api/search/assets"
# List libraries curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/libraries" # Scan library curl -X POST -H "x-api-key: $IMMICH_API_KEY" \ "$IMMICH_URL/api/libraries/{libraryId}/scan"
# Get job statuses curl -H "x-api-key: $IMMICH_API_KEY" "$IMMICH_URL/api/jobs" # Trigger job (e.g., thumbnail generation) curl -X POST -H "x-api-key: $IMMICH_API_KEY" -H "Content-Type: application/json" \ -d '{"jobName":"thumbnail-generation","force":true}' "$IMMICH_URL/api/jobs"
Use the bundled scripts in scripts/ for complex operations: upload_photos.py - Bulk upload photos download_album.py - Download entire album sync_library.py - Sync external library See references/api-endpoints.md for complete endpoint reference.
Code helpers, APIs, CLIs, browser automation, testing, and developer operations.
Largest current source with strong distribution and engagement signals.