← 返回 Skills 市场
aholake

Expense Tracker

作者 Loc Vo · GitHub ↗ · v1.1.0
cross-platform ⚠ suspicious
939
总下载
0
收藏
9
当前安装
2
版本数
在 OpenClaw 中安装
/install expense-tracker
功能描述
Track daily expenses in structured markdown files organized by month. Use when the user wants to log spending, view expense summaries, analyze spending patte...
使用说明 (SKILL.md)

Expense Tracker

Log and track daily expenses in markdown files organized by month.

Quick Start

Log an expense

python3 scripts/log_expense.py log \x3Camount> \x3Ccategory> [--description "text"] [--tags "tag1,tag2"] [--date YYYY-MM-DD]

Examples:

# Simple expense
python3 scripts/log_expense.py log 45000 Coffee

# With description
python3 scripts/log_expense.py log 250000 Dining --description "Lunch with team"

# With tags
python3 scripts/log_expense.py log 500000 Shopping --tags "clothes,sale" --description "New shirt"

# Specify date (for backdating)
python3 scripts/log_expense.py log 1200000 Vehicle --description "Gas" --date 2026-02-15

View monthly summary

# Current month
python3 scripts/log_expense.py summary

# Specific month
python3 scripts/log_expense.py summary 2026-02

# JSON output (for parsing)
python3 scripts/log_expense.py summary 2026-02 --json

File Organization

Expenses are stored in expenses/ directory at workspace root:

expenses/
├── 2026-01.md
├── 2026-02.md
└── 2026-03.md

Each file contains a markdown table:

# Expenses - 2026-02

| Date | Category | Amount (VND) | Description | Tags |
|------|----------|-------------|-------------|------|
| 2026-02-17 | Coffee | 45,000 | | |
| 2026-02-17 | Dining | 250,000 | Lunch with team | |
| 2026-02-17 | Shopping | 500,000 | New shirt | clothes,sale |

Categories

See references/categories.md for common expense categories. Use existing categories or create custom ones as needed.

Common categories:

  • Housing - Rent, utilities, home expenses
  • Vehicle - Gas, maintenance, parking
  • Dining - Restaurants, food delivery
  • Coffee - Cafes, coffee shops
  • Shopping - Clothes, electronics, general purchases
  • Entertainment - Movies, games, hobbies
  • Healthcare - Medicine, doctor visits
  • Subscriptions - Netflix, Spotify, gym, apps
  • Savings - Investments, emergency fund
  • Debt Payment - Loans, credit cards
  • Miscellaneous - Other expenses

Workflow Examples

Log daily expenses from conversation

When the user mentions spending money:

# User: "Just paid 35k for coffee"
python3 scripts/log_expense.py log 35000 Coffee

# User: "Grabbed lunch for 120k at Phở 24"
python3 scripts/log_expense.py log 120000 Dining --description "Phở 24"

# User: "Filled up gas, 400k"
python3 scripts/log_expense.py log 400000 Vehicle --description "Gas"

Monthly review

# Get summary
python3 scripts/log_expense.py summary 2026-02

# Read the expense file to see details
cat expenses/2026-02.md

Analyze spending patterns

# Get JSON for analysis
python3 scripts/log_expense.py summary 2026-02 --json

# Compare multiple months
python3 scripts/log_expense.py summary 2026-01 --json > jan.json
python3 scripts/log_expense.py summary 2026-02 --json > feb.json

Auto Backup

Before every write, the script automatically backs up the current expense file to:

~/Documents/expenses_backup/YYYY-MM.md
  • Backup runs before any modification (safe even if write fails)
  • If the file doesn't exist yet (first entry of the month), backup is skipped
  • Backup is overwritten each time with the latest pre-write snapshot
  • This protects against accidental rm -rf or corruption of the workspace

Tips

  • Batch logging: User can tell you multiple expenses at once, log them all
  • Category consistency: Use the same category names to enable accurate summaries
  • Tags for filtering: Use tags for subcategories (e.g., "work", "weekend", "urgent")
  • Descriptions: Add context that helps identify the expense later
  • Regular reviews: Suggest monthly summaries to track spending patterns

Integration with Financial Goals

When tracking expenses, consider:

  1. Budget tracking: Compare monthly totals to target budget
  2. Spending patterns: Identify high-spend categories
  3. Emergency fund: Track savings progress
  4. Debt reduction: Monitor debt payment progress
  5. Financial ratios: Calculate expenses as % of income

Script Reference

log_expense.py

Commands:

  • log - Add an expense entry
  • summary - View monthly summary

Arguments (log):

  • amount - Amount in VND (required)
  • category - Category name (required)
  • --description/-d - Optional description
  • --tags/-t - Optional comma-separated tags
  • --date - Optional date (YYYY-MM-DD, defaults to today)
  • --workspace - Optional workspace path (defaults to ~/.openclaw/workspace)

Arguments (summary):

  • year_month - Optional YYYY-MM (defaults to current month)
  • --json - Output as JSON
  • --workspace - Optional workspace path

Output:

  • Creates/updates markdown files in expenses/ directory
  • Prints confirmation with file location
  • Summary shows total, count, and breakdown by category
安全使用建议
This skill appears coherent and local-only. Before installing or running it: (1) review the script yourself (it’s short and included) to confirm its behavior; (2) be aware it will create/append files under the workspace (default ~/.openclaw/workspace/expenses) and will copy the pre-write file to ~/Documents/expenses_backup/, overwriting the previous snapshot for the month; (3) if you prefer a different workspace, use the --workspace option; (4) run it in a sandbox or test workspace if you want to verify behavior before using real financial data. No network or secret exfiltration was detected.
功能分析
Type: OpenClaw Skill Name: expense-tracker Version: 1.1.0 The `scripts/log_expense.py` skill is classified as suspicious due to two main reasons: 1) It explicitly writes backup files to `~/Documents/expenses_backup/`, which is outside the default OpenClaw workspace. While documented as a benign backup feature in `SKILL.md`, it represents an external file write capability. 2) The script accepts a `--workspace` argument that allows specifying an arbitrary path for storing expense files. If this argument were controlled by a malicious actor or a prompt-injected agent, it could lead to arbitrary file writes, posing a significant vulnerability (e.g., writing to sensitive system locations). There is no clear evidence of intentional malicious behavior, but these capabilities present a risk of abuse.
能力评估
✓ Purpose & Capability
Name/description match the shipped assets: SKILL.md and a Python script that logs expenses to markdown files and produces summaries. No extraneous credentials, binaries, or services are required.
✓ Instruction Scope
Runtime instructions only call the included script with well-scoped commands (log, summary). The SKILL.md does not instruct the agent to read unrelated system state or transmit data externally. It does instruct the user/agent to read the generated markdown files.
✓ Install Mechanism
No install spec is provided (instruction-only with an included script). Nothing is downloaded or written beyond the described files at runtime.
✓ Credentials
No environment variables, credentials, or config paths are requested. The script uses only local filesystem paths (workspace default: ~/.openclaw/workspace) and a backup directory under ~/Documents, which are reasonable for the task.
✓ Persistence & Privilege
Skill is not always-enabled and does not modify other skills or global agent settings. It writes only to its own workspace and a user Documents backup folder; no elevated privileges are requested.
如何使用
  1. 确保已安装 OpenClaw（本地或 Docker 部署）
  2. 在对话框中输入安装命令：/install expense-tracker
  3. 安装完成后，直接呼叫该 Skill 的名称或使用 /expense-tracker 触发
  4. 根据 Skill 的参数说明提供必要输入，即可获得结构化输出
版本历史
v1.1.0
Add auto backup to ~/Documents/expenses_backup before each write to prevent data loss
v1.0.0
Initial release: Daily expense tracking with categories, tags, and monthly summaries
元数据
Slug expense-tracker
版本 1.1.0
许可证 —
累计安装 9
当前安装数 9
历史版本数 2
常见问题

Expense Tracker 是什么？

Track daily expenses in structured markdown files organized by month. Use when the user wants to log spending, view expense summaries, analyze spending patte... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 939 次。

如何安装 Expense Tracker？

在 OpenClaw 或 Claude Code 对话框中运行命令「/install expense-tracker」即可一键安装，无需额外配置。

Expense Tracker 是免费的吗？

是的，Expense Tracker 完全免费（开源免费），可自由下载、安装和使用。

Expense Tracker 支持哪些平台？

Expense Tracker 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 Expense Tracker？

由 Loc Vo（@aholake）开发并维护，当前版本 v1.1.0。

推荐 Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 留言讨论