phoenixclaw-ledgerPassive financial tracking plugin for PhoenixClaw. Automatically detects expenses and income from conversations and payment screenshots. Use when: - User mentions money/spending (any language) - User shares payment screenshots (WeChat Pay, Alipay, etc.) - User asks about finances ("How much did I spend?", "My budget") - User wants expense reports ("Monthly summary", "Spending analysis")
Install via ClawdBot CLI:
clawdbot install goforu/phoenixclaw-ledgerPhoenixClaw Ledger automatically extracts financial transactions from your daily conversations and payment screenshots, requiring zero manual input.
| Feature | Description |
|---------|-------------|
| Semantic Expense Detection | AI identifies spending mentions in natural conversation |
| Screenshot Recognition | Extracts transaction data from payment app screenshots |
| Smart Categorization | Auto-categorizes based on merchant and context |
| Budget Tracking | Monthly budget alerts and progress visualization |
| Financial Insights | Pattern analysis integrated into journal Growth Notes |
| Goal Management | Savings, budget control, habit, and wishlist goals |
| Weekly Reports | Automated Sunday 9 PM spending recap |
| Query Support | Real-time natural language financial inquiries |
| Spending Trends | Multi-month analytical spending visualization |
| Transaction Browser | Interactive complete transaction history view |
As a PhoenixClaw plugin, Ledger hooks into the post-moment-analysis phase:
references/expense-detection.md)references/payment-screenshot.md)references/merchant-category-map.md~/PhoenixClaw/Finance/ledger.yamlassets/daily-finance-section.mdWhile passive by design, users can interact directly:
~/PhoenixClaw/
โโโ Journal/
โ โโโ daily/2026-02-02.md # Contains ๐ฐ Finance section
โ โโโ weekly/2026-W05.md # Weekly financial recaps
โ
โโโ Finance/ # Ledger-specific directory
โโโ ledger.yaml # Structured transaction data
โโโ budget.yaml # Budget configuration
โโโ goals.yaml # Financial goals tracking
โโโ transactions.md # Transaction browser view
โโโ monthly/
โ โโโ 2026-02.md # Monthly financial reports
โโโ yearly/
โโโ 2026.md # Annual summariesLedger-specific settings in ~/.phoenixclaw/config.yaml:
plugins:
phoenixclaw-ledger:
enabled: true
default_currency: CNY # or USD, EUR, etc.
budget_monthly: 5000 # Monthly budget amount
categories_custom: [] # User-defined categories
screenshot_confidence: 0.7 # Min confidence for auto-recordLedger uses PhoenixClaw Core's cron infrastructure plus additional scheduled tasks:
| Task | Schedule | Description |
|------|----------|-------------|
| Daily Processing | 10 PM (via Core) | Extracts transactions, generates daily section |
| Monthly Report | 1st of month, 8 AM | Comprehensive monthly financial summary |
| Weekly Summary | Sunday 9 PM (optional) | Weekly spending recap |
No separate setup required. Ledger hooks into Core's nightly cron:
post-moment-analysisopenclaw cron add \
--name "PhoenixClaw Ledger monthly report" \
--cron "0 8 1 * *" \
--tz "auto" \
--session isolated \
--message "Generate monthly financial report for the previous month."See references/cron-setup.md for full configuration details.
references/)expense-detection.md: Semantic patterns for conversation parsingpayment-screenshot.md: Screenshot recognition and OCR extractionmerchant-category-map.md: Merchant to category mapping rulescategory-rules.md: Category definitions and hierarchybudget-tracking.md: Budget alerts and progress calculationfinancial-insights.md: Pattern analysis for Growth Notescron-setup.md: Scheduled tasks and report automationgoal-management.md: Financial goals and progress trackingquery-patterns.md: Natural language query templates and logicassets/)expense-callout.md: Template for conversation-detected expensesreceipt-callout.md: Template for screenshot-detected expensesdaily-finance-section.md: Journal integration templatemonthly-report.md: Monthly summary templateyearly-report.md: Annual summary templateGenerated Mar 1, 2026
Freelancers often track income and expenses manually across multiple clients and payment methods. This plugin automatically captures transactions from conversations with clients and payment screenshots, categorizing them for easy tax reporting and budget monitoring without manual entry.
Small business owners handle daily operational expenses and income through chats and digital payments. The plugin extracts financial data from these sources, generates automated reports, and helps monitor budgets and spending trends to improve financial oversight and planning.
Students managing limited budgets can use this plugin to passively track spending from conversations about purchases and payment app screenshots. It provides insights into spending habits, sets savings goals, and offers weekly recaps to promote financial discipline and awareness.
Digital nomads frequently incur expenses in various currencies and through diverse payment platforms while traveling. The plugin detects transactions from global payment screenshots and travel-related chats, auto-categorizes them, and exports data for simplified accounting and expense reporting.
Offer basic financial tracking for free, with advanced features like detailed analytics, custom report generation, and priority support as paid upgrades. Revenue is generated through subscription tiers, targeting users who need enhanced insights beyond passive tracking.
Partner with financial advisors or platforms to provide aggregated transaction data and insights. Revenue comes from referral fees or commissions when users sign up for linked services, leveraging the plugin's data to offer personalized financial advice and products.
License the plugin technology to businesses for internal use, such as employee expense tracking or customer financial management tools. Revenue is generated through licensing fees and customization services, tailored to specific organizational needs and branding.
๐ฌ Integration Tip
Ensure the plugin is configured to hook into the post-moment-analysis phase correctly and set up scheduled tasks like monthly reports using the provided cron commands for automated operation.
Query Copilot Money personal finance data (accounts, transactions, net worth, holdings, asset allocation) and refresh bank connections. Use when the user asks about finances, account balances, recent transactions, net worth, investment allocation, or wants to sync/refresh bank data.
Stripe API integration with managed OAuth. Manage customers, subscriptions, invoices, products, prices, and payments. Use this skill when users want to process payments, manage billing, or handle subscriptions with Stripe. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway). Requires network access and valid Maton API key.
QuickBooks API integration with managed OAuth. Manage customers, invoices, payments, bills, and run financial reports. Use this skill when users want to interact with QuickBooks accounting data. For other third party apps, use the api-gateway skill (https://clawhub.ai/byungkyu/api-gateway).
Advanced financial calculator with future value tables, present value, discount calculations, markup pricing, and compound interest. Use when calculating investment growth, pricing strategies, loan values, discounts, or comparing financial scenarios across different rates and time periods. Includes both CLI and interactive web UI.
Track expenses via natural language, get spending summaries, set budgets
Query and manage personal finances via the official Actual Budget Node.js API. Use for budget queries, transaction imports/exports, account management, categorization, rules, schedules, and bank sync with self-hosted Actual Budget instances.