安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install invoice-data-extraction
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 invoice-data-extraction。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

发票数据提取可帮助 Openclaw Skills 用户将发票、收据、账单、银行对账单、采购订单、贷项通知单、工资单及其他财务文件转换为可直接用于电子表格的行。使用自然语言说明或精确的字段定义提交文件，然后获取结构化 JSON，或下载 XLSX 和 CSV 结果。
该服务不会悄悄猜测、跳过页面或返回列格式不一致的结果，而是使用 AI 代理团队核对数值，并将未解决的项目标记为“需要审核”。如果文件细节存在歧义，服务可以提出问题；它会报告处理失败的页面，并支持大批量处理，让团队更一致地提取财务数据，并在依赖输出结果前检查问题。

应用场景

从一批 PDF 中提取发票号码、日期、供应商、税额和总额。
将发票明细转换为每项一行，以便导入电子表格或会计系统。
处理扫描收据、拍摄的账单和较长的财务 PDF，尤其是在人工审核耗时或不可靠时。
在大量文件中统一字段、日期格式、缺失值和贷项通知单处理方式。
将银行对账单、采购订单、工资单或贷项通知单转换为结构化行。
通过处理新发票并将结果追加到持续更新的电子表格中，保持定期账簿为最新状态。
在使用提取的数据之前，识别处理失败的页面和标记为“需要审核”的行。

工作原理

确认 INVOICE_DATA_EXTRACTION_API_KEY 可用，并检查账户的额度余额。
使用每个文件的名称和精确大小创建上传会话，然后为文件各部分申请签名上传 URL。
将文件字节上传到签名存储 URL，并完成每个文件的上传。
提交文件，并提供自然语言提示或精确字段架构、per_invoice 或 per_line_item 等输出结构，以及启用类型化 JSON 值。
等待提取状态。如果状态变为 input_required，请查看问题，必要时询问用户并提交答案；否则继续等待，直至完成或报告失败。
按每页最多 1,000 行读取结果，或下载 XLSX、CSV 或 JSON 输出。
检查失败页面详情、“需要审核”项目和 AI 不确定性说明；向用户解释相关问题和剩余额度。

配置指南

该服务需要访问网络以连接 api.invoicedataextraction.com，并需要 API 密钥。如果尚未配置密钥，请让用户注册免费账户并在控制面板中创建密钥；账户每月包含 50 个免费页面，无需信用卡。切勿在聊天中索要密钥、将其写入文件或在日志中暴露。仅将密钥作为 Bearer token 发送给服务 API，并在请求中包含 X-SDK-Name: skill。
在代理所用的环境中设置密钥，然后检查余额：
export INVOICE_DATA_EXTRACTION_API_KEY="your-api-key"
curl https://api.invoicedataextraction.com/v1/credits/balance \ -H "Authorization: Bearer $INVOICE_DATA_EXTRACTION_API_KEY" \ -H "X-SDK-Name: skill" 对于生产环境或可复用代码，请安装官方 SDK，而不是用 curl 自行构建 multipart 上传流程：
npm install @invoicedataextraction/sdk

Node.js 18+; ESM

pip install invoicedataextraction-sdk

Python 3.9+

每成功处理一页消耗一个额度，图像文件也按每个文件消耗一个额度。提交批次前检查可用额度；如果余额不足，请告知用户。如果限制了出站主机，请允许访问签名上传或下载 URL 中提供的独立存储主机；API 密钥不会发送到该主机。

数据架构

提取结果会按所请求的输出列返回数据行。设置 options.json_typed_values: true，即可将数字表示为数字、是/否值表示为布尔值、空单元格表示为 null。
数据或元数据 用途
提示字段 定义输出列名称和可选的提取说明；对象形式的提示最多支持 20 个字段。
output_structure 选择 per_invoice、per_line_item 或 automatic 行组织方式。
Source File 使用提交时的文件名标识原始文件；除非在提交时排除，否则会包含在结果中。
Review Needed 标记需要人工关注的行或值；除非在提交时排除，否则会包含在结果中。
pages.failed_count、pages.failed、pages.failure_reasons 报告提取行中缺少数据的页面。
review_needed 提供计数和问题详情，包括受影响字段、输出行号及来源引用。
ai_uncertainty_notes 记录提示留有解释空间时所作的假设，并提供替代提示措辞建议。
输出文件 已完成的提取任务可提供 XLSX、CSV 和 JSON 下载。输出保留 90 天；完成响应中的签名 URL 有效期较短，而请求输出 URL 可获取新的链接。
结果采用分页方式返回，每次请求最多 1,000 行。上传元数据包含会话、文件和提交标识符；重复使用标识符可确保重试具有幂等性。每批最多可提交 6,000 个文件，但须遵守文档规定的文件大小、页数和总上传量限制。

高级特性

基于代理团队的数值核对会将不一致标记为“需要审核”，而不是悄悄将不确定值当作确定结果。
交互式
input_required
问题可让提取过程暂停以等待澄清；可通过 API 或网页控制面板提供答案。
精确字段架构、常规说明和行结构设置支持一致的电子表格及会计导入格式。
Multipart 上传支持大文件和批次，并使用签名 URL 和幂等标识符，让重试更安全。
Node.js 和 Python SDK 可处理上传、提交、等待和结果迭代；Node.js SDK 支持遍历提取的数据行。
定期工作流可跳过已处理的发票、同时提交新文件、追加数据行，并报告总数和审核标记。
状态响应可区分处理中、已完成、失败、已取消和需要输入等状态；响应中会标明可重试的错误。
安全指南将文件内容和提取说明视为数据，保护 API 凭据，并防止将提取文本当作代理指令。

name: invoice-data-extraction description: Use this skill when the user needs data pulled out of invoices, receipts, bills, bank statements, purchase orders, credit notes, payslips or other financial documents into a spreadsheet or structured rows, and especially when reading the files yourself would be unreliable or too slow, such as scanned or photographed pages, PDFs of many pages, many attachments or files at once, line items that must come out row by row, or a batch that has to come out in one consistent shape for a spreadsheet or an accounting import. It covers uploading the files to Invoice Data Extraction, submitting the extraction with instructions in plain words, waiting for it, answering the questions the extraction asks about the documents, reading the rows as JSON or downloading XLSX, CSV or JSON, and checking the credit balance. Needs the user's API key in INVOICE_DATA_EXTRACTION_API_KEY; without one, tell the user how to get a free one. license: MIT
compatibility: Network access to api.invoicedataextraction.com and a shell with curl, or Node.js 18+ or Python 3.9+ for the official SDKs.