Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
Updated docs with v1.2.0 CLI features: date filters, tag/correspondent/document-type filters, repeatable args
What This Skill Does
Connects AI agents to a Paperless-NGX instance using the ppls CLI. Supports searching, filtering, uploading, downloading, and updating document metadata.
Using the JSON output mode makes document queries directly parseable by agents without any scraping or screen interaction.
When to use it
- Find all invoices from a specific vendor in the last year
- Download a contract by searching its title
- Upload a scanned receipt with tags and correspondent assigned
- List documents missing a correspondent for cleanup
- Check which documents were added or modified this month
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: Find all tax documents from 2024 tagged as Tax and download them
- 1Run ppls tags list --json to find the tag ID for Tax 2024
- 2Run ppls documents list --tag <id> --created-after 2024-01-01 --created-before 2024-12-31 --json to get matching document IDs
- 3Run ppls documents download <ids> --output-dir ~/Downloads/tax-2024 for each result
PDF files downloaded to ~/Downloads/tax-2024
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.