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
CODEBLOCK0
Config
Config lives at:
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
CODEBLOCK1
CLI usage
CODEBLOCK2
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"
taxclaw
面向OpenClaw的本地优先AI税务文档提取技能。
🔐 安全与权限声明
TaxClaw透明声明以下权限。安装前请审阅。
| 权限 | 用途与说明 | 默认状态 |
|---|
| 读取文件系统 | 读取您提供的已上传PDF/图片文件 | 必需 |
| 写入文件系统 |
将提取的数据存储至~/.local/share/taxclaw/,配置存储至~/.config/taxclaw/ | 必需 |
|
网络(仅本地) | 仅绑定至localhost:8421——默认模式下无外部网络访问 | 必需 |
|
网络(云端AI) | 仅当您在配置中明确启用云模式并确认隐私警告时生效 | 仅限主动选择 |
|
凭证信息 | 不读取或存储任何凭证——纯本地模式无需API密钥 | 不适用 |
|
敏感数据 | 税务文件保留在您的机器上。默认(Ollama)模式下不会向外部发送任何内容 | 仅限本地 |
TaxClaw不会:
- - 泄露文档、字段或提取的数据
- 读取您明确提供用于导入的路径之外的文件
- 回传数据、发送遥测信息或联系外部服务器(默认模式)
- 向任何第三方存储或传输社会安全号码、雇主识别号或账号
如果您启用云模式(Claude): 将显示强制性的隐私警告。您必须在配置中明确设置cloud_acknowledged: true后才能开始处理。
审计此技能: 源代码完全开源,位于github.com/DougButdorf/TaxClaw(MIT许可证)。安装前请先阅读。
设置
bash
bash ~/.openclaw/workspace/skills/taxclaw/setup.sh
配置
配置文件位于:
- - ~/.config/taxclaw/config.yaml
默认为本地优先(您机器上的Ollama)。如果您启用云模式,TaxClaw将拒绝运行,直到您在配置中明确确认隐私警告。
启动网页界面
bash
bash ~/.openclaw/workspace/skills/taxclaw/start.sh
打开:http://localhost:8421
命令行使用
bash
导入文档
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw \
ingest path/to/document.pdf --filer doug --year 2025
列出文档
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw list
导出(默认宽格式CSV)
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw export --id
导出长格式CSV
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw export --id --format long
导出JSON
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw export --id --format json
启动服务器
~/.openclaw/workspace/skills/taxclaw/bin/taxclaw serve
触发短语(OpenClaw代理)
- - 提取我的税务文档
- 解析这份1099表格 / 读取这份W-2表格
- 打开TaxClaw / 启动taxclaw
- 处理我的税务表格
- 显示我的税务文档