Expense Tracker
Log expenses in natural language (English or Chinese), track budgets, and get monthly reports — all stored locally, no API key needed.
# Expense Tracker Log expenses in natural language (English or Chinese), track budgets, and get monthly reports — all stored locally, no API key needed. Expense Tracker lets you record and review personal spending by simply telling your AI assistant what you spent. It understands natural language in both English and Chinese — say "lunch $15", "午饭花了45块", or "how much did I spend this week?" and it handles the rest. All data is stored locally on your machine with no external services required. ## How It Works On every invocation, the skill checks your local expense directory, loads your configuration and budget settings, and routes your message to the correct flow — logging, querying, budgeting, or reporting. Expenses are saved as monthly JSON files under ~/.openclaw/workspace/expenses/ , and a delivery-state tracker ensures scheduled reports and budget alerts are never silently missed. ## Key Features - **Natural Language Logging**: Log expenses in English or Chinese without any special syntax; amounts, currencies, dates, and categories are parsed automatically. - **Auto-Categorization**: Expenses are automatically sorted into categories like 🍔 Food, 🚗 Transport, 🛍 Shopping, 🏠 Bills, 🏥 Health, and more based on keywords. - **Budget Tracking**: Set monthly budgets per category or overall; receive warnings at 80% usage and alerts when you go over. - **Spending Summaries**: Query spending by day, week, month, or custom range with category breakdowns, daily averages, and period-over-period comparisons. - **Monthly Reports**: Comprehensive reports with top expenses, category trends, and actionable insights comparing the current month to the previous one. - **Bilingual Support**: Fully supports English and Chinese input and output; responses mirror the language you use. - **Local-Only Storage**: All expense data stays on your machine under ~/.openclaw/workspace/expenses/ ; nothing is sent to external services. - **Delivery Health Checks**: Tracks scheduled push deliveries and alerts you if monthly reports or budget alerts have been missed two or more consecutive times. ## Requirements - **No API key**: this skill requires no external credentials or accounts. - **Local filesystem access**: the skill reads and writes to ~/.openclaw/workspace/expenses/ . - **No additional binaries**: no extra system dependencies are needed. ## Use Cases - **Daily expense logging**: Quickly record meals, transport, and purchases without opening a separate app. - **Budget management**: Set monthly limits per category and get proactive alerts before you overspend. - **Monthly financial review**: Automatically generate a full breakdown of last month's spending with trends and top expenses. - **Bilingual households or travelers**: Seamlessly switch between English and Chinese input when logging expenses in different contexts. - **Offline-first tracking**: Keep a complete spending history with no cloud dependency or subscription. ## Installation Install via: `npx clawhub@latest install expense-tracker`
Instalación
Ejecutar en tu terminal
npx clawhub@latest install expense-trackerHaz clic en el botón Instalar en la parte superior de esta página para una configuración con un solo clic