asustor-pro-adaptive-suite

What This Skill Does

The asustor-pro-adaptive-suite is a specialized OpenClaw agent skill designed for deep, non-destructive discovery of ASUSTOR NAS infrastructure. It operates as a hybrid engine, bridging high-level SMB file crawling with low-level SSH system diagnostics. The skill is purpose-built to index NAS metadata, identify RAID configurations, verify Btrfs integrity, and parse internal SQLite databases without ever altering user data. By leveraging Python for logic and XAMPP for web-based visualization, it provides a comprehensive dashboard for system administrators to audit their storage health, track file permissions, and monitor NAS volume status. The agent is explicitly engineered for hardware awareness, employing process throttling to ensure it respects the constraints of an i3-10th Gen environment while keeping GPU resources entirely reserved for the user's primary system activities.

Installation

To integrate this suite into your environment, run the following command within your OpenClaw terminal: clawhub install openclaw/skills/skills/afajohn/nas-master

Use Cases

• Infrastructure Auditing: Quickly identify orphan files, permission mismatches (UID/GID), and Btrfs checksum health across complex volumes.
• Storage Management: Create an searchable, local PHP/AJAX dashboard of your NAS contents for instant access without mounting remote drives.
• Compliance & Security: Detect misconfigured Windows ACLs or unexpected hidden directory structures within the @metadata and @encdir system zones.
• Performance Optimization: Use the exported insights to pinpoint high-IO latency areas while ensuring the system remains within the safe 25% CPU utilization envelope.

Example Prompts

1. "Perform a deep system scan on NAS_VOLUMES and update the XAMPP database with the latest file size and permission changes."
2. "Extract current RAID status and Btrfs scrub metrics, then export the summary to the nas_explorer dashboard."
3. "Scan my hidden system folders for potential permission drift and generate a report on any discrepancies found within the @plugins directory."

Tips & Limitations

• Efficiency: The skill utilizes pathlib generators; for very large datasets, ensure the initial index has sufficient storage space in your XAMPP local path.
• Hardware Safety: The skill automatically enforces a 150ms delay per 50 files; do not attempt to override this if running on constrained hardware to prevent system stuttering.
• Read-Only Guarantee: The agent relies on os.access() checks; if the tool reports a switch to 'Read-Only' mode, it indicates the agent has detected potential write-risks and is proactively protecting your data.