← Back to Skills Marketplace
461
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install findfilepath
Description
Helps locate local files by searching common directories for a specified file name or partial name on Windows, macOS, and Linux.
README (SKILL.md)
---\r
name: find-local-file\r
description: Helps users locate local files on a PC by providing a file name\r
---\r
```\r
\r
# Find Local File\r
\r
This skill helps users find local files on a PC with openclaw installed\r
by searching for a file using its name.\r
\r
## When to Use This Skill\r
\r
Use this skill when the user:\r
- Asks to find a file on their computer\r
- Provides a file name and wants to know where it is stored\r
- Is unsure whether a file exists locally\r
- Wants to locate a document without opening it\r
\r
## Supported Platforms\r
\r
- Windows\r
- macOS\r
- Linux\r
\r
## Input Requirements\r
\r
The user needs to provide:\r
- A file name (e.g. `report.pdf`, `notes.txt`, `config.json`)\r
\r
Optional:\r
- Partial file name\r
- File extension\r
\r
## How to Help Users\r
\r
### Step 1: Confirm the File Name\r
- Extract the file name from the user input\r
- Ask for clarification if the name is ambiguous\r
\r
### Step 2: Search the Local File System\r
- Search common directories:\r
- Home directory\r
- Desktop\r
- Documents\r
- Downloads\r
- Optionally expand to the entire disk if needed\r
\r
### Step 3: Present Results\r
- Show a list of matching files\r
- Display full file paths\r
- Indicate if multiple matches are found\r
\r
Example output:\r
\r
Found 2 files:\r
\r
C:\Users\Alice\Documents\report.pdf\r
\r
C:\Users\Alice\Downloads\report.pdf\r
\r
### Step 4: Ask for Next Action\r
- Open the file\r
- Narrow the search\r
- Search by file type\r
\r
## When No Files Are Found\r
\r
- Inform the user that no matching files were found\r
- Suggest checking spelling or file extension\r
- Offer to search broader locations or by partial name\r
\r
## Safety & Scope\r
\r
- This skill only reads file metadata (name and path)\r
- It does not modify or delete files\r
- It does not upload or share files
Usage Guidance
This skill appears to do what it says (search local folders for file names) and doesn't request credentials or installs. However: (1) a full-disk search can reveal sensitive file paths — consider restricting searches to specific directories (Home, Documents) rather than allowing entire-disk scans; (2) the SKILL.md's statement that it 'does not upload or share files' is not technically enforced by the skill metadata — confirm how the agent will handle and where it will display or transmit results before use; (3) the skill source is unknown — if you need higher assurance, ask the publisher for the exact commands/APIs the skill uses or request the SKILL.md be expanded to list platform-specific search methods, or run it in a sandboxed environment first; and (4) if you are worried about autonomous runs, disable autonomous invocation for this skill or limit its permissions in your agent configuration.
Capability Analysis
Type: OpenClaw Skill
Name: findfilepath
Version: 1.0.0
The skill's `SKILL.md` explicitly states benign intent, claiming it 'only reads file metadata' and 'does not modify or delete files'. However, it instructs the AI agent to offer 'Open the file' as a next action. This capability, if implemented without robust sandboxing, user confirmation, or content analysis by the OpenClaw agent, poses a significant vulnerability risk, potentially leading to arbitrary code execution (RCE) or other harmful actions if a malicious file is located and opened. The instruction to 'expand to the entire disk' also grants broad file system access, increasing the potential impact of such a vulnerability.
Capability Assessment
Purpose & Capability
Name and description (find local files) match the contents of SKILL.md. The skill requests no binaries, no environment variables, and no install — all proportionate for a read-only file-search helper.
Instruction Scope
SKILL.md instructs the agent to search common directories (Home, Desktop, Documents, Downloads) and optionally the entire disk. The instructions are high-level and do not specify which OS commands or APIs will be used. That makes the scope coherent but ambiguous: a full-disk search can read paths to sensitive files, and the skill's claim that it 'does not upload or share files' is a policy statement in prose, not an enforceable constraint.
Install Mechanism
Instruction-only skill with no install spec and no code files — lowest install risk (nothing written to disk by an installer).
Credentials
No environment variables, credentials, or config paths are required — appropriate for a local file-search utility.
Persistence & Privilege
always:false and no special privileges requested. The skill may be invoked autonomously by the agent (platform default), which is normal; if you are concerned about privacy, control autonomous invocation in the agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install findfilepath - After installation, invoke the skill by name or use
/findfilepath - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
1
Metadata
Frequently Asked Questions
What is findFilePath?
Helps locate local files by searching common directories for a specified file name or partial name on Windows, macOS, and Linux. It is an AI Agent Skill for Claude Code / OpenClaw, with 461 downloads so far.
How do I install findFilePath?
Run "/install findfilepath" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is findFilePath free?
Yes, findFilePath is completely free (open-source). You can download, install and use it at no cost.
Which platforms does findFilePath support?
findFilePath is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created findFilePath?
It is built and maintained by Fidods (@fidods); the current version is v1.0.0.
More Skills