A streamlined utility for uploading files to tmpfiles.org and instantly sharing temporary download links through messaging platforms.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install tmpfiles-upload
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 tmpfiles-upload 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 tmpfiles-upload?
The tmpfiles-upload skill provides a fast and efficient way for AI agents to handle file transfers when direct uploads to messaging services are restricted or fail. By leveraging the tmpfiles.org API, this skill enables the generation of short-lived, anonymous download links for images, PDFs, and documents, ensuring smooth communication workflows within the Openclaw Skills ecosystem.
This tool is particularly valuable for developers and teams who need a middle-layer storage solution for transient data. It allows an agent to bridge the gap between local file generation—such as taking a system screenshot—and delivering that asset to a remote user via platforms like Feishu without requiring persistent storage or complex authentication.
tmpfiles-upload Use Cases
- Sharing automated system screenshots when direct messaging platform uploads fail.
- Distributing temporary logs or debug files during a troubleshooting session.
- Providing quick, non-sensitive file access to external collaborators without managing cloud permissions.
- Bypassing attachment size limits on messaging apps for files up to 100MB.
How tmpfiles-upload Works
- The agent identifies a local file or generates one (e.g., via a screencapture command).
- The skill executes a POST request to the tmpfiles.org API endpoint with the file binary.
- Upon a successful response, the skill extracts the file URL and modifies it into a direct download link.
- The resulting link is then passed to a messaging action (like a Feishu bot) to be sent to the target user.
- The file automatically expires and is deleted from the hosting server after approximately 60 minutes.
tmpfiles-upload Setup
To integrate this capability into your environment, ensure the requests library is available in your Python runtime.
pip install requests
You can then test the upload logic using a one-liner within your Openclaw Skills workflow:
python3 -c "import requests; f=open('file.png', 'rb'); r=requests.post('https://tmpfiles.org/api/v1/upload', files={'file': f}); print(r.json()['data']['url'].replace('org/', 'org/dl/'))"
tmpfiles-upload Data Schema & Taxonomy
The skill interacts with the tmpfiles.org v1 API and expects specific metadata structures for successful routing within Openclaw Skills.
| Attribute | Description | Format |
|---|---|---|
| Source File | The local path to the file being uploaded | String (Path) |
| API Endpoint | https://tmpfiles.org/api/v1/upload | URL |
| Expiry | Automated cleanup after ~1 hour | TTL |
| Output Link | Direct download URL (formatted with /dl/) | String (URL) |
| Action Payload | JSON object containing the link and recipient ID | JSON |
tmpfiles-upload Advanced Features
- Direct Download Conversion: Automatically transforms standard tmpfiles.org preview links into direct download URLs for better user experience.
- Cross-Platform Messaging: Seamlessly integrates with the Openclaw Skills messaging protocol to route links to Feishu, Slack, or other configured channels.
- Multi-Step Workflow Automation: Chains system-level commands (like screencapture) directly into the upload and notification pipeline.
SKILL.md
Loading
Related Openclaw Skills
ZenMux Media Gen
A powerful multi-model media generation skill that unifies top-tier image and video AI models under a single ZenMux API key.
Phoenix Iterate
Phoenix Iterate is an AI-driven quantitative strategy workflow that orchestrates briefing, code generation, and forensic diagnosis for QuantConnect strategies.
project-narrator
A specialized workflow for maintaining a living PROJECT-NARRATIVE.md file that captures architecture, decisions, and infrastructure to ensure project reconstructability.
Page Claw
Page Claw is an automated pipeline that transforms structured markdown briefs into sophisticated, single-file static HTML portfolios and personal pages.
AI Intelligent Demand Forecasting
An advanced AI-powered engine for precision sales forecasting, seasonal trend analysis, and automated replenishment planning.
GTM Account Research
A sophisticated intelligence agent that performs deep-dive company research to produce structured, actionable account briefs for sales and marketing teams.
Featured*
