Setup & Installation
openclaw skills install @oskarstark/paperless-ngx
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
npx clawhub install paperless-ngx
What This Skill Does
Connects to a self-hosted Paperless-ngx instance via its REST API to search, upload, download, and organize documents. Supports managing tags, correspondents, document types, and bulk operations across the document archive.
Automates document management tasks that would otherwise require navigating the Paperless-ngx web UI one document at a time.
When to use it
- Search invoices by date range and correspondent
- Upload a scanned receipt and tag it automatically
- Bulk-tag a set of documents after reorganizing categories
- Download the OCR'd version of a contract for text extraction
- Create a new correspondent and reassign existing documents to it
Example Workflow
Here's how your AI assistant might use this skill in practice.
INPUT
User asks: find all invoices from ACME Corp in 2024 and tag them as 'reviewed'
AGENT
- 1Query /api/correspondents/ to find ACME Corp's ID
- 2Search /api/documents/ filtering by correspondent ID and created date range
- 3Collect document IDs from paginated results
- 4POST to /api/documents/bulk_edit/ with method 'add_tag' and the 'reviewed' tag ID
OUTPUT
All matching ACME Corp invoices from 2024 are tagged as reviewed
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.
PAPERLESS_URL environment variable pointing to your Paperless-ngx instancePAPERLESS_TOKEN API token from Paperless-ngx user settingsSelf-hosted Paperless-ngx instance