A personal finance memory layer that enables AI agents to parse statements, store transaction history, and perform spending analysis.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install finance-skill
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install finance-skill using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Finance Skill?
The Finance Skill acts as a persistent memory layer for your AI agent, allowing it to handle personal finance tasks with precision. It bridges the gap between raw financial documents and actionable insights by providing tools to parse PDF or image statements and organize them into a structured JSON database.
This skill ensures your agent can remember past spending, recognize patterns, and help you stay on budget without manual data entry. By utilizing Openclaw Skills for financial management, developers can build agents that offer high-utility personal accounting services directly within a conversational interface.
Finance Skill Use Cases
- Uploading credit card or bank statements to automatically log transactions.
- Querying spending history for specific categories like food, transport, or bills.
- Calculating total expenditures for a specific month or date range.
- Adding manual one-off transactions through natural language commands.
- Verifying statement totals against extracted data to ensure accounting accuracy.
How Finance Skill Works
- The user shares a financial statement (PDF or image) with the agent.
- The agent utilizes pypdf to extract full text from the document, bypassing preview limitations found in many messaging platforms.
- Extracted data is transformed into a structured JSON format containing merchant names, amounts, and categories.
- The agent verifies the sum of expenses against the statement total to ensure data integrity before saving.
- Transactions are appended to a persistent local store located in the standard Openclaw Skills workspace directory.
- Users can then query the agent using natural language to filter, aggregate, and visualize their financial data using jq.
Finance Skill Setup
To enable the full capabilities of this skill, install the necessary dependencies for PDF parsing and JSON manipulation:
pip3 install pypdf
# For Linux users
sudo apt install jq
# For macOS users
brew install jq
Ensure the workspace directory exists for persistent storage:
mkdir -p ~/.openclaw/workspace/finance/statements/
Finance Skill Data Schema & Taxonomy
Transactions are organized within ~/.openclaw/workspace/finance/transactions.json. The schema is designed for easy querying and integration with other Openclaw Skills.
| Field | Type | Description |
|---|---|---|
| id | UUID | Unique identifier for the transaction |
| date | String | Transaction date in YYYY-MM-DD format |
| merchant | String | Name of the vendor or service provider |
| amount | Float | Negative value for expenses, positive for income/refunds |
| category | String | Classification (e.g., food, transport, shopping, bills) |
| source | String | The filename of the original source statement |
| added | ISO8601 | Timestamp of when the record was created |
Finance Skill Advanced Features
- Full multi-page PDF extraction support to prevent data loss from truncated platform previews.
- Automatic category classification for common merchants like restaurants, utilities, and transport services.
- Persistent session-memory integration for long-term financial trend analysis over months or years.
- Local JSON storage allows for easy export or integration with other data-focused Openclaw Skills.
- Manual transaction overrides for tracking cash purchases and offline expenses.
SKILL.md
Loading
Related Openclaw Skills
Equity Analyst
A professional-grade AI agent skill for analyzing Korean stocks using a rigorous financial-first evaluation framework.
Equity Analyst
A professional AI investment analyst that provides systematic evaluation and scoring for Korean stocks listed on the KRX.
Obsidian Markdown
A specialized skill for generating and modifying Obsidian Flavored Markdown, enabling advanced features like wikilinks, callouts, and frontmatter properties.
Obsidian CLI Tool
A robust command-line interface for interacting with Obsidian vaults, managing notes, and streamlining plugin development.
Knowledge Graph
Maintain a deterministic, file-based knowledge graph by adding, superseding, and summarizing atomic facts for entities.
Project Router
A terminal-first project bootstrapper and workspace context manager that synchronizes local task management with Trello.
METADATA
Featured*
