← 返回 Skills 市场

Clawed Invoice Generator

Name: Clawed Invoice Generator
Author: alexwong27

作者 alexwong27 · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install clawed-invoice

功能描述

Generate professional PDF invoices with a clean layout — no Playwright, no browser, no complex dependencies. Built for reliability on constrained hosting env...

使用说明 (SKILL.md)

Clawed Invoice Generator

Generate clean, professional PDF invoices with a consistent layout and customisable brand colours.

Layout

┌─────────────────────────────────────────────────────────┐
│  HEADER BAR (dark)  │  Invoice No / Date / Customer No │
│  COMPANY NAME (gold) │  Payment Due Date                  │
├─────────────────────────────────────────────────────────┤
│  BILL TO                                                       │
│  Customer Name                                           │
│  Customer Address                                         │
├─────────────────────────────────────────────────────────┤
│  Code │ Description │ Qty │ Net │ VAT │ Gross            │
│  ─────┼──────────────┼─────┼─────┼─────┼────────          │
│  SVC  │ Service desc │  1  │£xxx │ xx% │ £xxx             │
├─────────────────────────────────────────────────────────┤
│  Subtotal (NET):                              £x,xxx.xx  │
│  VAT 20%:                                     £xxx.xx    │
│  ██████████████ Total ██████████████████████  £x,xxx.xx  │
├─────────────────────────────────────────────────────────┤
│  PAYMENT DETAILS                                         │
│  Account holder: [Company Name]                           │
│  Swift/BIC:    [XXXXXXXX]                                │
│  IBAN:         [XXXX XXXX XXXX XXXX]                    │
├─────────────────────────────────────────────────────────┤
│  Notes / payment terms / legal text                       │
└─────────────────────────────────────────────────────────┘

Colour Palette (customisable via config)

Element	Hex	Usage
Header / boxes	`#2F3640`	Dark charcoal — use in config
Accent / total	`#FFC11E`	Gold — use in config
Row background	`#F8F8F8`	Light grey alternating rows
Body text	`#000000`	Primary content
Labels / muted	`#505050`	Secondary text

Usage

1. Prepare your invoice data as JSON:

{
  "invoiceNumber": "INV-001",
  "invoiceDate":   "01/06/2026",
  "customerNumber": "CUST-001",
  "dueDate":       "07/06/2026",
  "customerName":  "Acme Corp",
  "customerAddress": "123 High Street\
London, EC1 1AB",
  "items": [
    {
      "code": "SVC",
      "description": "Consulting services",
      "qty": "8",
      "net": "2,400.00",
      "vatRate": "20%",
      "vatAmt": "480.00",
      "gross": "2,880.00"
    }
  ],
  "currency": "GBP",
  "entity": "default"
}

2. Run the generator:

node /data/workspace/skills/clawed-invoice/scripts/generate.js \
  --config /data/workspace/skills/clawed-invoice/references/config.json \
  --datafile /path/to/your-invoice.json

3. Output → invoice-INV-001.pdf in /tmp/invoices/ (or your outputDir)

Configuration

Edit references/config.json to set your company details once — the generator pulls them automatically per invoice:

{
  "default": {
    "entity": "Your Company Name Ltd",
    "swift": "XXXXXXXX",
    "iban": "XXXX XXXX XXXX XXXX XXXX",
    "companyNumber": "XXXXXXX",
    "currency": "GBP",
    "vatRate": "20%"
  }
}

For multiple entities (e.g. UK + EU subsidiaries), add additional keys and select via entity: "eu" in your invoice data.

Dependencies

Requires jspdf installed at /data/local/node_modules/jspdf

安全使用建议

Install only if you are comfortable storing generated invoice PDFs locally. Use a private output directory instead of a shared temp location when invoices contain customer addresses, account references, IBAN/SWIFT details, or other sensitive business data, and delete or protect generated PDFs according to your retention needs.

能力评估

✓ Purpose & Capability

The artifact purpose is coherent: it takes invoice/customer/entity/item data and generates a PDF invoice using jsPDF. Customer addresses and payment details are expected for this purpose.

✓ Instruction Scope

Runtime behavior is scoped to reading provided JSON/config data and rendering a PDF. No network calls, command execution, credential harvesting, background workers, or hidden agent instructions were found.

✓ Install Mechanism

No installer or package mutation behavior is present. The skill documents an external jsPDF dependency at /data/local/node_modules/jspdf.

ℹ Credentials

The script reads an invoice data file if requested, reads config from INVOICE_CONFIG or the bundled config path, creates the output directory, and writes a PDF. This is proportionate, though the documented --config option appears parsed but not actually applied.

ℹ Persistence & Privilege

Generated PDFs persist in /tmp/invoices by default or a user-provided outputDir. This persistence is disclosed and expected, but invoices can contain personal and banking data.

如何使用

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

版本历史

v1.0.0

Initial release — PDF invoice generator with jsPDF, no browser dependencies, supports EUR/GBP/USD, custom brand colours, multi-item table, payment details footer. Works on Railway/minimal containers.

元数据

Slug clawed-invoice

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题