Finance Skill

What This Skill Does

The Finance Skill, developed by safaiyeh, acts as a personal finance memory layer for your OpenClaw agent. It is designed to ingest, organize, and analyze your financial statements and individual spending habits. By maintaining a structured JSON-based transaction log in your local workspace, the skill allows the agent to recall, categorize, and summarize your spending history without relying on third-party cloud aggregators. It supports parsing raw PDF statements via pypdf and manual input entries, ensuring that your financial data remains under your local control within the ~/.openclaw/workspace/finance/ directory.

Installation

To install this skill, use the OpenClaw command-line interface. Ensure you have jq and pypdf installed on your system to handle the backend data processing.

1. Install via terminal: clawhub install openclaw/skills/skills/safaiyeh/finance-skill
2. Verify system dependencies: pip3 install pypdf and brew install jq (or apt install jq for Linux).
3. The skill will automatically initialize the necessary folders in your ~/.openclaw/workspace/ location upon first usage.

Use Cases

This skill is perfect for users who want to track personal cash flow without privacy concerns. It is highly effective for reconciling monthly credit card statements, identifying recurring subscription "bills," monitoring food and dining habits, and generating quick summaries of travel-related expenses. By using consistent categories like 'food', 'transport', and 'shopping', you gain clear visibility into your financial trends over time.

Example Prompts

1. "I just uploaded my January statement, can you extract the transactions and calculate the total food expenses?"
2. "How much did I spend on transport last month compared to this month?"
3. "I just spent $45.00 at a bookstore, please add that to my shopping category."

Tips & Limitations

• Data Integrity: Always verify the transaction sum after extraction. Since PDF formats vary, always use the recommended pypdf extraction method to prevent truncation of pages.
• Storage: Sensitive data is kept locally; ensure your machine is encrypted to maintain security.
• Categories: Stick to the predefined categories to ensure aggregate queries remain accurate. If you need custom categories, you may need to extend the underlying script logic in the workspace folder.