← Back to Skills Marketplace
clawbox agenitc file system
by
Benny Jiang
· GitHub ↗
· v1.0.0
· MIT-0
85
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install clwbox
Description
Use the ClawBox CLI to upload, download, organize, search, and share files on ClawBox (clawbox.ink) or a self-hosted ClawBox server. Trigger this skill when...
README (SKILL.md)
ClawBox
ClawBox — a cloud file system for agents with token-based auth, semantic search, folders, and file sharing.
Setup
If the CLI is not installed, run the setup script:
bash ClawBoxSkill/scripts/setup.sh
Or manually:
git clone https://github.com/Alfra-AI/clawbox.git
cd clawbox
pip install .
clawbox init
Commands
clawbox init # Get a token from clawbox.ink
clawbox init --api-url http://localhost:8000 # Self-hosted server
clawbox config --show # View current config
clawbox upload \x3Cfile> # Upload a file
clawbox upload \x3Cfile> --path /docs/file.pdf # Upload into a folder
clawbox download \x3Cfile_id> # Download by ID
clawbox list # List all files
clawbox list --folder /docs/ --recursive # List folder contents
clawbox search "query" # Semantic search
clawbox embed \x3Cfile_id> # Generate embeddings
clawbox embed --failed # Retry failed embeddings
clawbox delete \x3Cfile_id> # Delete a file
clawbox status # Check server + token health
Workflow
- Check if
clawboxis installed. If not, run the setup script. - Run
clawbox statusto verify server connection and token. - If no token, run
clawbox init. - Prefer non-destructive inspection before mutation:
status,config --show,list. - Ask before deletion unless the user explicitly requested it.
- Report key output after each operation: file id, download path, share link, etc.
Key details
- Config:
~/.clawbox/config.json - Default server:
https://clawbox.ink - Searchable formats: text, JSON, XML, PDF, Word, Excel, PowerPoint, CSV
- Storage: 10 MB free (anonymous), 1 GB with Google login
- Folders: virtual paths like
/docs/reports/, created implicitly on upload
For detailed API reference, read ClawBoxSkill/references/api.md.
For self-hosting and deployment, read ClawBoxSkill/references/self-hosting.md.
For troubleshooting, read ClawBoxSkill/references/troubleshooting.md.
Usage Guidance
This skill appears to do what it says (wrap a ClawBox CLI). Before installing/running the setup script: 1) Inspect the GitHub repo (https://github.com/Alfra-AI/clawbox.git) and pyproject.toml to ensure you trust the code you will pip install, because pip install executes package build/install code. 2) Note the setup script expects to be run from a cloned repo (it checks for pyproject.toml) and SKILL.md references a missing self-hosting doc and slightly different paths — follow the included files or the repo's README rather than relying on the path strings in SKILL.md. 3) Understand that using the CLI will connect to the default server (https://clawbox.ink) unless you self-host; uploaded files and tokens will be stored on that server (config lives at ~/.clawbox/config.json), so do not upload sensitive data to the public service unless you trust it. 4) If you want to reduce risk, run the install and CLI in a sandboxed environment or on a self-hosted server you control. If you want higher assurance, provide the upstream repo URL and a quick review of its source files (server and package) would increase confidence.
Capability Analysis
Type: OpenClaw Skill
Name: clwbox
Version: 1.0.0
The 'clwbox' skill provides a CLI interface for interacting with ClawBox (clawbox.ink), a cloud file storage service. The bundle includes standard file management commands (upload, download, search, list) and a setup script (scripts/setup.sh) that installs the CLI tool locally via pip. The instructions and code logic are consistent with the stated purpose of managing cloud files and do not exhibit signs of data exfiltration, malicious execution, or harmful prompt injection.
Capability Tags
Capability Assessment
Purpose & Capability
The name/description match the included CLI-focused instructions and API reference. Required env vars/credentials are absent, which aligns with a user-driven CLI. Minor mismatch: SKILL.md references ClawBoxSkill/... paths and a self-hosting doc (references/self-hosting.md) that is not present in the manifest — a documentation/path inconsistency but not a functional red flag.
Instruction Scope
Runtime instructions tell the agent to check for and use the clawbox CLI, run status/list/upload/search commands, and prefer non-destructive checks before mutations. The instructions reference only the CLI, config at ~/.clawbox/config.json, and the ClawBox API; they do not instruct reading unrelated files or exfiltrating data to unexpected endpoints. They do direct network interaction with the default server (https://clawbox.ink) or a self-hosted URL, which is expected.
Install Mechanism
No formal install spec — an included setup.sh uses pip install on the local repo and then runs 'clawbox init'. Pip installing code (either from a cloned repo or via pip from the repo root) is expected for a Python CLI but runs arbitrary code during install/build steps — inspect the GitHub repo before running. The SKILL.md also suggests git cloning the GitHub repo (a standard source).
Credentials
The skill does not declare or require environment variables or credentials. The docs mention that server-side features (search/embeddings) may require a Google API key on the server, but that pertains to a server admin, not the agent. No unrelated secrets are requested.
Persistence & Privilege
always is false and the skill does not request permanent platform privileges or modify other skills. The setup script may install a package into the environment (normal for a CLI) but the skill does not attempt to alter other agent settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install clwbox - After installation, invoke the skill by name or use
/clwbox - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
ClawBox 1.0.0 initial release:
- Provides CLI for uploading, downloading, organizing, searching, and sharing files on ClawBox (clawbox.ink) or self-hosted server.
- Supports semantic file search, token-based authentication, folder organization, and file sharing links.
- Includes setup steps and command examples for all core operations.
- Details searchable file formats and free storage limits.
- Adds troubleshooting, API reference, and self-hosting documentation.
Metadata
Frequently Asked Questions
What is clawbox agenitc file system?
Use the ClawBox CLI to upload, download, organize, search, and share files on ClawBox (clawbox.ink) or a self-hosted ClawBox server. Trigger this skill when... It is an AI Agent Skill for Claude Code / OpenClaw, with 85 downloads so far.
How do I install clawbox agenitc file system?
Run "/install clwbox" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is clawbox agenitc file system free?
Yes, clawbox agenitc file system is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does clawbox agenitc file system support?
clawbox agenitc file system is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created clawbox agenitc file system?
It is built and maintained by Benny Jiang (@bennyoooo); the current version is v1.0.0.
More Skills