device-file-search

name	device-file-search
description	Locate and verify files on Android storage before upload/share, especially latest edited photos or videos.
metadata	{"openclaw":{"triggers":{"any":["find file","search file","locate file","latest photo","edited photo","saved photo","send photo","send image","upload photo","upload image","share photo","latest video","dcim","camera","download","capcut","发给我","找文件","找图片","找照片","最新照片","编辑后照片","美化后照片","上传图片","发送照片"]}}}

Device File Search

Use this skill when you need to find a saved file on the Agent Phone, then upload/share it in an app.

Goal

• Return a real, existing absolute file path.
• Prefer the newest matching file.
• Avoid repeated blind searches.

Default Search Order

1. Check likely output folders first:

• /storage/emulated/0/DCIM/Camera
• /storage/emulated/0/Pictures
• /storage/emulated/0/Download
• /storage/emulated/0/Movies

2. For editor-specific outputs, try app-named subfolders:

• /storage/emulated/0/Pictures/CapCut
• /storage/emulated/0/Movies/CapCut
• /storage/emulated/0/DCIM/Camera

3. Only if still missing, run a wider find under /storage/emulated/0.

Command Patterns

Use shell (device-side), not workspace exec.

• Quick latest list: shell("sh -lc 'ls -1t /storage/emulated/0/DCIM/Camera | head -n 20'")

• Wider image search: shell("sh -lc 'find /storage/emulated/0 -type f \\( -iname \"*.jpg\" -o -iname \"*.jpeg\" -o -iname \"*.png\" -o -iname \"*.webp\" \\) | head -n 400'")

• Wider video search: shell("sh -lc 'find /storage/emulated/0 -type f \\( -iname \"*.mp4\" -o -iname \"*.mov\" -o -iname \"*.mkv\" \\) | head -n 400'")

• Verify one candidate path: shell("ls -l /storage/emulated/0/DCIM/Camera/<filename>")

Reliability Rules

• Prefer /storage/emulated/0/... over /sdcard/... (symlink issues can hide find results).
• If /sdcard must be used, use find -L /sdcard ....
• After editing/saving, prioritize files modified in the last few minutes.
• Before telling the user "not found", verify at least 2 directories + 1 wide search.

After Found

• Keep the exact absolute path in memory for the rest of the task.
• Reuse the same path for upload/share actions.
• If upload fails, retry with the same verified path before starting a new search.