How do I install the Taxclaw skill?

Run npx skillmds@latest add modbender/taxclaw in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Taxclaw safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Taxclaw?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Taxclaw free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Taxclaw?

modbender (@modbender) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Taxclaw by modbender — Agent Skill

Name: Taxclaw
Rating: 4.2 (5 reviews)
Author: modbender

File contents

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 cloud_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"

---name: taxclawdescription: 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.--- # 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 `cloud_acknowledged: true` in config before processing begins. **Audit this skill:** Source code is fully open at [github.com/DougButdorf/TaxClaw](https://github.com/DougButdorf/TaxClaw) (MIT License). Read it before you install it. ## Setup ```bash 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 bash ~/.openclaw/workspace/skills/taxclaw/start.sh # Open: http://localhost:8421 ``` ## CLI usage ```bash # 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"

Frequently asked questions

Taxclaw