A dedicated New Zealand tax assistant that transforms receipt photos into IRD-ready GST reports and comprehensive annual tax summaries.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kiwi-receipts
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install kiwi-receipts using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Kiwi Receipts?
Kiwi Receipts is a specialized personal-use tool designed for NZ sole traders, builders, and contractors to manage their tax obligations directly within their AI workflow. By leveraging vision capabilities, it processes receipt and invoice images to extract merchant data, GST amounts, and line items, organizing them into a structured local database.
Beyond simple receipt tracking, this Openclaw Skills integration acts as a full-scale financial assistant. it calculates provisional tax, tracks sales income, manages depreciable asset registers, and generates IRD-compliant GST101A forms. It ensures compliance with the Goods and Services Tax Act 1985 and the Income Tax Act 2007 while keeping all financial data private and local.
Kiwi Receipts Use Cases
- Processing photos of physical receipts to claim GST credits during on-site jobs.
- Generating bi-monthly GST reports with pre-filled IRD box numbers (GST101A).
- Calculating annual IR3 income tax liability, including ACC earner's levy and progressive tax brackets.
- Managing an asset register for tools and vehicles, including automatic Diminishing Value (DV) or Straight Line (SL) depreciation calculations.
- Exporting financial data to Xero-compatible CSV formats for professional accounting review.
How Kiwi Receipts Works
- The user provides a receipt photo or text command to the agent.
- The skill utilizes vision analysis to extract key metadata like merchant, date, GST number, and total amounts.
- Extracted data is categorized (e.g., materials, fuel, tools) and presented to the user for confirmation.
- Upon confirmation, the data is appended to local JSON files stored in the user's home directory.
- When requested, the skill runs Python scripts to aggregate the data, apply NZ-specific tax logic, and generate XLSX reports or CSV exports.
Kiwi Receipts Setup
To initialize the skill, provide your business details by typing setup or sending your first receipt. The system will guide you through configuring your business name, GST number, and business-use percentages.
Ensure your local directory is ready:
mkdir -p ~/.openclaw/data/kiwi-receipts
Configure your business settings in config.json manually if needed:
{
"business_name": "Your Name/Business",
"gst_number": "XX-XXX-XXX",
"vehicle_business_percent": 80,
"phone_business_percent": 70
}
Kiwi Receipts Data Schema & Taxonomy
The skill maintains a local hierarchy of JSON files to ensure data persistence and privacy:
| File | Description |
|---|---|
config.json |
Stores business identity and global tax settings. |
receipts.json |
A ledger of all captured purchase receipts and expense metadata. |
income.json |
Records of sales invoices and payments received. |
assets.json |
Depreciable asset register with purchase dates and rates. |
tax-history.json |
Historical Residual Income Tax (RIT) for provisional tax calculations. |
Kiwi Receipts Advanced Features
- Intelligent OCR extraction with automatic 15% GST calculation and tax fraction logic (3/23).
- Multi-sheet XLSX generation including GST101A, Asset Depreciation, and IR3 Annual Tax summaries.
- Automated provisional tax scheduling based on 105% uplift of previous year's RIT.
- Xero-ready CSV exporting with pre-mapped account categories for Cost of Goods Sold and General Expenses.
- Asset disposal logic that automatically calculates deductible losses or taxable depreciation recovery.
SKILL.md
Loading
Related Openclaw Skills
Save to Email
A powerful utility to send formatted HTML emails and notifications through the Resend API via a simple shell interface.
Amortize Reference Tool
A zero-dependency reference tool providing instant access to Amortize devtools documentation and implementation patterns.
Omni Tool
Omni Tool is a versatile terminal utility toolkit for tracking, analyzing, and managing command-line tasks through local log-based storage.
Multi-Search Engine Aggregator
A powerful search aggregation tool that unifies 17 global search engines for comprehensive information retrieval without requiring API keys.
Page Saver
A local, zero-dependency reference tool providing instant access to Page Saver documentation, patterns, and best practices directly in your terminal.
PDF OCR Extractor
A local, privacy-focused tool that converts image-based PDFs into searchable text using Tesseract OCR and Python.
Featured*
