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 "billing@company.com" \
  --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.