← Back to Skills Marketplace
444
Downloads
0
Stars
0
Active Installs
8
Versions
Install in OpenClaw
/install openclaw-receipt-manager
Description
Manage personal receipts by extracting data from images, storing records, and providing expense searches and monthly financial summaries.
Usage Guidance
This skill appears to do what it says: it stores receipts locally in data/receipts and uses a local SQLite DB. Before installing, consider: (1) Verify the skill source (README suggests a GitHub repo — confirm you trust it). (2) The skill will read any image file path you provide that lives under your home directory and copy it into the skill's images folder — avoid passing paths to sensitive files. (3) If tesseract is installed, the skill will call it locally for OCR; tesseract is invoked via subprocess but no network calls are made by the skill code. (4) Inspect the full receipt_db.py CLI portion (the file was partially shown) if you want to be extra cautious; based on the reviewed code there are reasonable sanitization and path checks. (5) Run the tool in a limited environment or with test data first if you have concerns about accidental leakage of sensitive files.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-receipt-manager
Version: 0.1.7
The OpenClaw Receipt Manager skill is classified as benign. The Python scripts (`scripts/handler.py` and `scripts/receipt_db.py`) demonstrate robust security practices, including explicit input sanitization (`sanitize_string`, `validate_path`), safe execution of external commands via `subprocess.run` with argument lists (preventing shell injection), and parameterized SQL queries (preventing SQL injection). Crucially, `scripts/receipt_db.py` includes strong path validation and restricts image file operations to the user's home directory, preventing path traversal and unauthorized file access. No evidence of data exfiltration, malicious execution, persistence mechanisms, or obfuscation was found. The skill's functionality is entirely aligned with its stated purpose of local receipt management.
Capability Assessment
Purpose & Capability
Name/description (receipt extraction, storage, queries) matches the provided scripts and CLI. The handler accepts JSON from the agent and invokes the local CLI to add receipts; the CLI implements DB, deduplication, OCR, parsing, and summaries. No unrelated credentials, binaries, or remote services are requested.
Instruction Scope
SKILL.md instructs initialization, adding, and querying of receipts via the included scripts; handler behavior (read JSON, sanitize fields, call receipt_db.py) matches the doc. The instructions operate on local files under the skill workspace/data/receipts and do not instruct reading unrelated system state or sending data to external endpoints.
Install Mechanism
No install spec is present (instruction-only), and the shipped files contain the implementation. The README suggests cloning a GitHub repo, but no runtime download or remote install step is embedded in the skill files. No high-risk URL downloads or archive extraction are present.
Credentials
The skill requests no environment variables or credentials. It reads and writes files only in its data directory and accepts image paths provided by the agent/user. This file access is proportional to the purpose, though users should be aware that any file under the user's home can be supplied as an image path and will be read/copied.
Persistence & Privilege
always is false and the skill uses normal agent invocation. It writes its own DB and images under its data directory and does not modify other skills or system-wide configurations. Autonomous invocation is allowed (platform default) but not combined with any broad secret access.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-receipt-manager - After installation, invoke the skill by name or use
/openclaw-receipt-manager - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.7
- Initial release with core receipt management functionality.
- Added local CLI for initializing, listing, searching, and getting monthly summaries of receipts.
- Added handler for saving recognized receipt data automatically.
- All data stored locally for privacy; no cloud upload.
v0.1.6
- Non-English trigger keywords ("收据", "发票", "报销", "花费") in SKILL.md were replaced with English equivalents ("invoice", "spending", "claim").
- Three files were removed: SKILL.json, scripts/handler.py, and scripts/receipt_db.py.
v0.1.5
- Documentation updated for improved clarity and detail in SKILL.md.
- No changes to user-facing features or commands.
v0.1.4
- Internal code updates in scripts/handler.py and scripts/receipt_db.py.
- No user-facing changes documented.
v0.1.3
openclaw-receipt-manager v0.1.3
- Updated skill description for clarity and conciseness.
- Refined triggers and usage documentation.
- Simplified README and SKILL.md structure; removed redundant details.
- Added clear privacy note: all data is stored locally, with no cloud upload.
- Improved command examples and file explanations.
v0.1.2
Initial release of openclaw-receipt-manager.
- Added CLI tools for initializing database, adding, searching, listing, and summarizing receipts.
- Implemented local SQLite database and image storage for receipts.
- Included handler and database scripts for receipt extraction and management.
- Provided documentation with setup instructions and usage examples.
v0.1.1
- No changes detected in this version.
- All functionality and documentation remain the same as the previous release.
v0.1.0
Initial release of the Receipt Manager skill.
- Extracts and archives receipt data automatically from chat images.
- Supports both natural language queries and CLI commands for managing and searching receipts.
- Automatically recognizes vendor, date, total, and items from receipt images.
- Provides financial summaries and monthly reports upon request.
- Stores data in a local SQLite database and keeps images organized.
Metadata
Frequently Asked Questions
What is Openclaw Receipt Manager?
Manage personal receipts by extracting data from images, storing records, and providing expense searches and monthly financial summaries. It is an AI Agent Skill for Claude Code / OpenClaw, with 444 downloads so far.
How do I install Openclaw Receipt Manager?
Run "/install openclaw-receipt-manager" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openclaw Receipt Manager free?
Yes, Openclaw Receipt Manager is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Openclaw Receipt Manager support?
Openclaw Receipt Manager is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openclaw Receipt Manager?
It is built and maintained by clinchcc (@clinchcc); the current version is v0.1.7.
More Skills