Converts local files generated by headless AI agents into secure, mobile-accessible HTTPS viewer links.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install occ-artifact-gallery
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 occ-artifact-gallery 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 Artifact Gallery?
Artifact Gallery is an advanced capability designed for headless AI agents operating on VPS or remote servers. When an agent creates artifacts such as charts, PDFs, or media, they are typically locked inside local server directory paths. Artifact Gallery bridges this gap by exposing local server assets as secure, external HTTPS links via Tailscale. As one of the critical Openclaw Skills, this mechanism ensures that agents don't return raw terminal-only file paths, but instead deliver shareable assets directly to mobile and web clients.
By leveraging this functionality, developers can quickly generate mobile-viewable assets from chat interfaces like Telegram, Discord, and WhatsApp. It forms a secure pathway from a backend script to a production-grade gallery, demonstrating why modern agent systems benefit greatly from Openclaw Skills for robust asset exposure.
Artifact Gallery Use Cases
- Rendering and viewing newly generated infographics, charts, or diagrams on a mobile screen immediately after an agent creates them.
- Sharing PDF reports, HTML dashboards, and JSON exports with users directly inside chat channels (Telegram, Discord, Slack).
- Keeping server filesystem paths confidential and avoiding exposure of raw directory systems to final end-users.
- Securely streaming generated audio and video assets across Tailscale without public web exposure.
How Artifact Gallery Works
- An AI agent runs a local script and creates output files (e.g., image, report, HTML) in a designated workspace.
- The agent calls the Python registration CLI tool, providing details like path, title, agent source, and relevant tags.
- Artifact Gallery registers the file, validates its root directory for safety, and generates a unique artifact identifier (e.g., art_xxxxx).
- The service generates stable, secure HTTPS endpoints (viewer and download URLs) routed through Tailscale.
- The agent formats its response using a standardized contract and replies to the user with accessible, responsive links.
Artifact Gallery Setup
To get started with this capability, ensure you have the required scripts configured in your workspace. You can integrate it with your local scripts using python executions:
Registering a file:
/home/shadoprizm/occ/venv/bin/python /home/shadoprizm/occ/scripts/artifact_gallery_tool.py register \
--path /home/shadoprizm/occ/brain/infographic-studio/active/INFOG-6311545c/infographic-v1.png \
--title "OCC Infographic dogfood output" \
--source-system occ \
--source-agent concierge \
--tags infographic dogfood
Listing available artifacts:
/home/shadoprizm/occ/venv/bin/python /home/shadoprizm/occ/scripts/artifact_gallery_tool.py list --limit 20
Retrieving artifact link information:
/home/shadoprizm/occ/venv/bin/python /home/shadoprizm/occ/scripts/artifact_gallery_tool.py links art_xxxxx
Artifact Gallery Data Schema & Taxonomy
Artifact Gallery leverages a structured metadata taxonomy and strict directory boundaries. It categorizes files and exposes them through a uniform schema:
Canonical Endpoints
| Description | Endpoint |
|---|---|
| Gallery UI Dashboard | https://n2-pro.tail1c2e65.ts.net/artifacts |
| Individual Asset Viewer | https://n2-pro.tail1c2e65.ts.net/artifacts/a/{artifact_id} |
| Local API Endpoint | http://127.0.0.1:8080/api/artifacts-gallery |
File Registration Parameters
- Path: Full local filesystem path (e.g.,
/home/shadoprizm/occ/...). Must belong to allowlisted root paths. - Title: A human-friendly display name for the artifact.
- Source System/Agent: Tracking indicators showing which process or sub-agent created the asset.
- Tags: Descriptive keywords for organizing within the gallery.
Artifact Gallery Advanced Features
- Tailscale Private Networking Integration: Leverages highly secure Tailscale mesh networks for accessing and serving files, removing the need for public port-forwarding.
- Strict Root-Path Allowlisting: Built-in safety guards that refuse to serve sensitive credential files, hidden files, or dotfiles outside designated directories.
- Standardized Agent Response Contract: Enforces consistent schema responses featuring short summaries, direct viewer_url web links, and separate raw download_url paths.
- Unified API Routing: Offers a clean local REST API interface allowing developers to build custom integrations or automate gallery listings directly.
SKILL.md
Loading
Related Openclaw Skills
OpenRouter Rankings Screenshot & Lark/Feishu Digest
An automated workflow tool for Openclaw Skills that scrapes OpenRouter rankings, generates summarized digests, and publishes structured reports with screenshots directly to Lark/Feishu.
Coin Flip & Dice Guessing Game
An interactive gaming skill enabling AI agents to play coin flip and dice guessing games, returning rich media and text results.
SCNU Psychology Graduate Interviewer
An AI mock interviewer tailored to simulate the postgraduate psychology entrance exam interview at South China Normal University.
Ecommerce Creator Brief Generator
An AI-powered configuration tool designed to instantly generate comprehensive, structured collaboration briefs for ecommerce brand campaigns and influencer partnerships.
wutrix
An intelligent film pre-production toolkit designed to seamlessly capture creative ideas, manage scripts, organize character details, and research worldviews directly from your AI workspace.
CodeGraph Assistant
An automated wrapper for npm codegraph that simplifies codebase indexing, structural search, impact analysis, and context injection for AI programming.
Featured*
