box

What This Skill Does

The Box skill for OpenClaw enables seamless integration with your Enterprise cloud storage environment. By acting as a secure bridge between your local workflow and the Box API, it allows you to automate file lifecycle management. Whether you need to organize documentation, retrieve historical files, or share project assets with team members, this skill handles the heavy lifting through secure authentication and standardized API calls. It supports essential operations including listing folder contents, uploading local assets to specific directories, and downloading remote files to your local environment for further processing or review.

Installation

To integrate the Box skill into your OpenClaw agent, execute the following command in your terminal: clawhub install openclaw/skills/skills/mrgoodb/box. Once the installation is complete, you must configure your environment variables to allow the agent to authenticate with your Box account. Set your BOX_ACCESS_TOKEN in your system environment settings. Ensure this token has the appropriate scopes configured within the Box Developer Console to perform the intended file operations.

Use Cases

This skill is ideal for teams relying on Box for centralized document management. Typical use cases include: 1) Automated report archiving where the agent fetches generated data and pushes it to a designated Box folder. 2) Project onboarding where an agent retrieves documentation templates from a central repository. 3) Cross-platform file syncing, allowing users to move files between local directories and cloud storage without manually navigating the Box web interface.

Example Prompts

1. "OpenClaw, please list all files inside the root folder on Box and identify any documents added in the last 24 hours."
2. "Upload the latest version of 'project_specs.pdf' from my current directory to the 'Engineering' folder on Box."
3. "Download the file with ID '123456789' from Box and save it as 'downloaded_report.txt' in my local folder."

Tips & Limitations

Always ensure that your BOX_ACCESS_TOKEN is rotated periodically for security. The skill uses the official Box API endpoints, meaning you are subject to the rate limits and folder structure permissions established by your enterprise admin. If the agent fails to perform an action, verify that the folder ID used as the parent destination is correct and that your access token possesses the 'write' permission scope for the target directory. Be mindful of file naming conflicts, as the API may return an error if a file with the same name already exists in the destination folder.