# Send TaxClaw to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "taxclaw",
    "name": "TaxClaw",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/DougButdorf/taxclaw",
    "canonicalUrl": "https://clawhub.ai/DougButdorf/taxclaw",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/taxclaw",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=taxclaw",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "PRIVACY.md",
      "README.md",
      "RUNBOOK.md",
      "SKILL.md",
      "TERMS.md",
      "requirements.txt"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/taxclaw"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/taxclaw",
    "downloadUrl": "https://openagent3.xyz/downloads/taxclaw",
    "agentUrl": "https://openagent3.xyz/skills/taxclaw/agent",
    "manifestUrl": "https://openagent3.xyz/skills/taxclaw/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/taxclaw/agent.md"
  }
}
```
## Documentation

### taxclaw

Local-first AI tax document extraction skill for OpenClaw.

### 🔐 Security & Permissions Manifest

TaxClaw declares the following permissions transparently. Review before installing.

PermissionWhat & WhyDefaultRead filesystemReads uploaded PDF/image files you provideRequiredWrite filesystemStores extracted data at ~/.local/share/taxclaw/ and config at ~/.config/taxclaw/RequiredNetwork (local only)Binds to localhost:8421 only — no external network access in default modeRequiredNetwork (cloud AI)Only if you explicitly enable cloud mode in config + acknowledge privacy warningOpt-in onlyCredentialsNone read or stored — no API keys required in local-only modeN/ASensitive dataTax documents stay on your machine. Nothing is sent externally in default (Ollama) modeLocal-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"
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: DougButdorf
- Version: 0.1.1
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/taxclaw)
- [Send to Agent page](https://openagent3.xyz/skills/taxclaw/agent)
- [JSON manifest](https://openagent3.xyz/skills/taxclaw/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/taxclaw/agent.md)
- [Download page](https://openagent3.xyz/downloads/taxclaw)