← 返回 Skills 市场
Finance Tracker
作者
Salen-Project
· GitHub ↗
· v2.0.0
2616
总下载
3
收藏
6
当前安装
3
版本数
在 OpenClaw 中安装
/install finance-tracker
功能描述
Track personal expenses with natural language. Log spending, view reports, search transactions. Works with any AI model.
使用说明 (SKILL.md)
Finance Tracker v2.0
Complete personal finance management. Track expenses, recurring subscriptions, savings goals, multi-currency support, and smart insights.
Installation
clawdhub install finance-tracker
Or add to PATH:
export PATH="$PATH:/path/to/finance-tracker/bin"
Quick Start
# Log an expense
finance add 50k "lunch at cafe"
# Log with currency conversion
finance add $20 "online purchase"
# See what you spent
finance report week
# Get smart insights
finance insights
Core Commands
Add Expenses
finance add \x3Camount> "\x3Cdescription>"
Amount formats:
50000— plain number50k— with k suffix (= 50,000)$50— USD, auto-converts to your currency€100— EUR100 USD— explicit currency
Examples:
finance add 50000 "lunch"
finance add 50k "groceries"
finance add $25 "Netflix subscription"
Undo & Edit
# Remove last transaction
finance undo
# Edit a transaction
finance edit \x3Cid> --amount=60000
finance edit \x3Cid> --desc="dinner with friends"
finance edit \x3Cid> --category=food
# Delete specific transaction
finance delete \x3Cid>
View & Search
finance report [period] # today, week, month, year, all
finance recent [n] # last n transactions
finance search "food" # search by keyword
🔄 Recurring Expenses
Track subscriptions and bills that repeat automatically.
Add Recurring
finance recurring add \x3Camount> "\x3Cdescription>" \x3Cfrequency> [--day=N]
Frequencies: daily, weekly, biweekly, monthly, quarterly, yearly
Examples:
finance recurring add 110k "mobile provider" monthly --day=1
finance recurring add 50k "Netflix" monthly
finance recurring add 200k "gym membership" monthly --day=15
Manage Recurring
finance recurring # List all
finance recurring list # Same as above
finance recurring due # Show what's due today
finance recurring process # Auto-log all due expenses
finance recurring remove \x3Cid> # Deactivate
How It Works
- Recurring expenses track their next due date
- Run
finance recurring processdaily (or in heartbeat) to auto-log - Each logged expense appears in your regular transactions
- Monthly totals shown in the recurring report
🎯 Savings Goals
Set targets and track progress towards financial goals.
Add Goals
finance goal add "\x3Cname>" \x3Ctarget> [--by=DATE] [--current=X]
Examples:
finance goal add "New Laptop" 5000000 --by=2026-06-01
finance goal add "Emergency Fund" 10000000
finance goal add "Vacation" 3000000 --by=2026-08-01 --current=500000
Track Progress
# Add to goal (increment)
finance goal update "Laptop" 500k
# Set exact amount
finance goal set "Laptop" 2000000
# View all goals
finance goal
finance goal list
Goal Features
- Deadline tracking — shows days remaining
- Daily/weekly/monthly targets — how much to save to hit deadline
- Priority levels — high, medium, low
- Completion tracking — celebrate when you hit targets!
💱 Multi-Currency
Automatic currency conversion with live exchange rates.
View Rates
finance rates # Show all common rates
finance rates USD # Specific currency rate
finance rates EUR
Convert
finance convert 100 USD UZS
finance convert 50 EUR USD
Auto-Conversion in Expenses
# These auto-convert to your default currency (UZS)
finance add $50 "Amazon purchase"
finance add €30 "App subscription"
finance add 100 USD "Online course"
Set Default Currency
finance currency # Show current
finance currency USD # Change default
Rate caching: Rates refresh every 6 hours automatically.
💡 Smart Insights
AI-powered spending analysis and alerts.
finance insights # Full insights report
finance summary # Quick daily summary
finance digest # Weekly digest
What Insights Shows
- Spending velocity — daily/weekly/monthly averages
- Period comparison — this week vs last week
- Category changes — which categories went up/down
- Anomaly detection — unusually large expenses flagged
- Goal progress — how much to save daily
- Recurring due — subscriptions due today
Example Output
💡 Smart Insights
━━━━━━━━━━━━━━━━━━━━━
📈 Spending Velocity
Daily avg: 85,000 UZS
This month so far: 1,200,000 UZS
Projected month total: 2,550,000 UZS
📊 This Week vs Last Week
📈 Spending UP 23%
This week: 595,000 UZS
Last week: 484,000 UZS
🏷️ Notable Category Changes
🍔 food: ↑ 45%
🚗 transport: ↓ 20%
⚠️ Alerts
• Unusually large expense: 350,000 on electronics
🎯 Savings Goals
Need to save: 50,000 UZS/day
Next deadline: Laptop in 45 days
Income & Assets
Log Income
finance income 5000000 "salary"
finance income 500k "freelance project"
Income types auto-detected: salary, freelance, business, investment, gift
Manage Assets
finance asset add "Bank Account" 10000000 cash
finance asset add "Stocks" 5000000 stocks
finance asset add "Bitcoin" 2000000 crypto
finance asset remove "Old Account"
finance asset list
finance portfolio # Net worth summary
Asset types: cash, stocks, crypto, realestate, savings, investments
Analysis
finance trends [days] # Spending patterns over time
finance compare [days] # Compare current vs previous period
finance budget \x3Cdaily> # Check against daily budget
Budget Check
finance budget 100k
Shows:
- Today's spending vs budget
- Week's spending vs weekly budget (7x daily)
- Remaining amounts
- Over-budget warnings
Categories
Auto-detected from description:
| Category | Keywords |
|---|---|
| 🍔 Food | lunch, dinner, cafe, restaurant, grocery |
| 🚗 Transport | taxi, uber, bus, metro, fuel |
| 🛍️ Shopping | clothes, shoes, shopping |
| 📱 Tech | phone, laptop, headphones |
| 🎮 Entertainment | movie, game, netflix, spotify |
| 📚 Education | book, course, school |
| 💊 Health | medicine, pharmacy, doctor, gym |
| 🏠 Home | rent, utility, furniture, internet |
| 💇 Personal | haircut, barber, salon |
| 🎁 Gifts | gift, present |
| ✈️ Travel | travel, flight, hotel |
| 🔄 Subscriptions | subscription, monthly, plan |
Data Storage
All data stored locally in ~/.finance-tracker/:
~/.finance-tracker/
├── transactions.json # All expenses
├── FINANCE_LOG.md # Human-readable log
├── portfolio.json # Assets
├── income.json # Income records
├── recurring.json # Recurring expenses
├── goals.json # Savings goals
└── exchange_rates.json # Cached rates
Export
finance export csv
finance export json
Telegram Integration
For quick logging in chat, common patterns:
"spent 50k lunch" → finance add 50000 "lunch"
"taxi 15k" → finance add 15000 "taxi"
"coffee 8k" → finance add 8000 "coffee"
Heartbeat Integration
Add to your HEARTBEAT.md for automated processing:
## Finance (daily)
- Run: finance recurring process
- Run: finance summary
Complete Command Reference
EXPENSES:
finance add \x3Camt> "\x3Cdesc>" Log expense
finance undo Remove last
finance edit \x3Cid> [--amount=X] Edit transaction
finance delete \x3Cid> Delete transaction
finance report [period] Spending report
finance recent [n] Recent transactions
finance search "\x3Cquery>" Search
RECURRING:
finance recurring List all
finance recurring add ... Add subscription
finance recurring remove \x3Cid> Remove
finance recurring process Log due items
finance recurring due Show due today
GOALS:
finance goal List goals
finance goal add "\x3Cname>" \x3Ctarget> [--by=DATE]
finance goal update "\x3Cname>" \x3Camt>
finance goal set "\x3Cname>" \x3Camt>
finance goal remove "\x3Cname>"
CURRENCY:
finance rates [currency] Exchange rates
finance convert \x3Camt> \x3Cfrom> \x3Cto>
finance currency [code] Get/set currency
INCOME & ASSETS:
finance income \x3Camt> "\x3Cdesc>"
finance asset add/remove/list
finance portfolio
ANALYSIS:
finance insights Smart analysis
finance summary Daily summary
finance digest Weekly digest
finance trends [days]
finance compare [days]
finance budget \x3Cdaily>
OTHER:
finance categories
finance export [csv|json]
finance help
Tips
- Use 'k' for thousands —
50kis faster than50000 - Currency prefix —
$50auto-converts - Daily recurring check — run
finance recurring processin heartbeat - Weekly insights — run
finance digestfor summaries - Goal tracking — update goals when you save money
- Budget alerts — run
finance budget 100kto stay on track
Made with 🦞 by Salen
安全使用建议
This package appears to be a normal local CLI expense tracker, but there are important gaps you should check before installing or giving it autonomous access: 1) Inspect bin/finance, lib/currency.py and lib/insights.py — these large files likely contain the CLI entrypoint and any networking/telemetry logic. Look for HTTP requests or remote endpoints, API keys, or telemetry. 2) Confirm how 'live exchange rates' are fetched and whether any API keys or third-party services are contacted; if an API key is required, the skill should declare it. 3) Verify what 'automatic sync' means and where data is synced — do not enable automatic remote sync without understanding the destination and privacy policy. 4) If you want to be cautious, run the CLI in a restricted environment (container or VM) first, or inspect the code and run static checks. 5) Backup or inspect ~/.finance-tracker before running to avoid accidental overwrites. If you can provide the contents of bin/finance, lib/currency.py, and lib/insights.py (or confirm they have no network calls), I can re-evaluate with higher confidence.
功能分析
Type: OpenClaw Skill
Name: finance-tracker
Version: 2.0.0
The OpenClaw skill 'finance-tracker' is a personal finance management tool. Its `SKILL.md` provides clear instructions for users to interact with the `finance` CLI, without any prompt injection attempts against the agent. The Python code in `bin/finance.py` and `lib/*.py` primarily handles local file I/O within the `~/.finance-tracker/` directory for data storage (`transactions.json`, `FINANCE_LOG.md`, etc.). The only network activity observed is in `lib/currency.py`, which fetches exchange rates from hardcoded, legitimate APIs (`open.er-api.com`, `api.exchangerate.host`) using `urllib.request.urlopen`. This network access is directly aligned with the stated multi-currency feature and does not show any signs of data exfiltration or malicious intent. No other high-risk behaviors like arbitrary command execution, persistence mechanisms, or obfuscation were found.
能力评估
Purpose & Capability
Name/description (personal expense tracker) lines up with code that parses expenses, stores transactions, reports, recurring items and goals. The code writes to ~/.finance-tracker which is appropriate for this purpose. However SKILL.md promises 'live exchange rates' and the storage module header promises 'automatic sync' — neither of which are justified by the declared requirements (no env vars, no API keys) and the shown storage implementation is purely local. That mismatch is worth investigating.
Instruction Scope
SKILL.md instructs only local CLI usage (add, report, recurring process). It asks users to run 'finance recurring process' daily or in a heartbeat. The instructions do not request reading unrelated system files or secrets. However they imply network activity (live exchange rates, cached every 6 hours) and automatic sync; the SKILL.md does not disclose what external endpoints are contacted or whether any data is uploaded, so the runtime scope is partially underspecified.
Install Mechanism
Registry metadata lists no install spec but the package contains code and a sizeable CLI bin script (bin/finance ~19 KB). There is no formal install script shown here (only a 'clawdhub install' suggestion and adding the bin to PATH). That inconsistency is notable: a packaged skill with executable code usually needs an install mechanism or dependency instructions; package.json references Python >=3.8 but SKILL.md does not enumerate dependencies to install. The lack of an explicit install mechanism or dependency steps increases risk because the CLI entrypoint (bin/finance) could perform network calls or run other actions when invoked or installed.
Credentials
The skill declares no required environment variables or credentials, which is reasonable for a purely local tracker. But features that imply external access (live exchange rates, 'automatic sync') normally require network endpoints or API keys—none are declared. This mismatch could mean the implementation uses unauthenticated public APIs, or that network/telemetry code is hidden in omitted files. Also package.json lists a GitHub homepage even though the catalog metadata shows none — minor inconsistency.
Persistence & Privilege
The skill does persistent storage under the user's home directory (~/.finance-tracker) and does not request elevated OS privileges or system-wide configuration changes. It is not always: true and does not declare forced installation. Writing to a dotfolder is expected for this type of tool.
如何使用
- 确保已安装 OpenClaw（本地或 Docker 部署）
- 在对话框中输入安装命令：
/install finance-tracker - 安装完成后，直接呼叫该 Skill 的名称或使用
/finance-tracker触发 - 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v2.0.0
finance-tracker 2.0.0
- Major new release with complete rewrite and expanded features.
- Added modules for multi-currency support, recurring expenses, savings goals, and smart spending insights.
- Introduced new commands: recurring, goal, currency/rates/convert, income, asset management, summary/insights, budget, and more.
- Improved transaction editing, undo, and advanced exporting.
- Unified command-line interface with easier parsing of currencies and amounts.
- Data structures expanded: additional JSON files for goals, assets, income, recurring, and exchange rates.
v1.0.1
- Added a YAML front matter section with name and description to the SKILL.md file.
- Updated the skill description to highlight features such as transaction search and AI model compatibility.
- No changes to commands, usage, or functionality.
- No changes to underlying code or logic.
v1.0.0
Initial release of Finance Tracker.
- Log expenses with natural language using simple commands.
- View reports for various periods: today, week, month, year, or all time.
- Supports auto-categorization of transactions based on keywords.
- Consistent, parseable output for success, reports, and errors.
- Local data storage in both machine-readable (JSON) and human-readable (Markdown) formats.
- Handy commands for adding, searching, exporting, and managing expenses.
元数据
常见问题
Finance Tracker 是什么？
Track personal expenses with natural language. Log spending, view reports, search transactions. Works with any AI model. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 2616 次。
如何安装 Finance Tracker？
在 OpenClaw 或 Claude Code 对话框中运行命令「/install finance-tracker」即可一键安装，无需额外配置。
Finance Tracker 是免费的吗？
是的，Finance Tracker 完全免费（开源免费），可自由下载、安装和使用。
Finance Tracker 支持哪些平台？
Finance Tracker 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。
谁开发了 Finance Tracker？
由 Salen-Project（@salen-project）开发并维护，当前版本 v2.0.0。
推荐 Skills