/install invoices
Trigger
Use when user receives invoices (email, photo, PDF) and wants them organized automatically.
Key difference: This skill MANAGES received invoices. The invoice skill CREATES invoices to send.
Storage
~/invoices/
├── inbox/ # Unprocessed files awaiting extraction
├── archive/ # Organized by year/month
│ └── 2026/
│ └── 02/
│ └── 2026-02-13_Hetzner_INV-12345_89.50.pdf
├── providers/ # Provider metadata
│ └── index.json
├── entries.json # All invoice metadata (searchable)
└── state.json # Processing state
Quick Reference
| Topic | File |
|---|---|
| Capture and extraction workflow | process.md |
| Fields to extract | extraction.md |
| Search queries and reports | search.md |
| Legal requirements by country | legal.md |
Process Summary
- Capture — Receive invoice (email attachment, photo, direct PDF). Copy to
inbox/. - Extract — OCR if needed, parse fields (provider, date, amounts, tax).
- Validate — Check required fields, detect duplicates.
- Organize — Rename, move to
archive/YYYY/MM/, updateentries.json. - Confirm — Show extracted data, allow corrections.
See process.md for detailed workflow.
Critical Rules
- Never delete originals — Keep PDFs permanently. Legal requirement (4-6 years depending on country).
- Detect duplicates — Same invoice number + provider = duplicate. Alert, don't overwrite.
- Validate tax math — Base + tax should equal total. Flag discrepancies.
- Provider normalization — "HETZNER ONLINE GMBH" = "Hetzner". Maintain provider aliases.
Alerts
- Invoice pending >48h in inbox
- Payment due in \x3C7 days
- Unusual amount (>50% higher than same provider average)
- Missing expected recurring invoice
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install invoices - After installation, invoke the skill by name or use
/invoices - Provide required inputs per the skill's parameter spec and get structured output
What is Invoices?
Capture, extract, and organize received invoices with automatic OCR, provider detection, and searchable archive. It is an AI Agent Skill for Claude Code / OpenClaw, with 1181 downloads so far.
How do I install Invoices?
Run "/install invoices" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Invoices free?
Yes, Invoices is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Invoices support?
Invoices is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Invoices?
It is built and maintained by Iván (@ivangdavila); the current version is v1.0.1.