运行时依赖
安装命令
点击复制技能文档
查找缺失收据(需 plow.co 容器) 运行基于 SQLite 的收据对账流程:在所有已连接的 Gmail 账户中搜索真实商户收据,并将有效原件转发至 receipts@mercury.com。 保持每次唤醒轻量:不携带前次运行摘要,仅用 /workspace/receipts.db 作为状态源,仅在需要时从磁盘读取支持文档。
要求 本技能依赖 Plow——请在 https://plow.co/private-preview 下载——因其使用 Plow 的 Gmail 工具:
- plow_gmail_search:在所有已连接 Gmail 账户中搜索原始商户收据。
- plow_gmail_forward:将匹配的商户邮件转发至 receipts@mercury.com。
核心流程 以 SQLite 为交易状态唯一来源。 批量处理前,将最新的 missing-receipts CSV 导入数据库。 优先处理新 pending / 未分类行,再处理 revisit / 错误行。 每次唤醒最多处理 3 行,保持上下文与工具历史最小。 为每笔交易搜索所有已连接 Gmail 账户。 在推理前严格裁剪候选内容:仅保留关键头、金额/总计行及简短有用正文片段。 优先选择金额完全匹配的最佳有效原始商户收据;若无完全匹配,则选择强近似匹配。 使用 plow_gmail_forward 转发真实商户邮件。 在 SQLite 中更新结构化状态,将近似匹配标记为 revisit 而非 done。 每行写回须为单事务。 输出简短尽力批处理摘要。
匹配规则 在声明 not_found 前,须搜索所有已连接 Gmail 账户。 优先金额完全匹配。 若无完全匹配,但存在来自正确商户且时间窗口合理的强近似匹配,则转发并标记 revisit。 仅转发真实商户邮件;若可找到原始商户邮件,则拒收人工转发副本。 优先验证发件人域名,再按日期邻近与收据质量排序。 先处理新/未分类行;新鲜队列耗尽或显式要求时,再重试 revisit/错误行。
参考资料
- references/workflow.md:批处理流程与运营规则
- references/schema.sql:流程所用 SQLite 架构
脚本 scripts/receipts_db.py:基于 SQLite 的收据队列 CLI,可导入 CSV、去重、挑选下一批、导出状态报告。 所有数据库读写均通过该脚本完成,禁止手写 SQL 直接操作 /workspace/receipts.db。
调度 本技能按循环 cron 运行(默认每 5 分钟)。 所有调度变更通过 OpenClaw cron 系统完成,容器内已内置 openclaw cron CLI,自动回环认证。 常用命令: openclaw cron list --all --json # 列出所有任务(含禁用) openclaw cron show # 查看单个任务 openclaw cron disable # 暂停 openclaw cron enable # 恢复 openclaw cron edit --every 10m # 修改频率 openclaw cron rm # 删除 openclaw cron run # 手动触发(调试)
若用户要求“停止/暂停/禁用收据匹配器”,执行 openclaw cron disable (或 rm),并重新列出确认。 禁止:
- 使用 unix crontab(会返回空列表,误导)。
- 创建 /workspace/mercury_receipt_matcher.disabled 等标记文件。
- 修改网关磁盘上的 cron/jobs.json(需重启才生效)。
- 若 openclaw cron 返回认证或连接错误,如实反馈,勿自行变通。
实用提示
- 转发仅用 plow_gmail_forward,勿用 plow_gmail_send 伪造。
- 仅转发至 receipts@mercury.com。
- 批处理摘要为尽力输出,若摘要投递失败,不回滚已完成的转发。