PicoClaw Financev — PicoClaw Finance版本

picoclaw-finance 通过 Telegram 为 PicoClaw 提供完整的个人财务管理。通过自然对话跟踪每笔支出、监控预算、设定储蓄目标并导入银行对账单 PDF 文件。

存储 所有数据以 JSON 格式存储在 finance/ 目录下的 agent workspace 中：workspace/finance/ ├── transactions.json ├── budgets.json ├── goals.json └── config.json

数据模式 transactions.json { "transactions": [ { "id": "20260511-001", "date": "2026-05-11", "type": "expense", "amount": 35.00, "currency": "BRL", "category": "transporte", "description": "Uber ate o escritorio", "source": "manual" } ] } budgets.json { "budgets": [ { "month": "2026-05", "categories": { "alimentacao": 800, "transporte": 300, "moradia": 1200, "saude": 200, "lazer": 400, "educacao": 300, "assinaturas": 150, "mercado": 600, "roupas": 200, "outros": 300 }, "total": 4450 } ] } goals.json { "goals": [ { "id": "viagem", "name": "Viagem para Europa", "target": 8000, "saved": 3200, "created": "2026-01-10", "deadline": "2026-12-01" } ] } config.json { "default_currency": "BRL", "categories": [ "alimentacao", "transporte", "moradia", "saude", "lazer", "educacao", "assinaturas", "mercado", "roupas", "outros" ], "currency_symbol": "R$", "recurring": [ { "id": "netflix", "description": "Netflix", "amount": 59.90, "category": "assinaturas", "day": 10, "active": true } ] }

命令 代理识别这些意图并使用 read_file、write_file 和 exec 工具执行它们。

添加支出 当用户说类似的话时： "gastei 35 reais em uber" "comprei pizza por 45 reais" "gastei 150 no mercado" "150 reais de gasolina" 代理应： 提取金额和描述 从描述中推断类别（使用下面的映射） 保存到 transactions.json 中 格式化回复使用 Telegram 模板

类别推断： alimentacao → restaurante、pizza、lanche、almoco、cafe、ifood transporte → uber、taxi、gasolina、onibus、metro、estacionamento moradia → aluguel、condominio、agua、luz、internet saude → farmacia、remedio、medico、dentista、plano lazer → cinema、show、festa、jogo、bar、cerveja educacao → curso、faculdade、livro、udemy assinaturas → netflix、spotify、streaming、mensalidade mercado → supermercado、mercado、acougue、feira roupas → roupa、sapato、camisa、tenis outros → 其他

添加收入 当用户说类似的话时： "recebi 5000 de salario" "entrou 2000 de freela" "recebi 150 de dividendos" 代理应： 提取金额和描述 保存为类型 "income"，类别为 "salario"、"freela"、"investimentos" 或 "outros" 确认使用 Telegram 模板

添加定期支出 当用户说类似的话时： "adicionar netflix 59,90 todo mes" "assinatura spotify 21,90 por mes" "adicionar conta de agua 80 todo mes" 代理应： 提取描述、金额、天数 保存到 config.json 中的 recurring 数组中 每月 1 日（通过 heartbeat），处理所有活动的定期项目作为交易

月度总结 当用户询问时： "qual meu saldo?" "resumo do mes" "como estao minhas financas?" 代理应： 读取 transactions.json 过滤当前月份 计算每个类别的总计 应用格式化模板

类别细分 当用户询问时： "quanto gastei em alimentacao?" "gastos por categoria" "onde estou gastando mais?" 代理应： 读取和过滤交易 按类别分组 按金额降序排序 格式化使用进度条

目标 当用户说类似的话时： "quero juntar 5000 pra viagem em dezembro" "adicionei 500 na meta do notebook" "quais minhas metas?" 代理应： 创建、更新或列出 goals.json 中的目标 显示进度条

设置预算 当用户说类似的话时： "definir orcamento de 3000" "meu orcamento esse mes e 4000" "mudar orcamento para 3500" 代理应： 保存当前月份的总预算 如果用户指定每个类别，保存它们 当支出超过预算时提醒

导入 PDF 当用户发送 PDF 文件或说类似的话时： "ler esse extrato" "importar esse pdf" "extrair desse extrato bancario" 代理应： 保存附件 PDF 到 finance/imports/ 中 运行：pdftotext finance/imports/extrato.pdf - 解析输出文本以识别每笔交易 向用户呈现格式化的预览 确认后保存所有交易 拒绝后丢弃

Telegram 格式化模板 交易确认 Picoclaw Finance — Transacao Registrada ─────────────────────── Despesa R$ 35,00 Categoria Transporte Descricao Uber ate o escritorio Data 11/05/2026 ─────────────────────── Resumo do Mes Receitas R$ 5.000,00 Despesas R$ 1.230,00 Saldo R$ 3.770,00 Orcamento 41% utilizado 月度总结 Resumo Financeiro — Maio/2026