---
name: find-local-file
description: Helps users locate local files on a PC by providing a file name
---

Find Local File

This skill helps users find local files on a PC with openclaw installed by searching for a file using its name.

When to Use This Skill

Use this skill when the user: - Asks to find a file on their computer - Provides a file name and wants to know where it is stored - Is unsure whether a file exists locally - Wants to locate a document without opening it

Supported Platforms

• Windows
• macOS
• Linux

Input Requirements

The user needs to provide: - A file name (e.g. report.pdf, notes.txt, config.json)

Optional: - Partial file name - File extension

How to Help Users

Step 1: Confirm the File Name

• Extract the file name from the user input
• Ask for clarification if the name is ambiguous

Step 2: Search the Local File System

• Search common directories:
• Home directory
• Desktop
• Documents
• Downloads
• Optionally expand to the entire disk if needed

Step 3: Present Results

• Show a list of matching files
• Display full file paths
• Indicate if multiple matches are found

Example output:

Found 2 files:

C:UsersAliceDocumentsreport.pdf

C:UsersAliceDownloadsreport.pdf

Step 4: Ask for Next Action

• Open the file
• Narrow the search
• Search by file type

When No Files Are Found

• Inform the user that no matching files were found
• Suggest checking spelling or file extension
• Offer to search broader locations or by partial name

Safety & Scope

• This skill only reads file metadata (name and path)
• It does not modify or delete files
• It does not upload or share files