claw2immich

What This Skill Does

The claw2immich skill integrates OpenClaw with your self-hosted Immich photo management system via the Model Context Protocol (MCP). It provides deep, programmatic access to your entire photo and video library, enabling complex metadata filtering, AI-powered visual search, and automated asset retrieval. Whether you are looking for specific people, locations, or dates, or using CLIP-based natural language search to find a 'dog in the snow', claw2immich bridges the gap between your natural language intent and your private media storage.

Installation

To begin, ensure your Immich instance is fully functional. First, install the MCP server by following the repository instructions at https://github.com/JoeRu/claw2immich. Once the server is running, locate your OpenClaw configuration file (typically config/mcporter.json) and register the immich endpoint by mapping it to your server URL. Finally, execute the install command in your terminal: clawhub install openclaw/skills/skills/joeru/claw2immich to register the toolset with your local agent.

Use Cases

• Automated Memory Curation: Quickly fetch photos of family members by ID to include in shared digital albums or newsletters.
• Content Retrieval: Use natural language queries to locate specific images without knowing exact metadata, such as finding 'photos of my vacation in Italy' or 'images with bright sunset lighting'.
• Asset Management: Programmatically create shared links for external friends or family without navigating the UI, or generate web URLs to link directly to specific events in your library.
• Data Auditing: Run administrative tasks like listing all identified people or all active photo albums to maintain organization.

Example Prompts

1. "Find all photos of Sarah and Mark taken in the last month and create a shared link for the album."
2. "Search my library for 'photos of a mountain landscape' and show me the first 3 thumbnails."
3. "Who are the people in my library, and can you find the web URL for the 'Summer 2023' album?"

Tips & Limitations

• Performance: For large libraries, use the body_size parameters in searches to avoid overwhelming the agent with massive JSON payloads.
• Web URLs: To ensure the generated web_url fields work, verify that your IMMICH_EXTERNAL_DOMAIN is correctly set in your Immich environment settings.
• Security: Since this tool returns shared links, handle these links with the same caution you would apply to private cloud storage URLs. Shared links have an expiration period for added security.