| name | invoice-ocr |
| description | 发票 OCR 识别技能。扫描文件夹中的发票文件（PDF/图片），调用阿里云 OCR API 识别发票信息并导出到 Excel 表格。支持 17+ 种发票类型（增值税发票、火车票、出租车票、机票行程单、定额发票、机动车销售发票、过路过桥费发票等）。使用场景：(1) 用户提到"发票识别"、"发票统计"、"发票整理"、"发票汇总" (2) 用户需要批量处理发票 (3) 用户提到阿里云 OCR 识别发票。**重要：首次使用必须先配置阿里云凭证，主动向用户索要 AccessKey ID 和 AccessKey Secret，或引导用户运行 --config 命令自行配置。** |
发票 OCR 识别技能
批量识别发票并汇总到 Excel 表格。
⚠️ 首次使用必须配置凭证
此技能需要阿里云 OCR 服务，使用前必须先配置凭证！
方式一：向用户提供凭证（推荐）
主动询问用户：
"使用此技能需要阿里云 AccessKey ID 和 AccessKey Secret，请提供这两个凭证。
获取方式：阿里云控制台 → 开通票据凭证识别 → 创建 AccessKey"
然后运行：
python scripts/recognize_invoices.py --config
方式二：引导用户自行配置
告诉用户：
"请先运行以下命令配置阿里云凭证："
python ~/.openclaw/skills/invoice-ocr/scripts/recognize_invoices.py --config
特点
- ✅ 17+ 发票类型 - 自动识别发票类型
- ✅ Excel 输出 - 生成标准 xlsx 文件
- ✅ 支持 PDF/OFD - 电子发票友好
依赖安装
pip install openpyxl
支持的发票类型
| 类型 | 说明 |
|---|
| 增值税发票 | 专用发票、普通发票、电子发票 |
| 火车票 | 火车票识别 |
| 出租车发票 | 机打发票 |
| 定额发票 | 手撕发票 |
| 机票行程单 | 航空运输电子客票 |
| 机动车销售发票 | 购车发票 |
| 网约车行程单 | 滴滴等平台发票 |
| 过路过桥费 | 高速公路发票 |
| 客运车船票 | 汽车票、船票 |
| 税收完税证明 | 完税凭证 |
| 银行承兑汇票 | 票据识别 |
支持的文件格式
| 格式 | 扩展名 |
|---|
| PDF | .pdf |
| OFD | .ofd |
| 图片 | .jpg, .jpeg, .png, .bmp, .gif, .tiff, .webp |
输出字段
按以下顺序输出到 Excel：
| 字段 | 说明 |
|---|
| 发票号码 | 发票代码 + 发票号码 |
| 开票日期 | 开票日期 |
| 购买方信息 | 购买方名称 |
| 销售方信息 | 销售方名称 |
| 项目名称 | 商品/服务名称 |
| 规格型号 | 商品规格 |
| 单位 | 计量单位 |
| 数量 | 商品数量 |
| 单价 | 商品单价 |
| 金额 | 不含税金额 |
| 税率 | 税率百分比 |
| 税额 | 税金金额 |
| 价税合计 | 含税总额 |
注意： 如果发票上某字段不存在，默认填空值。
使用方法
识别发票
python scripts/recognize_invoices.py /path/to/invoices
python scripts/recognize_invoices.py /path/to/invoices --output 发票汇总.xlsx
配置管理
python scripts/recognize_invoices.py --config
python scripts/recognize_invoices.py --list-config
获取阿里云 AccessKey
- 登录 阿里云控制台
- 开通 票据凭证识别 服务
- 创建 AccessKey（建议使用 RAM 子账号）
- 授予
AliyunOCRFullAccess 权限
详细 API 说明见 阿里云 OCR API 参考
工作流程
发票文件 → OCR识别 → Excel表格
↓ ↓ ↓
PDF/图片 混贴识别 xlsx文件
注意事项
- 图片需清晰，建议长宽 > 500px
- 单个文件不超过 10MB
- 阿里云 OCR 按次计费，注意费用控制
- 配置文件保存在技能目录下的 config.json
