← 返回 Skills 市场
1181
总下载
2
收藏
1
当前安装
2
版本数
在 OpenClaw 中安装
/install invoices
功能描述
Capture, extract, and organize received invoices with automatic OCR, provider detection, and searchable archive.
使用说明 (SKILL.md)
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
安全使用建议
This skill appears internally consistent with its invoice-management purpose, but review these before enabling:
- Storage and backups: the skill stores originals and derived files under ~/invoices/; confirm you are comfortable with that path, ensure backups are encrypted and retention policies meet your legal needs.
- Email and portal access: email monitoring and URL downloads are optional but require you to provide credentials or connectors. Only configure these if you trust the agent and understand which account it will access.
- OCR and VAT validation: the docs mention a 'vision model' and the VIES API but do not state whether processing is local or sent to third-party services. Ask (or test) where OCR and VIES requests are executed; sending invoice images externally can leak sensitive data.
- Test with non-sensitive data: before putting real or confidential invoices through automation, run a trial with redacted or dummy invoices to verify naming, deduplication, validation logic, and data flows.
- GDPR/PII: invoices may contain personal data. Use redaction or limit exports, and confirm export destinations are compliant with your jurisdictional rules.
- Retention and deletion: the skill's rule is to never delete originals; if you need different retention, prepare a manual policy or modify behavior before bulk import.
If you need the skill to access email/remote services, require explicit, auditable configuration and verify that network calls (OCR/VIES) go to trusted endpoints. Otherwise the skill is coherent and appropriate for the stated purpose.
功能分析
Type: OpenClaw Skill
Name: invoices
Version: 1.0.1
The skill is designed for invoice management, which involves legitimate file system and network access. However, the `process.md` file indicates the agent's capability to 'Download from URL if provided' for invoice capture. While intended for legitimate invoice portals, this capability introduces a vulnerability risk: if an attacker can control the URL provided to the agent, it could lead to arbitrary file download, potentially enabling further exploitation (e.g., RCE if the downloaded file is then processed or executed). There is no explicit malicious intent within the skill's code or instructions, but this capability, combined with email integration (also in `process.md`), makes it suspicious due to the potential for abuse or exploitation, rather than being benign.
能力评估
Purpose & Capability
Name/description align with the instructions: capture, OCR/parse, validate, organize, and search invoices. There are no unexpected required binaries, environment variables, or install steps that would contradict the stated purpose.
Instruction Scope
The SKILL.md/process.md explicitly allows optional email integration, downloading invoices from URLs, and sending documents to a 'vision model' for OCR and to the VIES API for VAT validation. These actions are coherent for invoice processing but can cause broader data access (email inbox, network transfers). The skill does not specify whether OCR/VIES calls run locally or send data to external services, which affects privacy/exfiltration risk.
Install Mechanism
Instruction-only skill with no install spec and no code files. This minimal footprint is consistent with the stated behavior and reduces installation risk (nothing is written to disk by an installer).
Credentials
The skill declares no required environment variables or credentials, which is proportionate. However, useful features (email scanning, portal downloads, VIES validation, remote OCR) will require the user to provide credentials or enable connectors outside the skill. The skill reads/writes user files under ~/invoices/ and handles potentially sensitive personal data (invoices), so data-flow and credential management should be considered before enabling integrations.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request permanent platform presence or modifications to other skills. It writes only to its own stated folder structure and tracks its own state files, which is appropriate for its function.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install invoices - 安装完成后,直接呼叫该 Skill 的名称或使用
/invoices触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Complete rewrite: now manages received invoices (OCR, extraction, archive)
v1.0.0
Initial release
元数据
常见问题
Invoices 是什么?
Capture, extract, and organize received invoices with automatic OCR, provider detection, and searchable archive. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1181 次。
如何安装 Invoices?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install invoices」即可一键安装,无需额外配置。
Invoices 是免费的吗?
是的,Invoices 完全免费(开源免费),可自由下载、安装和使用。
Invoices 支持哪些平台?
Invoices 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Invoices?
由 Iván(@ivangdavila)开发并维护,当前版本 v1.0.1。
推荐 Skills