A sophisticated personal accountant skill that interfaces with the fscl CLI to manage Actual Budget environments through natural language.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install fiscal
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 fiscal 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 Fiscal Personal Accountant?
The Fiscal skill empowers your AI agent to act as a professional accountant by leveraging the fscl binary, a headless command line interface for Actual Budget. This integration allows users to handle complex budgeting tasks—including bank imports, transaction categorization, and rule automation—without ever needing to touch a CLI or learn the underlying software architecture. As part of the wider ecosystem of Openclaw Skills, it prioritizes privacy and local control while providing the convenience of an automated financial advisor.
By translating plain language intent into precise technical commands, the skill handles the heavy lifting of financial data management. It automatically converts raw integers into currency formats, manages UUIDs behind the scenes, and ensures data integrity through a robust draft-and-apply workflow. Whether you are self-hosting your financial data or using a remote server, this skill provides a bridge between conversation and rigorous financial accounting.
Fiscal Personal Accountant Use Cases
- Setting up a new local budget or connecting to an existing Actual Budget server instance.
- Importing and reconciling bank transactions from CSV or bank exports.
- Automating spending categories using custom rules to reduce manual overhead.
- Performing monthly budget audits to ensure account balances match real-world statements.
- Generating human-readable summaries of spending habits and budget health.
How Fiscal Personal Accountant Works
- The skill begins by executing
fscl status --jsonto determine the current state of the budget and connection. - Based on the status metrics (uncategorized transactions, unreconciled counts), it selects an appropriate workflow: Onboarding, Optimization, or Maintenance.
- User requests are translated into specific fscl commands, always utilizing the
--jsonflag for precise data parsing. - For write operations, the skill follows a 'Draft Pattern' where it generates a draft file, modifies it according to user needs, and then applies the changes.
- Financial data is normalized, converting cents from the CLI into readable dollar amounts and hiding complex UUIDs in favor of human-readable account names.
Fiscal Personal Accountant Setup
To begin using this skill within the Openclaw Skills framework, ensure the fscl binary is installed and accessible in your environment. Follow these steps to initialize:
# Initialize a new budget or connect to an existing one
fscl init
# If a server is configured, log in to sync your data
fscl login [server-url] --password <your-password>
# Verify the setup status
fscl status --json
Fiscal Personal Accountant Data Schema & Taxonomy
The skill organizes financial data using a structured taxonomy to ensure consistency across the Actual Budget database:
| Entity | Data Type | Description |
|---|---|---|
| Accounts | Object | Includes institution name, account type (e.g., checking, credit), and last 4 digits. |
| Categories | Entity | Financial buckets belonging to specific Category Groups; nesting is not supported. |
| Amounts | Integer | Stored as cents (e.g., -4599) and rendered as currency (-$45.99). |
| Dates | String | Formatted strictly as YYYY-MM-DD for transactions and YYYY-MM for budgets. |
| Drafts | JSON File | Temporary files created in the drafts/ directory for categories, rules, and edits. |
Fiscal Personal Accountant Advanced Features
- Draft-Apply Workflow: Prevents accidental data corruption by requiring a staging step for all major budget changes.
- AQL Query Library: Supports pre-built Actual Query Language scripts for advanced financial reporting and spending analysis.
- Automated Triage: Proactively identifies high ratios of uncategorized transactions to suggest optimization workflows.
- Headless Synchronization: Automatically syncs local changes to remote Actual Budget servers when a connection is active.
- Rules Engine: Advanced JSON schema support for creating complex conditional logic to automate transaction tagging.
SKILL.md
Loading
Related Openclaw Skills
Design Style Skill
A powerful design system integrator that enables AI agents to generate production-grade, aesthetically distinct frontend interfaces instead of generic UI.
Bilibili Downloader
A high-performance media extraction tool for Bilibili that supports 8K video downloads, audio extraction, and metadata retrieval.
AKShare Finance
A comprehensive financial data interface library providing a unified wrapper for stocks, futures, crypto, and macroeconomic indicators.
Vestige Memory Skill
A sophisticated local cognitive memory system that utilizes FSRS-6 spaced repetition to provide AI agents with persistent, human-like recall capabilities.
Lead Radar
Lead Radar is an automated lead generation agent that monitors social platforms for buying intent and delivers qualified prospects directly to Telegram.
Azure OpenAI Proxy
A lightweight Node.js proxy that enables seamless integration between Azure OpenAI and OpenClaw by resolving API versioning and URL path conflicts.
METADATA
Featured*
