ai-photos 是一个面向 OpenClaw 的个人 AI 相册技能,用于将一个或多个本地照片来源转换为可搜索的 AI 相册。
主要能力:
- 自然语言搜索:可跨照片描述、场景标签和标签进行自然语言检索。
- 日期浏览与筛选:支持按日期浏览和过滤照片。
- 本地 Web 画廊:提供缩略图浏览和大图查看,展示照片详情(包括描述、场景、标签、拍摄时间、设备、位置、方向及文件信息等可用数据),并可从 Web 界面打开原始本地文件。
- 同步与自动索引:支持手动立即同步,也可选择启用自动索引以定期检查照片文件夹中的新增或变更照片。
支持的图片格式:
- macOS:jpg、jpeg、png、webp、heic
- Linux:jpg、jpeg、png、webp
- Linux 上的 heic 仅尽力支持,不承诺提供描述生成或预览支持。
使用方式:
该技能不依赖本地 Python 环境或已检出的 Go 源码树,而是使用最新发布的 ai-photos CLI 发布版本。安装目录为 ~/.openclaw/ai-photos/bin,二进制路径为 ~/.openclaw/ai-photos/bin/ai-photos。每次执行 ai-photos 任务时,需先运行一次引导流程以下载最新稳定版二进制(仓库:https://github.com/zoubingwu/openclaw-ai-photos),并复用生成的二进制路径。
基本流程包括:选择创建新相册、重新连接已有相册或搜索已配置相册;提供本地照片文件夹路径;运行预检以验证文件夹可读、图片分析可用、CLI 正常运行;选择后端(优先 db9,不可用时使用 TiDB Cloud Zero);创建或重新连接相册;执行首次导入或增量更新(通过 prepare-image 生成描述、标签、场景、物体、图中文字等字段并导入);可选启用自动索引,通过 OpenClaw 心跳定期同步;最后交付用户,告知相册已就绪并可尝试搜索。
适用场景:
适合希望用自然语言检索本地照片、按日期浏览照片、在本地画廊中查看照片详情,并希望照片索引能随文件夹变化自动更新的用户。
限制:
- Linux 上的 heic 支持为尽力而为,不保证描述或预览。
- 若最新发布资源下载失败且无缓存二进制,则设置流程会被阻塞。
- 自动索引需要 OpenClaw 心跳配置,且需避免覆盖已有心跳任务。
- 未提供关于收费、价格、具体平台兼容范围或效果保证的更多信息。