Skills clawbox

Name: clawbox
Author: openclaw

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 users mention clawbox, clawbox, cloud file storage, uploading files to the cloud, semantic file search, file sharing links, organizing files into folders, or managing tokens and storage quotas. Also use when code imports or references the clawbox CLI tool.

install

source · Clone the upstream repo

git clone https://github.com/openclaw/skills

Claude Code · Install into ~/.claude/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/bennyoooo/clwbox" ~/.claude/skills/openclaw-skills-clawbox && rm -rf "$T"

OpenClaw · Install into ~/.openclaw/skills/

T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/bennyoooo/clwbox" ~/.openclaw/skills/openclaw-skills-clawbox && rm -rf "$T"

manifest: skills/bennyoooo/clwbox/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 <file>                        # Upload a file
clawbox upload <file> --path /docs/file.pdf  # Upload into a folder
clawbox download <file_id>                   # Download by ID
clawbox list                                 # List all files
clawbox list --folder /docs/ --recursive     # List folder contents
clawbox search "query"                       # Semantic search
clawbox embed <file_id>                      # Generate embeddings
clawbox embed --failed                       # Retry failed embeddings
clawbox delete <file_id>                     # Delete a file
clawbox status                               # Check server + token health

Workflow

Check if
```
clawbox
```
is installed. If not, run the setup script.
Run
```
clawbox status
```
to 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