SimpleFIN 银行连接技能

概述

simplefin 技能允许你连接用户的银行账户，通过 SimpleFIN Bridge API 获取账户余额与交易历史。

配置与认证（请务必首先完成此步骤！）

在获取任何数据之前，你必须先获得用户的 SimpleFIN Access URL。

1. 检查是否已存在： 在工作区中查找 memory/simplefin_url.txt 文件，或在环境变量中查找（例如，在 openclaw.json 中的 SIMPLEFIN_ACCESS_URL 字段）。
2. 如缺失则提示用户提供： 若未找到 Access URL，你 必须 向用户索取一个 Setup Token。
   • 提供给用户的说明： “为开始使用，我需要一个 SimpleFIN Setup Token。 如果你尚未获取，请按以下步骤操作：
     1. 访问 SimpleFIN Bridge 并注册账号。
     2. 添加并连接你的银行账户。
     3. 生成一个 Setup Token（一长串字符）。 请将该 Setup Token 粘贴至此，以便我完成连接！”
3. 兑换 Token： 用户提供 Setup Token 后，使用脚本进行兑换以获取 Access URL：

   node scripts/simplefin_api.js claim "THE_SETUP_TOKEN_HERE"
   

   该脚本将输出真实的 Access URL（格式为 https://username:password@...）。
4. 保存 Access URL： 将 Access URL 保存至 memory/simplefin_url.txt，避免用户后续重复提供。 Setup Token 为一次性使用，不可重复使用。

获取数据

使用提供的 Node.js 脚本 scripts/simplefin_api.js 与 API 进行交互。该脚本要求将 access_url 作为第一个参数传入。

1. 列出账户及余额

查看所有已连接的银行账户及其当前余额：

node scripts/simplefin_api.js "https://username:password@beta-bridge.simplefin.org/simplefin" accounts

该命令将输出一个 JSON 格式的账户数组，包含各账户的 ID、名称、币种及余额信息。

2. 列出交易记录

跨账户获取交易历史记录：

node scripts/simplefin_api.js "https://username:password@beta-bridge.simplefin.org/simplefin" transactions [options]

可选参数：

• --start-date YYYY-MM-DD：筛选该日期及之后发生的交易。
• --end-date YYYY-MM-DD：筛选该日期及之前发生的交易。
• --account "Account Name or ID"：仅筛选指定账户（名称或 ID）的交易。

示例：获取 2026 年 3 月的全部交易

node scripts/simplefin_api.js "https://username:password@beta-bridge.simplefin.org/simplefin" transactions --start-date 2026-03-01 --end-date 2026-03-31

输出结果处理

• 始终以清晰易读的方式向用户呈现财务数据（例如使用 Markdown 表格或项目符号列表）。
• 若 API 返回认证错误，请提醒用户其 SimpleFIN Token 可能已过期或被撤销，并请其重新生成新的 Setup Token。

参考资料

如需修改 SimpleFIN 集成逻辑、查阅错误定义或了解 API 限制，请参考开发者指南：

• 详见 developer_guide.md，其中包含 SimpleFIN Setup Token 流程说明与 API 文档。