phoenixclaw-ledger
Passive financial tracking plugin for PhoenixClaw. Automatically detects expenses and income from conversations and payment screenshots. Use when: - User mentions money/spending (any language) - User
Passive financial tracking plugin for PhoenixClaw. Automatically detects expenses and income from conversations and payment screenshots. Use when: - User mentions money/spending (any language) - User
Real data. Real impact.
Growing
Developers
Per week
Open source
Skills give you superpowers. Install in 30 seconds.
PhoenixClaw 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 summaries
Ledger-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-record
Ledger 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 templateNo automatic installation available. Please visit the source repository for installation instructions.
View Installation Instructions1,500+ AI skills, agents & workflows. Install in 30 seconds. Part of the Torly.ai family.
© 2026 Torly.ai. All rights reserved.