taxclaw

name	taxclaw
version	0.1.2
description	Extract, store, and export tax documents (W-2, 1099-DA, all 1099 variants, K-1) using AI. Local-first — your documents never leave your machine. Web UI at localhost:8421.
argument-hint	open TaxClaw, extract my 1099, parse this tax form, process my W-2
allowed-tools	Bash, Read, Write
requires	python3, pip
optional	ollama (for local model mode)

taxclaw

Local-first AI tax document extraction skill for OpenClaw.

🔐 Security & Permissions Manifest

TaxClaw declares the following permissions transparently. Review before installing.

Permission	What & Why	Default
Read filesystem	Reads uploaded PDF/image files you provide	Required
Write filesystem	Stores extracted data at ~/.local/share/taxclaw/ and config at ~/.config/taxclaw/	Required
Network (local only)	Binds to localhost:8421 only — no external network access in default mode	Required
Network (cloud AI)	Only if you explicitly enable cloud mode in config + acknowledge privacy warning	Opt-in only
Credentials	None read or stored — no API keys required in local-only mode	N/A
Sensitive data	Tax documents stay on your machine. Nothing is sent externally in default (Ollama) mode	Local-only

TaxClaw does NOT:

• Exfiltrate documents, fields, or extracted data
• Read files outside of paths you explicitly provide to ingest
• Phone home, send telemetry, or contact external servers (default mode)
• Store or transmit SSN, EIN, or account numbers to any third party

If you enable cloud mode (Claude): A mandatory privacy warning is displayed. You must explicitly set privacy_acknowledged: true in config before processing begins.

Audit this skill: Source code is fully open at github.com/DougButdorf/TaxClaw (MIT License). Read it before you install it.

Setup

bash ~/.openclaw/workspace/skills/taxclaw/setup.sh

Config

Config lives at:

• ~/.config/taxclaw/config.yaml

Default is local-first (Ollama on your machine). If you enable cloud mode, TaxClaw will refuse to run until you explicitly acknowledge the privacy warning in config.

Start web UI

bash ~/.openclaw/workspace/skills/taxclaw/start.sh
# Open: http://localhost:8421

CLI usage

# Ingest a document
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw \
  ingest path/to/document.pdf --filer doug --year 2025

# List documents
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw list

# Export (wide CSV by default)
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw export --id <doc-id>

# Export long CSV
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw export --id <doc-id> --format long

# Export JSON
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw export --id <doc-id> --format json

# Start server
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw serve

Trigger phrases (OpenClaw agent)

• "extract my tax document"
• "parse this 1099" / "read this W-2"
• "open TaxClaw" / "start taxclaw"
• "process my tax forms"
• "show my tax documents"