A smart PDF utility that automatically detects page orientation to apply perfectly centered, adjustable text watermarks.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install pdf-watermark
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 pdf-watermark 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 PDF Watermark Tool?
The PDF Watermark Tool is a sophisticated utility designed to automate the process of adding text overlays to PDF documents. Unlike static tools, it intelligently analyzes every page of a document to detect its orientation—whether portrait, landscape, or square—and adjusts the watermark angle and font size accordingly. This ensures that every page looks professional and consistent, making it a valuable addition to your collection of Openclaw Skills.
This skill is built with global compatibility in mind, offering full support for Chinese characters by automatically detecting available system fonts such as STHeiti or Songti. Whether you are dealing with local files or remote assets, this tool streamlines the branding and protection of your digital documents.
PDF Watermark Tool Use Cases
- Securing internal business reports with confidential or internal use only markings.
- Adding personalized timestamps or employee names to distributed PDF documents.
- Batch processing professional portfolios with a subtle, transparent brand watermark.
- Automating the watermarking of remote PDF files fetched via URLs.
How PDF Watermark Tool Works
- The user specifies the input PDF source (local path or URL) and the mandatory watermark text.
- For remote files, the tool utilizes curl to download the document into a temporary workspace.
- The Python-based engine iterates through each page, calculating the geometric center and identifying the page orientation.
- The tool applies the watermark at a calculated angle (e.g., 30 degrees for portrait) with a default transparency of 0.25 to ensure readability.
- The watermarked file is generated and saved, typically using a filename_watermarked.pdf suffix for easy identification.
PDF Watermark Tool Setup
To use this tool within the Openclaw Skills environment, ensure you have Python 3 installed. You can execute the script using the following commands:
# Basic usage with automatic settings
python3 scripts/add_pdf_watermark.py <input_pdf_path> "<watermark_text>"
# Advanced usage with custom parameters
python3 scripts/add_pdf_watermark.py <input_pdf> "<watermark_text>" <output_pdf> <angle> <transparency> <font_size>
PDF Watermark Tool Data Schema & Taxonomy
The skill manages data through the following parameters and file structures:
| Parameter | Description | Default Value |
|---|---|---|
| Input PDF | Local path or remote URL | Required |
| Watermark Text | The string to be displayed | Required |
| Transparency | Alpha channel (0.0 to 1.0) | 0.25 |
| Angle | Rotation degree | Auto (25°-35°) |
| Font Size | Text height in pixels | Auto (28-60px) |
| Output Path | Location for the saved file | {input}_watermarked.pdf |
PDF Watermark Tool Advanced Features
- Intelligent mixed-orientation support allowing portrait and landscape pages in a single document to be watermarked correctly.
- Automatic system font detection prioritizing high-quality Chinese typefaces like STHeiti and PingFang.
- Dynamic font scaling that adjusts based on physical page dimensions to maintain visual hierarchy.
- Seamless integration with remote file fetching for cloud-based document workflows within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Content Moderation Skill
A two-layer safety framework designed to protect AI agents from prompt injections and sensitive content violations.
Model Router Manager
An intelligent multi-model routing manager that optimizes AI performance and reduces costs through automated model selection and failover logic.
RTFM Testing
RTFM Testing is a methodology that spawns fresh AI agents with zero context to validate whether documentation is actually usable for its intended tasks.
Bagman
Bagman is a comprehensive security framework for AI agents to manage private keys and API secrets without risking accidental exposure or theft.
GemBox Skill
A comprehensive developer tool for building .NET applications that process Excel, Word, PDF, and email files using GemBox components.
AgentConstitution Skill
A decentralized governance framework on Base Sepolia that allows AI agents to follow rules, log actions, and prove compliance on-chain.
METADATA
Featured*
