An automated utility for identifying, archiving, and reporting on email invoices from popular mail providers like Gmail and 163.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install mail-invoice-archiver-skill
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 mail-invoice-archiver-skill 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 Mail Invoice Archiver?
The Mail Invoice Archiver is a robust technical solution designed to automate the tedious process of gathering financial documents from email. By leveraging this tool within the Openclaw Skills ecosystem, developers can programmatically scan supported mailbox providers to identify invoice attachments or download links. The skill goes beyond simple file saving by implementing intelligent deduplication based on business logic and generating comprehensive monthly reports.
Built with a focus on security and reliability, it supports multiple authentication methods including system keychains and environment variables. Whether you are managing personal finances or corporate expenses, this skill provides a structured way to maintain a local archive and prepare delivery bundles for accounting, ensuring no invoice is missed or double-counted.
Mail Invoice Archiver Use Cases
- Automating the collection of monthly SaaS and utility invoices from multiple email accounts.
- Consolidating financial documents into a structured local archive for long-term storage.
- Identifying failed invoice downloads or missing documents through automated reporting.
- Generating ZIP bundles and summary reports for seamless handoff to accounting departments.
How Mail Invoice Archiver Works
- Perform a diagnostic check using the doctor command to verify the environment and setup requirements.
- Configure the mailbox provider and authentication mode through an interactive setup wizard.
- Synchronize the mailbox for a specific month to identify and download candidate invoices into a local folder.
- Run a reporting pass to analyze the archive for totals, high-value items, and potential data conflicts.
- Generate a delivery bundle containing a ZIP archive of all canonical invoices and a summary of the month's financial activity.
Mail Invoice Archiver Setup
To integrate this skill from the Openclaw Skills library, follow these installation steps:
- Run the interactive setup wizard:
python3 scripts/cli.py setup
- If you prefer environment variables, export your credentials (e.g., for Gmail, use an App Password):
export MAIL_INVOICE_ARCHIVER_EMAIL="[email protected]"
export MAIL_INVOICE_ARCHIVER_AUTH_CODE="your-app-password"
- Verify your configuration:
python3 scripts/cli.py doctor --json
Mail Invoice Archiver Data Schema & Taxonomy
The skill organizes data using a combination of a structured file system and a local database to ensure data integrity within the Openclaw Skills framework:
| Data Type | Storage Location / Format |
|---|---|
| Invoice Files | ~/Documents/invoice-archive/YYYY-MM/ |
| Metadata | SQLite database tracking OCR results, amounts, and vendor info |
| Deduplication | Layered check using message UID, SHA256 hashes, and business keys |
| Business Keys | Unique combination of invoice_number and total_amount |
| Delivery Bundles | ZIP archives containing verified canonical invoices for the period |
Mail Invoice Archiver Advanced Features
- Intelligent format prioritization favoring PDF and high-quality images over fallback formats like ZIP or OFD.
- Layout-aware PDF text extraction to accurately distinguish between buyer and seller entities in complex invoice layouts.
- Secure secret management that keeps credentials stored safely in macOS Keychain or Windows Credential Manager.
- Monthly summary stability logic that handles duplicates across month boundaries to ensure financial accuracy.
- Support for custom IMAP host configurations and flexible Feishu integration for local delivery helpers.
SKILL.md
Loading
Related Openclaw Skills
Subscription Box Curator
A heuristic-driven curation engine that transforms subscription box goals into comprehensive merchandising briefs for DTC brands and operators.
Video Generator Free Best
A cloud-powered AI tool that generates 1080p promotional videos from simple text descriptions and image uploads.
Cross-border Logistics Optimizer
A strategic logistics advisor for comparing international shipping lanes, packaging tactics, and customs risks for e-commerce parcels.
Auto-Updater
Automatically maintain and update your agent core and all installed skills via a scheduled daily cron job.
Influencer Partnership Scout
A strategic marketing agent designed to help e-commerce brands identify creator archetypes and draft professional partnership outreach logic.
Corall
A comprehensive interface for AI agents to interact with the Corall marketplace as either service providers or employers.
Featured*
