A comprehensive CLI integration for Paperless-NGX that allows AI agents to search, retrieve, and organize digital documents using the ppls tool.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install paperless
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 paperless 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 Paperless-NGX CLI for AI Agents?
The Paperless-NGX skill for Openclaw Skills empowers developers and AI agents to interact with their document management system through a high-performance command-line interface. By utilizing the ppls utility, this skill facilitates deep integration with Paperless-NGX, allowing for automated document processing, metadata management, and advanced search capabilities. It is designed to bridge the gap between static document archives and active AI workflows.
Whether you are managing personal records or enterprise-level archives, this skill provides the necessary endpoints to handle OCR-processed content and complex document relationships. By incorporating this into your Openclaw Skills library, you can automate the lifecycle of your digital paperwork from ingestion to archival.
Paperless-NGX CLI for AI Agents Use Cases
- Automating the classification of incoming invoices, receipts, and contracts.
- Retrieving specific document text for AI-driven summarization or data extraction.
- Synchronizing local document folders with a Paperless-NGX instance.
- Cleaning up document archives by bulk-applying tags or updating correspondent information.
How Paperless-NGX CLI for AI Agents Works
- The AI agent or user executes commands through the ppls CLI to interact with the Paperless-NGX API.
- Commands are issued to search for documents based on specific filters such as date ranges, tags, or OCR content.
- The system returns structured JSON data, which Openclaw Skills can parse to understand document metadata or content.
- For uploads, the skill sends files and associated metadata to the Paperless-NGX server for processing and storage.
Paperless-NGX CLI for AI Agents Setup
To get started with this skill, install the ppls CLI and configure your connection credentials:
npm install -g @nickchristensen/ppls
ppls config set hostname http://your-paperless-host
ppls config set token your-api-token
Paperless-NGX CLI for AI Agents Data Schema & Taxonomy
The skill organizes data around the Paperless-NGX core schema, optimized for JSON consumption:
| Object Type | Key Attributes |
|---|---|
| Document | ID, Title, Content (OCR), Created Date, Modified Date, Tags (Numeric IDs) |
| Correspondent | ID, Name, Matching Algorithm |
| Tag | ID, Name, Color, Slug |
| Document Type | ID, Name, Slug |
Paperless-NGX CLI for AI Agents Advanced Features
- Complex filtering support including tag exclusion (NOT) and multi-tag logic (AND/OR).
- Direct access to full OCR-processed text for deep document analysis within Openclaw Skills.
- Support for pagination and custom page sizes to handle large-scale document repositories.
- Metadata creation on-the-fly, including correspondents, tags, and document types.
SKILL.md
Loading
Related Openclaw Skills
Get Focus Mode
A lightweight macOS utility to programmatically retrieve the current Focus mode status for context-aware automation.
Coding Agent
A sophisticated integration for delegating software engineering tasks to autonomous AI agents through managed background processes and interactive terminals.
Clawdbot Documentation Expert (clawddocs)
A specialized AI agent skill designed to help users navigate, search, and configure the entire Clawdbot ecosystem through structured documentation access.
Expense Tracker
A privacy-focused AI financial assistant that logs, categorizes, and tracks your spending using natural language processing.
CounterClaw
CounterClaw is a production-grade defensive interceptor designed to protect AI agents from malicious prompt injections and sensitive data leaks.
Robonet Workbench
A comprehensive MCP-powered toolkit for building, optimizing, and deploying automated trading strategies across crypto and prediction markets.
METADATA
Featured*
