Find Local File for Openclaw

A utility designed to help users instantly locate specific files across their local file system using name-based searching.

fidods
v1.0.0
Mar 4, 2026
0
1.1k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install findfilepath

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install findfilepath using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Find Local File?

The find-local-file skill is a specialized tool within the Openclaw Skills library designed to bridge the gap between user queries and local file system management. It empowers AI agents to scan directories on Windows, macOS, and Linux to pinpoint the exact location of documents, configurations, or media files based on provided filenames or extensions. This skill is essential for users who manage large volumes of data and need a quick, automated way to verify file existence or retrieve full file paths without manual navigation.

By leveraging Openclaw Skills, the find-local-file capability ensures that file discovery is fast, accurate, and secure. It focuses solely on file metadata to maintain user privacy, ensuring that file contents remain unread while providing the necessary paths for further action. This makes it a core component for any automated workflow that requires local file awareness.

Find Local File Use Cases

  • Locate a specific report or document when the directory is unknown.
  • Verify if a configuration file exists before executing a setup script.
  • Search for files with specific extensions like .pdf or .json across common directories.
  • Identify duplicate files stored in different system locations such as Downloads and Documents.

How Find Local File Works

  1. Extract and confirm the target filename or partial name from the user's natural language prompt.
  2. Initiate a search through common local directories including the Home folder, Desktop, Documents, and Downloads.
  3. Expand the search scope to the entire disk if initial results in common folders are inconclusive.
  4. Aggregate all matching results and present the absolute file paths clearly to the user.
  5. Provide follow-up options for secondary actions, such as opening the file or narrowing the search results by type.

Find Local File Setup

To enable this feature within the Openclaw Skills environment, ensure your agent has the necessary permissions to access local file metadata. Most users can activate the skill via the CLI:

# Install the skill to your local environment
openclaw install find-local-file

No additional database configuration is required as the skill utilizes native OS file system APIs to perform real-time searches.

Find Local File Data Schema & Taxonomy

The skill processes inputs and generates structured outputs focused on file metadata. It does not store file contents, only the structure required for discovery.

Field Description Type
filename The name or partial string of the file to find String
extension Optional filter for specific file types (e.g., .txt) String
search_paths List of directories currently being scanned Array
results List of discovered absolute file paths for the user Array

Find Local File Advanced Features

  • Support for partial name matching to find files even when the exact name is forgotten.
  • Cross-platform compatibility ensuring seamless performance across Windows, macOS, and Linux systems.
  • Integration ready for other Openclaw Skills to trigger file opening or editing once the path is confirmed.
  • Privacy-centric architecture that only accesses file paths and names without reading or uploading file content.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*