🎁 Get the FREE AI Skills Starter Guide β€” Subscribe β†’
BytesAgainBytesAgain
BytesAgain β€Ί Skills β€Ί Local File Manager 1.0.0
πŸ¦€ ClawHub

Local File Manager 1.0.0

by @000sonic

Read, write, append, and list local files in the session's working directory. Use when you need to persist output to disk, read input files, or manipulate fi...

Versionv1.0.0
Downloads371
Installs1
#writing#legal#productivity
TERMINAL
clawhub install local-file-manager-1-0-0

πŸ“– About This Skill

name: local-file-manager description: Read, write, append, and list local files in the session's working directory. Use when you need to persist output to disk, read input files, or manipulate file system safely. Supports text files, JSON, CSV, Markdown.

Local File Manager Skill

This skill provides safe file I/O operations within the session's cwd. It is designed for roles that need to store outputs locally (no cloud sync).

Capabilities

  • Read file: Get contents of a text file
  • Write file: Create or overwrite a file
  • Append file: Add content to existing file
  • List files: Directory listing with filtering
  • Delete file: Remove a file (with safety checks)
  • Copy/Move: Simple file operations

    • When to Use

    Role needs to:

  • Save generated code/analysis to disk
  • Read input documents (PDFs, text, etc.)
  • Append logs or results
  • Create output files in Markdown/JSON/CSV

    • Usage

    # Read a file
file-manager --action read --path output.md
    Write content (from stdin or --content)
    
file-manager --action write --path result.json --content '{"status":"done"}'
    Append to file
    
file-manager --action append --path log.txt --content "Job completed at $(date)"
    List files in directory
    
file-manager --action list --dir . --pattern "*.md"
    Create directory
    
file-manager --action mkdir --dir reports
    Delete file (with confirmation)
    
file-manager --action delete --path old_file.txt

    Safety

  • Sandboxed to cwd: Cannot access files outside session's working directory
  • Protected files: Cannot delete files starting with . or in ../
  • Size limit: Max file size 10MB (configurable)
  • Dry-run support: --dry-run shows what would happen

    • Integration with Roles

    In role config, enable this skill:

    plugins:
  allow:
    - local-file-manager
    - doc-parser

    Then in the role's system prompt, guide usage:

    When you finish analysis, write the result to a file:
  file-manager --action write --path summary.md --content "$YOUR_MARKDOWN"

    Examples

    Researcher saving analysis: 

    file-manager --action write --path analysis_$(date +%Y%m%d).md \
  --content "# Analysis\n\n## Summary\n..."

    Developer saving code: 

    file-manager --action write --path src/main.py --content "$CODE"

    Automation appending log: 

    file-manager --action append --path /var/log/automation.log \
  --content "[$(date)] Task completed\n"

    Error Handling

  • If file doesn't exist for read: returns error code 1
  • If path is outside cwd: denied
  • If write fails (permission): returns error
  • All errors logged to ~/.openclaw/logs/file-manager.log

    • Configuration

    Environment variables:

  • FILE_MANAGER_MAX_SIZE: Max file size in bytes (default 10485760)
  • FILE_MANAGER_LOG: Path to operation log (default ~/.openclaw/logs/file-manager.log)
  • FILE_MANAGER_DRY_RUN: Set to "1" to only simulate operations

    • ⚑ When to Use

    TriggerAction
    - Save generated code/analysis to disk
    - Read input documents (PDFs, text, etc.)
    - Append logs or results
    - Create output files in Markdown/JSON/CSV

    πŸ’‘ Examples

    Researcher saving analysis: 

    file-manager --action write --path analysis_$(date +%Y%m%d).md \
  --content "# Analysis\n\n## Summary\n..."

    Developer saving code: 

    file-manager --action write --path src/main.py --content "$CODE"

    Automation appending log: 

    file-manager --action append --path /var/log/automation.log \
  --content "[$(date)] Task completed\n"

    βš™οΈ Configuration

    Environment variables:

  • FILE_MANAGER_MAX_SIZE: Max file size in bytes (default 10485760)
  • FILE_MANAGER_LOG: Path to operation log (default ~/.openclaw/logs/file-manager.log)
  • FILE_MANAGER_DRY_RUN: Set to "1" to only simulate operations