← 返回 Skills 市场

Agent Invoice Generator

Name: Agent Invoice Generator
Author: johnnywang2001

作者 John Wang · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

268

总下载

当前安装

版本数

在 OpenClaw 中安装

/install agent-invoice-generator

功能描述

Generate professional PDF invoices from natural language or structured data. Use when the user asks to create an invoice, bill a client, generate a receipt,...

使用说明 (SKILL.md)

Invoice Generator

Create professional invoices instantly from your agent.

Quick Start

Generate an invoice:

python3 scripts/invoice.py create \
  --client "Acme Corp" \
  --items "Web Development,40h,$150" "Hosting Setup,1,$500" \
  --tax 7 \
  --due-days 30

Commands

Create Invoice

python3 scripts/invoice.py create \
  --client "Client Name" \
  --items "Description,Qty,Rate" \
  --tax 7 \
  --discount 10 \
  --currency USD \
  --due-days 30 \
  --notes "Payment via wire transfer"

From Natural Language

When the user says something like "Invoice Acme Corp for 40 hours of dev work at $150/hr plus a $500 setup fee, 7% tax, net 30" — parse and pass to the create command.

List Invoices

python3 scripts/invoice.py list
python3 scripts/invoice.py list --status unpaid

Mark as Paid

python3 scripts/invoice.py paid --id INV-2026-001

View Invoice

python3 scripts/invoice.py view --id INV-2026-001

Business Info Setup

Configure your business details once:

python3 scripts/invoice.py setup \
  --business "Your Company" \
  --email "[email protected]" \
  --address "123 Main St, City, ST 12345" \
  --phone "+1-555-0100" \
  --logo assets/logo.png

Stored at ~/.openclaw/invoice-config.json.

Invoice Format

Generated invoices include:

Invoice number (auto-incrementing: INV-YYYY-NNN)
Business and client details
Itemized line items with quantities and rates
Subtotal, tax, discount, and total
Due date and payment terms
Notes/terms section
Professional formatting

Output

PDF saved to ~/Documents/Invoices/INV-YYYY-NNN.pdf
Markdown summary printed to chat
Optional: email invoice directly via configured email skill

Currencies

Supports: USD, EUR, GBP, CAD, AUD, JPY, CHF, and 20+ others with proper symbol formatting.

Recurring Invoices

python3 scripts/invoice.py recurring \
  --client "Client" \
  --items "Monthly Retainer,1,$2000" \
  --frequency monthly \
  --start 2026-03-01

Set up as a cron job for automatic generation and delivery.

安全使用建议

This skill appears to do what it claims (create and store invoices locally). Before installing or running it, consider: 1) Local storage/privacy — it writes business info and invoice JSON to ~/.openclaw and PDFs/HTML to ~/Documents/Invoices; treat those files as potentially sensitive and confirm file permissions and backups. 2) Review the full script on disk (you saw a truncated listing); ensure there are no hidden network calls or telemetry before trusting it with real customer data. 3) reportlab is an optional dependency for PDF output — if you install it, use a trusted source (pip from PyPI) and review package provenance. 4) Recurring invoicing suggestions (cron) and 'email via configured email skill' require separate careful configuration: mailing requires credentials and should be reviewed before enabling automatic delivery. 5) Concurrency note: invoice numbering increments the config file on generation and could race in concurrent runs; if you will run this in parallel, consider locking or single-threaded operation. If you want higher assurance, run the script in a sandboxed environment and inspect the full file contents before giving it access to real data.

功能分析

Type: OpenClaw Skill Name: agent-invoice-generator Version: 1.0.0 The invoice-generator skill is a legitimate utility for creating and managing PDF/HTML invoices. The Python script (scripts/invoice.py) handles local data storage and document generation without any network activity, obfuscation, or suspicious execution patterns. All file operations are restricted to the user's home directory (~/.openclaw and ~/Documents/Invoices), and the instructions in SKILL.md align perfectly with the tool's stated functionality.

能力评估

✓ Purpose & Capability

The name and description (generate invoices, PDF output, recurring, payment tracking) match the provided script. The script implements invoice creation, numbering, storage, PDF/HTML generation, listing and marking paid — all coherent with the stated purpose.

ℹ Instruction Scope

SKILL.md instructs use of scripts/invoice.py and documents storage locations (~/.openclaw/invoice-config.json, ~/.openclaw/invoices, ~/Documents/Invoices). That scope is appropriate for an invoicing tool, but the skill stores invoice data and business info unencrypted on disk (privacy risk). SKILL.md also suggests recurring invoices via cron and optional emailing via an external 'email skill' (email sending is not implemented in the provided script and would require separate credential/config review).

✓ Install Mechanism

This is instruction-only with an included Python script; there is no install spec, no downloads, and no third-party install automation. It optionally depends on the reportlab Python package for PDF output (fallback to HTML if missing).

✓ Credentials

The skill declares no required environment variables, credentials, or config paths beyond application-specific file locations under the user's home directory. No unrelated secrets or external service keys are requested.

ℹ Persistence & Privilege

The skill persists configuration and invoice JSON files under ~/.openclaw and writes PDF/HTML invoices to ~/Documents/Invoices. It does not request always:true or modify other skills. Persisting potentially sensitive billing data locally is expected behavior but worth noting for privacy and backup/permission considerations.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install agent-invoice-generator
安装完成后，直接呼叫该 Skill 的名称或使用 /agent-invoice-generator 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Generate professional PDF invoices from natural language. Multi-currency, tax, discounts, recurring invoices, payment tracking.

元数据

Slug agent-invoice-generator

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题