A secure file system utility that executes file operations within a WebAssembly sandbox for enhanced privacy and control.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install boxed-fs
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 boxed-fs 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 boxed-fs?
boxed-fs provides a robust layer of security for file system interactions by leveraging WebAssembly (WASM) sandboxing. It allows AI agents to perform standard operations like reading, writing, and listing files while strictly confining these actions to explicitly declared directories. This ensures that any file manipulation occurs within a controlled environment, preventing unauthorized access to sensitive system areas.
This skill is an essential component of the Openclaw Skills ecosystem for developers who prioritize security and isolation in their automated workflows. By utilizing a WASM component, it decouples the execution from the host system direct file API, offering a reliable sandbox for AI-driven file management.
boxed-fs Use Cases
- Safely reading and writing files in automated AI coding workflows.
- Managing local workspace files without granting full system disk access.
- Creating, appending, or removing temporary build artifacts within a restricted environment.
- Listing directory structures to provide context to AI agents within a secure boundary.
How boxed-fs Works
- The required WebAssembly component is downloaded to the local Openclaw Skills directory.
- The skill identifies the target directory to serve as the sandbox root.
- File operation requests are passed as structured arguments to the WASM runtime.
- The sandbox validates the path and executes the file system command safely.
- Results are returned to the agent while maintaining strict isolation from the host system.
boxed-fs Setup
To integrate boxed-fs into your Openclaw Skills environment, you must first download the WASM component and then invoke operations through the sandbox runner:
# Create the directory and download the WASM component
mkdir -p ~/.openclaw/skills/boxed-fs/files/
curl -L -o ~/.openclaw/skills/boxed-fs/files/boxed-fs-component.wasm https://raw.githubusercontent.com/guyoung/wasm-sandbox-openclaw-skills/main/boxed-fs/files/boxed-fs-component.wasm
# Example operation: List files in the workspace
# This is handled via the wasm-sandbox-run interface with args: ["list-dir", "--path", "."]
boxed-fs Data Schema & Taxonomy
The boxed-fs skill interacts with files within a designated workspace. It supports the following core operations and parameters:
| Operation | Description | Required Arguments |
|---|---|---|
| read-file | Reads content from a file | --path |
| write-file | Writes content atomically | --path, --content |
| append-file | Appends data to a file | --path |
| copy-file | Copies a file within root | --path, --dest |
| list-dir | Lists directory contents | --path |
| remove-path | Deletes a file or directory | --path |
| mkdir-path | Creates a directory path | --path |
boxed-fs Advanced Features
- Atomic file writing to ensure data integrity during concurrent operations.
- Support for recursive directory creation and path cleanup.
- High-performance execution through WebAssembly near-native speed.
- Native integration with the Openclaw Skills sandboxing protocol for multi-agent safety.
SKILL.md
Loading
Related Openclaw Skills
A-share Financial Analysis
An AI-powered diagnostic tool for A-share companies that generates interactive financial reports across six key performance dimensions.
Career Future Mirror AI Skill
An immersive career planning system that generates high-fidelity HTML reports and facilitates emotional dialogues with a simulated future version of yourself.
Academic Paper Analyzer
A sophisticated AI skill designed to dissect academic PDFs and generate comprehensive structural and citation reports.
B2B Lead Engine
An automated B2B lead generation assistant that identifies competitors, mines potential customers, and generates personalized outreach materials.
Fun-ASR-File
A robust end-to-end speech recognition skill for converting local audio files into accurate text using Alibaba DashScope.
pilot-role-assign
A sophisticated role orchestration skill for agent swarms that enables dynamic, capability-based assignment and hierarchical coordination.
Featured*
