Enables AI agents to print images and PDFs to any CUPS printer with full PPD-aware configuration support.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install cups-printer
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 cups-printer 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 Printer Skill?
The Printer skill is a specialized tool designed to bridge the gap between AI agents and physical hardware. By integrating this skill into Openclaw Skills, agents gain the ability to manage print jobs, query printer statuses, and understand hardware-specific capabilities like paper margins and resolutions. It is built to be PPD-aware, meaning it dynamically reads the printer's configuration file at runtime to ensure documents are formatted correctly for the specific hardware in use.
Whether handling standard PDF documents or converting images such as PNG, JPG, or WebP, the skill ensures high-fidelity output. It manages the complexities of image centering and DPI scaling automatically, making it an essential addition to any automation workflow that requires physical document production.
Printer Skill Use Cases
- Automating the physical printing of generated reports or documentation.
- Sending design assets and images to a printer with specific DPI requirements.
- Programmatically querying printer status and available media trays before starting a job.
- Standardizing print settings across a fleet of different CUPS-compatible printers.
How Printer Skill Works
- The skill identifies available printers by interfacing with the system CUPS server using lpstat.
- It retrieves the PostScript Printer Description (PPD) file to determine supported features like duplexing, paper sizes, and resolution.
- When a print command is issued, it validates the file type; PDFs are processed directly, while images are converted using the Pillow library.
- During image conversion, the skill calculates the printable area based on PPD margins to ensure the image is centered and scaled correctly.
- The final job is dispatched via the lp command, incorporating any custom CUPS options provided by the user.
Printer Skill Setup
To use this skill within Openclaw Skills, ensure you have the necessary system dependencies and Python packages installed.
# Install required Python library
pip install Pillow
# Ensure CUPS client utilities are installed on your system
# For Debian/Ubuntu:
sudo apt-get install cups-client
Printer Skill Data Schema & Taxonomy
The skill provides structured data regarding printer capabilities and job status. When using the --json flag, the output follows this schema:
| Data Point | Description |
|---|---|
| Printer Name | The system identifier for the CUPS printer |
| Status | Current readiness (e.g., idle, printing, stopped) |
| Capabilities | Supported paper sizes, margins, and duplex modes extracted from PPD |
| CUPS Options | Key-value pairs of hardware-specific settings like tray selection and print quality |
| Supported Formats | PDF, PNG, JPG, GIF, BMP, TIFF, WebP |
Printer Skill Advanced Features
- Machine-readable JSON output for all commands to facilitate multi-agent orchestration.
- Dynamic PPD parsing to support specialized hardware features like high-quality color modes or specific input trays.
- Advanced media selection via the media keyword to bypass PPD limitations using direct IPP tray addressing.
- Symlink resolution for files located within the workspace or temporary directories.
SKILL.md
Loading
Related Openclaw Skills
CodexMonitor
CodexMonitor is a specialized CLI tool for listing, inspecting, and watching local OpenAI Codex sessions on macOS.
Codex Monitor
A dual Python and Swift-based utility for browsing, watching, and managing local OpenAI Codex session logs.
Announcer
House-wide text-to-speech announcements using AirPlay speakers, Airfoil, and ElevenLabs.
Social Research (Ravens)
A tiered social intelligence tool that gathers X/Twitter insights through API access, web search, and browser scraping.
ElevenLabs
A versatile toolkit for programmatic AI audio generation, voice management, and usage tracking.
ElevenLabs AI Audio Skill
A comprehensive toolset for integrating ElevenLabs advanced text-to-speech, sound effects, and music generation capabilities into your AI workflows.
METADATA
Featured*
