klutch

💳 可编程信用卡智能财务管家

基于Klutch官方API的个人开源工具,提供信用卡管理、自动支出分析与预算管控,支持1Password安全凭证与细粒度权限控制。

收藏
3.5k
安装
1.1k
版本
v0.3.0
CLS 安全性认证2026-05-01
点击查看完整报告 >

使用说明

Klutch Skill 是一款面向 Klutch 可编程信用卡的 OpenClaw 集成工具,通过 GraphQL API 提供命令行式的账户管理能力。用户可通过 klutch balance 查看卡片状态,使用 klutch transactions 获取交易记录并支持时间范围筛选,或利用 klutch card spending 分析各类别支出占比。该工具采用 session token 认证机制,首次配置后自动缓存凭证至 ~/.config/klutch/token.json,并支持 1Password CLI 集成实现无硬编码的安全凭证注入,避免敏感信息泄露风险。

该 Skill 的显著优势在于其严苛的安全规范与自动化潜力。代码通过 BSS A 级认证,无 eval()/exec() 等危险函数,依赖仅包含 requestsclick 两个主流库且版本锁定;Token 文件默认设置 600 权限(仅所有者可读写),配置文件操作均使用 pathlib 确保路径安全。功能层面,它支持为 AI 子代理创建虚拟信用卡并设置硬限额(如 AWS、OpenAI 开销),实现自动预算告警与异常交易监控,将个人财务管理延伸至自动化代理场景。

局限性方面,该 Skill 来源为 T3 级个人开发者(kesslerio),非 Klutch 官方或企业级维护项目,存在长期维护与信任风险;功能强绑定 Klutch 平台,无法兼容其他信用卡体系;且需要 Python 3.10+ 环境,对旧系统支持有限。此外,尽管 Token 文件权限严格,但凭证仍存储于本地磁盘,在多用户共享环境或未经加密的主目录中仍存在潜在暴露风险。

该工具最适合 Klutch 信用卡持有者、需要自动化追踪支出的开发者,以及希望为 AI 代理设置预算护栏的技术用户。对于重视财务数据隐私、具备基础 CLI 操作能力,且已使用 1Password 等密码管理器的个人用户而言,这是理想的轻量级财务管理方案。

使用过程中需关注以下风险:首先,T3 来源意味着代码未经大型企业安全审计,建议审查后再用于生产环境;其次,虽然 Skill 本身无静默上传行为,但依赖的 Klutch API 为第三方服务,需信任其数据隐私政策;最后,自动模式(autonomous)默认关闭,若启用需严格设置预算上限,避免代理循环消费导致资金损失。建议定期清理 ~/.config/klutch/ 目录,并在共享设备上禁用 Token 缓存。

安全解读

核心功能

Klutch Skill 是一款面向 OpenClaw 平台的信用卡 API 集成工具,通过与 Klutch GraphQL API 对接,提供完整的命令行财务管理能力。核心功能包括:实时查询卡片余额与状态、获取交易历史(支持时间范围筛选)、按类别分析消费模式、以及配置化管理。

显著优点

安全设计规范:采用环境变量与 1Password CLI 双轨凭证注入机制,敏感信息不硬编码;Token 缓存文件设置 600 权限,符合最小权限原则。HTTPS 强制加密通信,TLS 1.2+ 保障传输安全。

架构清晰简洁:342 行代码实现完整功能,仅依赖 requests 和 click 两个成熟库,无已知 CVE 漏洞,供应链攻击面极小。

自动化体验:支持会话 Token 自动刷新、配置持久化、以及子代理预算隔离等场景,适合 AI Agent 自主财务管理。

潜在局限

生态绑定:仅支持 Klutch 单一家信用卡服务商,无法跨平台整合其他银行账户。

功能边界:缺乏交易修改、转账支付等写入操作,目前以只读查询为主;预算告警需外部系统配合实现。

部署依赖:需要用户预配置 API 凭证或 1Password CLI,对非技术用户有一定门槛。

适合人群

  • 已持有 Klutch 信用卡的技术用户
  • 需要为 AI Agent 设置消费预算上限的开发者
  • 希望自动化个人记账与消费分析的效率工具爱好者

常规风险

网络层仅与 Klutch 官方 API 通信,无数据外泄;凭证管理已通过安全审计。主要风险在于 API 密钥的本地保管——若设备被入侵,攻击者可读取环境变量或 Token 缓存文件。建议配合系统级全盘加密与密钥管理工具使用。

klutch 内容

config文件夹
scripts文件夹
手动下载zip · 9.2 kB
klutch.example.jsonapplication/json
请选择文件