发票 OCR 识别技能#

批量识别发票并汇总到 Excel 表格。

⚠️ 首次使用必须配置凭证#

此技能需要阿里云 OCR 服务，使用前必须先配置凭证！

方式一：向用户提供凭证（推荐）#

主动询问用户：

"使用此技能需要阿里云 AccessKey ID 和 AccessKey Secret，请提供这两个凭证。

获取方式：阿里云控制台 → 开通票据凭证识别 → 创建 AccessKey"

然后运行：

bash

python scripts/recognize_invoices.py --config

方式二：引导用户自行配置#

告诉用户：

"请先运行以下命令配置阿里云凭证："

bash

python ~/.openclaw/skills/invoice-ocr/scripts/recognize_invoices.py --config

特点#

• ✅ 17+ 发票类型 - 自动识别发票类型
• ✅ Excel 输出 - 生成标准 xlsx 文件
• ✅ 支持 PDF/OFD - 电子发票友好

依赖安装#

bash

pip install openpyxl

支持的发票类型#

类型说明增值税发票专用发票、普通发票、电子发票火车票火车票识别出租车发票机打发票定额发票手撕发票机票行程单航空运输电子客票机动车销售发票购车发票网约车行程单滴滴等平台发票过路过桥费高速公路发票客运车船票汽车票、船票税收完税证明完税凭证银行承兑汇票票据识别

支持的文件格式#

格式扩展名PDF.pdfOFD.ofd图片.jpg, .jpeg, .png, .bmp, .gif, .tiff, .webp

输出字段#

按以下顺序输出到 Excel：

字段说明发票号码发票代码 + 发票号码开票日期开票日期购买方信息购买方名称销售方信息销售方名称项目名称商品/服务名称规格型号商品规格单位计量单位数量商品数量单价商品单价金额不含税金额税率税率百分比税额税金金额价税合计含税总额

注意： 如果发票上某字段不存在，默认填空值。

使用方法#

识别发票#

bash

# 识别文件夹中的所有发票
python scripts/recognize_invoices.py /path/to/invoices

# 指定输出文件
python scripts/recognize_invoices.py /path/to/invoices --output 发票汇总.xlsx

配置管理#

bash

# 设置阿里云凭证
python scripts/recognize_invoices.py --config

# 查看当前配置
python scripts/recognize_invoices.py --list-config

获取阿里云 AccessKey#

1. 登录 阿里云控制台
2. 开通 票据凭证识别 服务
3. 创建 AccessKey（建议使用 RAM 子账号）
4. 授予 AliyunOCRFullAccess 权限

详细 API 说明见 阿里云 OCR API 参考

工作流程#

text

发票文件 → OCR识别 → Excel表格
   ↓           ↓         ↓
 PDF/图片   混贴识别   xlsx文件

注意事项#

1. 图片需清晰，建议长宽 > 500px
2. 单个文件不超过 10MB
3. 阿里云 OCR 按次计费，注意费用控制
4. 配置文件保存在技能目录下的 config.json