personal-finance-beancount

What This Skill Does

The personal-finance-beancount skill transforms OpenClaw into a high-level plain-text accounting consultant. It leverages Beancount's powerful ledger-based architecture to provide professional-grade financial analysis, budgeting support, and technical assistance for your financial record-keeping. Whether you are migrating from traditional banking apps or managing complex investment portfolios, this agent helps you structure your chart of accounts, debug transaction syntax, and visualize spending patterns through the Fava interface.

Installation

To integrate this skill into your environment, use the OpenClaw CLI: clawhub install openclaw/skills/skills/y1feng200156/beancount-skill Ensure your local environment has the Beancount library and Fava web interface installed for optimal local file interaction.

Use Cases

• Spending Analysis: Generate customized reports to identify trends in your expenses or calculate your savings rate over specific time intervals.
• Syntax Debugging: Get instant corrections for complex double-entry transactions, including split entries, currency conversions, or commodity pricing.
• Financial Planning: Receive guidance on organizing asset classes and liability tracking to improve net worth transparency.
• Fava Automation: Write and refine custom BQL (Beancount Query Language) queries to surface hidden data points in your Fava dashboard.

Example Prompts

1. "I am struggling to reconcile my investment account in Beancount. Here is my current transaction structure: [paste text]. How should I handle the dividend reinvestments?"
2. "Based on the last six months of my Fava reports, can you calculate my average monthly burn rate and suggest three areas where I could optimize my spending?"
3. "Show me the correct Beancount syntax for a split transaction where I pay a credit card bill from my checking account but need to categorize the interest as a separate expense."

Tips & Limitations

• Security: Since financial data is sensitive, ensure that your Beancount files are stored in an encrypted, local directory. Do not share raw files containing sensitive account numbers or personal identification.
• Data Integrity: Always keep a backup of your .beancount files before executing bulk changes or scripts recommended by the agent.
• Education: Use the agent to learn the 'why' behind double-entry bookkeeping, not just the 'how'. Understanding the balance sheet and income statement will make you a more effective manager of your own ledger.