NianToB/resources/skills/local/image-search/SKILL.md

name, description

name	description
image-search	Search for web images and optionally download selected images to local files. Use when the user asks to find pictures, reference images, product photos, visual inspiration, covers, illustrations from the web, or images to place into documents, slides, or reports.

image-search

Use this skill when the user needs images from the web.

This skill is independent from OpenClaw's web_search provider configuration. Do not change Tavily, Brave, DuckDuckGo, or SearXNG settings to use this skill.

Standard Workflow

1. Search for image candidates:

node ~/.openclaw/skills/image-search/scripts/search-images.mjs "<query>" --count 8

2. If the user needs usable local files, download a small number of selected results:

node ~/.openclaw/skills/image-search/scripts/search-images.mjs "<query>" --count 8 --download 3

3. Use the returned JSON:

   • results[].imageUrl is the original image URL.
   • results[].thumbnailUrl is the preview image.
   • results[].sourcePageUrl is the page where the image came from.
   • results[].localPath exists only when --download succeeds.

4. When using downloaded images in a PPT, Word file, report, or design task, use localPath.

Output Rules

• Tell the user that web images may have copyright or usage restrictions unless they only need reference material.
• Prefer images with a clear sourcePageUrl.
• If downloads fail, still return image URLs and source pages when available.
• For user-facing answers, show the best 3-8 image candidates with title/source, not a raw wall of JSON.

Examples

node ~/.openclaw/skills/image-search/scripts/search-images.mjs "现代酒店大堂 设计 参考图" --count 6 --download 2
node ~/.openclaw/skills/image-search/scripts/search-images.mjs "coffee shop menu board photo" --count 8
node ~/.openclaw/skills/image-search/scripts/search-images.mjs "AI enterprise dashboard hero illustration" --count 5 --download 1 --output ~/Desktop/image-search-results.json