← 返回 Skills 市场

clawbox agenitc file system

Name: clawbox agenitc file system
Author: bennyoooo

作者 Benny Jiang · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install clwbox

功能描述

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...

使用说明 (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 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.

安全使用建议

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.

功能分析

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.

能力标签

requires-oauth-token

能力评估

ℹ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install clwbox
安装完成后，直接呼叫该 Skill 的名称或使用 /clwbox 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

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.

元数据

Slug clwbox

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题