文件系统管理：高级文件与目录操作 - Openclaw Skills

什么是 文件系统管理？

文件系统管理是一项综合技能，旨在为 AI 智能体提供对本地和远程文件系统的高级控制。作为 Openclaw Skills 生态系统的核心组件，它支持复杂的递归目录遍历、基于模式的过滤和深度内容搜索等操作。此工具专为需要自动化处理大量文件工作流的开发人员构建，允许智能体智能地导航项目结构、分析磁盘使用情况并管理资产，无需人工干预。通过与其他 Openclaw Skills 无缝集成，它提供了一种安全且结构化的方式来处理大规模数据。

下载入口:https://github.com/openclaw/skills/tree/main/skills/gtrusler/clawdbot-filesystem

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

npx clawhub@latest install clawdbot-filesystem

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式 ~/.openclaw/skills/ 工作区 <project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

请帮我使用 Clawhub 安装 clawdbot-filesystem。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

文件系统管理 应用场景

• 在大型代码库中识别特定的代码模式或 TODO 注释。
• 为项目审计生成可视化的目录树和磁盘空间使用报告。
• 通过预演验证执行安全的、符合模式匹配的批量文件复制。
• 自动化系统管理任务，如日志轮转和临时文件清理。

文件系统管理 工作原理

1. AI 智能体通过 Openclaw Skills 界面发起 list、search 或 analyze 等命令。
2. 该技能执行路径验证，以确保所有操作均在安全、授权的目录内。
3. 使用 glob 模式或正则表达式应用过滤逻辑，以定位所需的精确文件或目录。
4. 执行操作，无论是全文搜索还是递归目录扫描。
5. 结果以 JSON 或 ASCII 表格形式格式化，允许 Openclaw Skills 解析并在后续步骤中使用数据。

文件系统管理 配置指南

安装

# 通过 ClawdHub 安装
clawdhub install filesystem

# 或克隆到您的技能目录中
cd ~/.clawdbot/skills
git clone https://github.com/gtrusler/clawdbot-filesystem

# 设置执行权限
chmod +x filesystem/filesystem

配置

编辑 config.json 文件以定义默认行为：

{
  "defaultPath": "./",
  "excludePatterns": ["node_modules", ".git"],
  "outputFormat": "table"
}

文件系统管理 数据架构与分类体系

该技能通过本地 JSON 文件管理配置，并产生结构化输出供智能体使用。

属性	描述
defaultPath	设置所有相对路径操作的基准目录。
excludePatterns	定义扫描期间要忽略的目录或文件列表。
maxDepth	控制递归目录遍历的深度以节省资源。
outputFormat	确定结果以表格、JSON 还是纯列表形式返回。

name: filesystem
description: Advanced filesystem operations - listing, searching, batch processing, and directory analysis for Clawdbot
homepage: https://github.com/gtrusler/clawdbot-filesystem
metadata: {"clawdbot":{"emoji":"??","requires":{"bins":["node"]}}}

?? Filesystem Management

Advanced filesystem operations for AI agents. Comprehensive file and directory operations with intelligent filtering, searching, and batch processing capabilities.

Features

?? Smart File Listing

• Advanced Filtering - Filter by file types, patterns, size, and date
• Recursive Traversal - Deep directory scanning with depth control
• Rich Formatting - Table, tree, and JSON output formats
• Sort Options - By name, size, date, or type

?? Powerful Search

• Pattern Matching - Glob patterns and regex support
• Content Search - Full-text search within files
• Multi-criteria - Combine filename and content searches
• Context Display - Show matching lines with context

?? Batch Operations

• Safe Copying - Pattern-based file copying with validation
• Dry Run Mode - Preview operations before execution
• Progress Tracking - Real-time operation progress
• Error Handling - Graceful failure recovery

?? Directory Analysis

• Tree Visualization - ASCII tree structure display
• Statistics - File counts, size distribution, type analysis
• Space Analysis - Identify large files and directories
• Performance Metrics - Operation timing and optimization

Quick Start

# List files with filtering
filesystem list --path ./src --recursive --filter "*.js"

# Search for content
filesystem search --pattern "TODO" --path ./src --content

# Batch copy with safety
filesystem copy --pattern "*.log" --to ./backup/ --dry-run

# Show directory tree
filesystem tree --path ./ --depth 3

# Analyze directory structure
filesystem analyze --path ./logs --stats

Command Reference

filesystem list

Advanced file and directory listing with filtering options.

Options:

• --path, -p <dir> - Target directory (default: current)
• --recursive, -r - Include subdirectories
• --filter, -f <pattern> - Filter files by pattern
• --details, -d - Show detailed information
• --sort, -s <field> - Sort by name|size|date
• --format <type> - Output format: table|json|list

filesystem search

Search files by name patterns or content.

Options:

• --pattern <pattern> - Search pattern (glob or regex)
• --path, -p <dir> - Search directory
• --content, -c - Search file contents
• --context <lines> - Show context lines
• --include <pattern> - Include file patterns
• --exclude <pattern> - Exclude file patterns

filesystem copy

Batch copy files with pattern matching and safety checks.

Options:

• --pattern <glob> - Source file pattern
• --to <dir> - Destination directory
• --dry-run - Preview without executing
• --overwrite - Allow file overwrites
• --preserve - Preserve timestamps and permissions

filesystem tree

Display directory structure as a tree.

Options:

• --path, -p <dir> - Root directory
• --depth, -d <num> - Maximum depth
• --dirs-only - Show directories only
• --size - Include file sizes
• --no-color - Disable colored output

filesystem analyze

Analyze directory structure and generate statistics.

Options:

• --path, -p <dir> - Target directory
• --stats - Show detailed statistics
• --types - Analyze file types
• --sizes - Show size distribution
• --largest <num> - Show N largest files

Installation

# Clone or install the skill
cd ~/.clawdbot/skills
git clone <filesystem-skill-repo>

# Or install via ClawdHub
clawdhub install filesystem

# Make executable
chmod +x filesystem/filesystem

Configuration

Customize behavior via config.json:

{
  "defaultPath": "./",
  "maxDepth": 10,
  "defaultFilters": ["*"],
  "excludePatterns": ["node_modules", ".git", ".DS_Store"],
  "outputFormat": "table",
  "dateFormat": "YYYY-MM-DD HH:mm:ss",
  "sizeFormat": "human",
  "colorOutput": true
}

Examples

Development Workflow

# Find all JavaScript files in src
filesystem list --path ./src --recursive --filter "*.js" --details

# Search for TODO comments
filesystem search --pattern "TODO|FIXME" --path ./src --content --context 2

# Copy all logs to backup
filesystem copy --pattern "*.log" --to ./backup/logs/ --preserve

# Analyze project structure
filesystem tree --path ./ --depth 2 --size

System Administration

# Find large files
filesystem analyze --path /var/log --sizes --largest 10

# List recent files
filesystem list --path /tmp --sort date --details

# Clean old temp files
filesystem list --path /tmp --filter "*.tmp" --older-than 7d

Safety Features

• Path Validation - Prevents directory traversal attacks
• Permission Checks - Verifies read/write access before operations
• Dry Run Mode - Preview destructive operations
• Backup Prompts - Suggests backups before overwrites
• Error Recovery - Graceful handling of permission errors

Integration

Works seamlessly with other Clawdbot tools:

• Security Skill - Validates all filesystem operations
• Git Operations - Respects .gitignore patterns
• Backup Tools - Integrates with backup workflows
• Log Analysis - Perfect for log file management

Updates & Community

Stay informed about the latest Clawdbot skills and filesystem tools:

• ?? Follow @LexpertAI on X for skill updates and releases
• ??? New filesystem features and enhancements
• ?? Best practices for file management automation
• ?? Tips and tricks for productivity workflows

Get early access to new skills and improvements by following @LexpertAI for:

• Skill announcements and new releases
• Performance optimizations and feature updates
• Integration examples and workflow automation
• Community discussions on productivity tools

License

MIT License - Free for personal and commercial use.

---

Remember: Great filesystem management starts with the right tools. This skill provides comprehensive operations while maintaining safety and performance.