A powerful toolset for AI agents to perform advanced file listing, searching, and batch processing with built-in safety checks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install clawdbot-filesystem
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install clawdbot-filesystem 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 Filesystem Management?
Filesystem Management is a comprehensive skill designed to provide AI agents with high-level control over local and remote file systems. As a core component of the Openclaw Skills ecosystem, it enables complex operations like recursive directory traversal, pattern-based filtering, and deep content searching. This tool is built for developers who need to automate file-heavy workflows, allowing agents to intelligently navigate project structures, analyze disk usage, and manage assets without manual intervention. By integrating seamlessly with other Openclaw Skills, it provides a secure and structured way to handle data at scale.
Filesystem Management Use Cases
- Identifying specific code patterns or TODO comments across large repositories.
- Generating visual directory trees and disk space usage reports for project audits.
- Performing safe, pattern-matched batch file copying with dry-run validation.
- Automating system administration tasks like log rotation and temp file cleanup.
How Filesystem Management Works
- The AI agent initiates a command such as list, search, or analyze through the Openclaw Skills interface.
- The skill performs path validation to ensure all operations remain within safe, authorized directories.
- Filtering logic is applied using glob patterns or regex to target the exact files or directories needed.
- The operation is executed, whether it is a full-text search or a recursive directory scan.
- The results are formatted as JSON or ASCII tables, allowing Openclaw Skills to parse and use the data in subsequent steps.
Filesystem Management Setup
Installation
# Install via ClawdHub
clawdhub install filesystem
# Or clone into your skills directory
cd ~/.clawdbot/skills
git clone https://github.com/gtrusler/clawdbot-filesystem
# Set execution permissions
chmod +x filesystem/filesystem
Configuration
Edit the config.json file to define default behaviors:
{
"defaultPath": "./",
"excludePatterns": ["node_modules", ".git"],
"outputFormat": "table"
}
Filesystem Management Data Schema & Taxonomy
The skill manages configuration via a local JSON file and produces structured output for agent consumption.
| Attribute | Description |
|---|---|
defaultPath |
Sets the base directory for all relative path operations. |
excludePatterns |
Defines a list of directories or files to ignore during scans. |
maxDepth |
Controls the depth of recursive directory traversal to save resources. |
outputFormat |
Determines if results are returned as a table, JSON, or plain list. |
Filesystem Management Advanced Features
- Dry Run Mode: Preview the impact of destructive operations like batch copying before they occur.
- Content-Aware Search: Perform deep full-text searches with configurable context lines for better results within Openclaw Skills.
- Safety-First Architecture: Includes path validation and permission checks to prevent accidental data loss or security breaches.
- Directory Analysis: Generate comprehensive statistics, including file type distribution and identification of the largest files.
SKILL.md
Loading
Related Openclaw Skills
Zown Gemini Governor
A high-fidelity token management and model stabilization skill designed to prevent Gemini TPM rate limits through context pruning and atomic pipelines.
Fish Audio S1 TTS Skill
Transform text into high-quality AI speech and automatically sync audio files to your private NextCloud storage.
GSTD Swarm Intelligence (A2A)
A decentralized protocol enabling AI agents to collaborate, solve distributed tasks, and earn GSTD rewards on the TON blockchain.
gstd-a2a: Decentralized Agent-to-Agent Protocol
A decentralized protocol enabling autonomous agents to perform distributed tasks and earn cryptographic rewards on the TON blockchain.
Clawdbot Security Suite
A comprehensive security layer for AI agents providing real-time threat detection and command sanitization as part of the Openclaw Skills ecosystem.
OneBot Adapter
Connect OpenClaw agents to the OneBot protocol for seamless QQ messaging and bot integration.
Featured*
