phoenixclaw-ledger

What This Skill Does

PhoenixClaw Ledger transforms your unstructured financial life into a zero-effort, automated tracking system. By integrating directly into your daily digital interactions, it acts as a passive financial assistant that monitors your spending and income without requiring manual data entry. It processes natural language conversations to detect when money is mentioned and utilizes computer vision to parse official payment screenshots from platforms like WeChat Pay and Alipay. Once detected, the skill categorizes transactions, updates your budget in real-time, and generates structured reports stored within your PhoenixClaw workspace. It ensures that every penny is accounted for, providing you with a clear, visual, and analytical view of your financial health, goal progress, and spending habits through intuitive journal integration.

Installation

To integrate the Ledger skill into your environment, use the command-line interface within PhoenixClaw. Execute the following command in your terminal: clawhub install openclaw/skills/skills/goforu/phoenixclaw-ledger Ensure that your PhoenixClaw core version is up-to-date to support the post-moment-analysis hooks required for passive detection. After installation, verify your configuration in ~/.phoenixclaw/config.yaml to enable specific privacy and categorization settings.

Use Cases

This skill is perfect for individuals looking to cultivate better financial habits without the burden of manual bookkeeping. It is ideal for:

• Automated Expense Tracking: Capturing spending while on the go via simple chat messages.
• Receipt Management: Automatically digitizing payment confirmation screenshots.
• Budget Monitoring: Getting proactive alerts when you approach your monthly spending limits.
• Goal Setting: Managing long-term savings goals and visualizing the path to achieving them.
• Financial Reporting: Reviewing weekly and monthly summaries to optimize discretionary spending.

Example Prompts

1. "I just spent $45 on groceries at Whole Foods, please add that to my ledger."
2. "How much of my monthly budget do I have left for dining out?"
3. "Generate a spending analysis for this month and show me where I can save more."

Tips & Limitations

To maximize the utility of the Ledger, ensure that your payment screenshots contain clear transaction details, including the merchant name, date, and amount. While the AI is highly accurate, it is good practice to review the ledger.yaml file periodically for any anomalies. Note that the skill thrives on consistency; the more you talk about your finances, the better the AI becomes at understanding your unique spending patterns. Limitations include reliance on standardized payment UI formats; heavily customized or non-standard receipts may occasionally require manual correction. Ensure your file system permissions allow PhoenixClaw write access to the ~/PhoenixClaw/Finance/ directory for seamless data persistence.