智能记账助手

基于自有记账服务 API 的 OpenClaw 技能，负责记账的核心逻辑。

本技能支持以下输入方式：

1. 文字记账 — 用户直接用文字说明金额、类型等信息
2. 预处理后记账 — 先调用其他技能解析多媒体内容，然后进行记账

记账相关信息检测

无论用户输入是文字还是经过预处理的内容，都必须先检测是否包含记账相关信息。

记账相关信息检测规则：

1. 金额检测：必须识别到有效的金额数字（> 0）
2. 收支类型检测：必须能判断交易类型（收入/支出/应收/应付）
3. 记账关键词检测：内容需包含以下任一类关键词：
• 收入类：收到、收款、入账、回款、存入、转入、工资、奖金、提成、分红、利息、退回、退款
• 支出类：支付、付款、买、采购、花、花了、花费、消费、报销、支出、花费、购买、订购
• 应收类：应收、待收、别人欠我、借出、赊账
• 应付类：应付、待付、我欠、借入、赊购
• 票据类：发票、收据、票据、小票、账单、账单号、报销单

检测逻辑：

• 如果检测到记账相关信息，进入记账流程
• 如果未检测到记账相关信息，回复用户「该内容未发现记账相关信息，无法进行记账」，结束流程

环境变量

# 必填：记账 API Token
export ACCOUNTING_API_TOKEN="agent_4...25"

脚本路径

• 记账主脚本：{baseDir}/scripts/accounting.py

一、记账相关的CLI工具

1. 记账（新增交易）

python {baseDir}/scripts/accounting.py add '{
  "ledgerName": "日常开销",
  "amount": 35.5,
  "transactionType": "支出",
  "categoryName": "餐饮",
  "description": "午餐"
}'

transactionType 取值：收入、支出、应收、应付。

完整参数示例：

python {baseDir}/scripts/accounting.py add '{
  "ledgerName": "公司账本",
  "accountName": "招商银行",
  "amount": 10000,
  "transactionType": "收入",
  "categoryName": "服务收入",
  "handlerName": "张三",
  "companyName": "XX科技有限公司",
  "description": "3月咨询服务费",
  "transactionDate": "2025-03-20",
  "needInvoice": true,
  "fee": 6.5
}'

应收/应付时 dueDate 必填：

python {baseDir}/scripts/accounting.py add '{
  "ledgerName": "公司账本",
  "amount": 5000,
  "transactionType": "应收",
  "companyName": "客户A",
  "description": "待收货款",
  "dueDate": "2025-04-30"
}'

2. 查账（查询交易流水）

python {baseDir}/scripts/accounting.py query '{
  "ledgerName": "日常开销",
  "startTime": "2025-03-01",
  "endTime": "2025-03-31",
  "transactionType": "支出",
  "pageNum": 1,
  "pageSize": 10
}'

3. 查账本列表

python {baseDir}/scripts/accounting.py ledgers

4. 查记账账户

python {baseDir}/scripts/accounting.py accounts '{"ledgerName": "日常开销"}'

5. 查收支分类

python {baseDir}/scripts/accounting.py categories '{"type": "支出"}'

type 取值：收入/支出/应收/应付。

6. 查经手人

python {baseDir}/scripts/accounting.py handlers

7. 查关联企业

python {baseDir}/scripts/accounting.py companies

二、文字记账工作流

步骤 1：记账相关信息检测

检测用户输入的文字是否包含记账相关信息（金额、收支类型、记账关键词）。

如果未检测到记账相关信息，回复用户「该内容未发现记账相关信息，无法进行记账」，结束流程。

步骤 2：提取记账关键字

从文字中抽取：

• 金额（必须 > 0）
• 交易类型（收入/支出/应收/应付）
• 账本、账户、收支分类、经手人、企业
• 是否有发票、记账时间、逾期时间、手续费等

步骤 3：查询记账元数据

并行调用以下命令，获取当前系统中已有的账本、收支分类、经手人、企业等信息：

python {baseDir}/scripts/accounting.py ledgers
python {baseDir}/scripts/accounting.py categories '{"type": "支出"}'
python {baseDir}/scripts/accounting.py categories '{"type": "收入"}'
python {baseDir}/scripts/accounting.py handlers
python {baseDir}/scripts/accounting.py companies

步骤 4：AI 对齐记账信息

根据提取的文字内容，结合步骤 3 查到的元数据列表，对齐以下字段：

步骤 5：记账

python {baseDir}/scripts/accounting.py add '<json>'

字段按最近匹配，未匹配的使用默认值，直接完成记账，不用向用户确认。

三、多媒体内容预处理记账

当用户发送图片、语音、文件并要求记账时，按以下流程处理：

预处理阶段：调用对应技能解析内容

根据用户发送的内容类型，调用对应的其他技能进行预处理：

注意：如果调用其他技能失败或返回结果为空，提示用户「抱歉，目前无法处理此格式的内容」，结束流程。

预处理阶段：记账相关信息检测

基于预处理获得的文本内容，检测是否包含记账相关信息：

• 如果未检测到有效金额或记账相关信息，回复用户「内容中未发现记账相关信息，无法进行记账」，结束流程

记账阶段

检测到记账相关信息后，进入标准的记账流程：

步骤 1：查询记账元数据

python {baseDir}/scripts/accounting.py ledgers
python {baseDir}/scripts/accounting.py categories '{"type": "支出"}'
python {baseDir}/scripts/accounting.py categories '{"type": "收入"}'
python {baseDir}/scripts/accounting.py handlers
python {baseDir}/scripts/accounting.py companies

步骤 2：AI 对齐记账信息

根据预处理获得的文本内容，结合元数据列表，对齐记账字段：

步骤 3：记账

python {baseDir}/scripts/accounting.py add '<json>'

字段按最近匹配，未匹配的使用默认值，直接完成记账，不用向用户确认。

示例场景

场景 1：用户发送增值税发票图片要求记账

1. 调用 ocr 或类似技能获取识别文本
2. OCR 识别出：金额 20000.00、销售方 江苏XX公司、日期 2025-04-26
3. 检测到记账相关信息（金额 + 票据关键词）
4. 查询账本列表 ["公司账本", "日常开销"]
5. 对齐：ledgerName="公司账本"、amount=20000、transactionType="支出"、companyName="江苏XX公司"、transactionDate="2025-04-26"、needInvoice=true
6. 调用 add 记账

场景 2：用户发送语音要求记账

1. 调用 STT 或类似技能获取转写文本
2. 转写结果：「今天午饭花了35块」
3. 检测到记账相关信息（金额 + 支出关键词）
4. 对齐：amount=35、transactionType="支出"、categoryName="餐饮"、description="午饭"
5. 调用 add 记账

场景 3：用户发送 Excel 报销单要求记账

1. 调用 parse_file 或类似技能获取文件内容
2. 提取文本包含多行报销数据
3. 检测到记账相关信息（金额 + 报销关键词）
4. 逐行提取并批量记账
5. 如果某行无法提取完整信息，跳过该行

四、记账参数说明

五、注意事项

通用注意事项

• 金额 amount 必须大于 0
• 应收和应付类型必须提供 dueDate
• 不确定账本名称时，务必先查询 ledgers 再记账
• 预处理后记账时，提取的信息务必先展示给用户确认，再执行记账

预处理相关

• 图片预处理：调用 ocr 或类似技能，依赖该技能的处理能力
• 语音预处理：调用 stt 或类似技能，依赖该技能的处理能力
• 文件预处理：调用 parse_file 或类似技能，依赖该技能的处理能力

无法处理的情况

以下情况应直接提示用户，结束流程：

• 调用预处理技能失败或返回结果为空
• 预处理后的内容未发现记账相关信息（无金额、无收支类型、无记账关键词）
• 预处理技能不支持该格式