Hledger

Execute hledger CLI commands to query balances, registers, reports, and journals, returning structured output from local ledger files.

hledger Skill for OpenClaw

The hledger skill allows OpenClaw agents to execute hledger CLI commands on the host system and return structured output to the user.

This skill acts as a thin wrapper around the installed hledger binary.

---

What This Skill Does

• Executes arbitrary hledger subcommands
• Returns stdout and stderr output
• Allows querying balances, registers, reports, and journal data
• Enables automation of personal finance workflows inside OpenClaw

---

Example Usage

Input to the skill:

balance

Result:

Displays account balances from the default journal file.

Input:

register Assets

Result:

Displays register entries for the Assets account.

Input:

balance -f myledger.journal

Result:

Runs hledger against a specific ledger file.

---

Requirements

• hledger must be installed and available in PATH
• The user must have read access to their ledger files

Test installation with:

hledger --version

---

Security Notes

This skill executes shell commands using the local hledger binary. It does not allow arbitrary shell execution — only hledger commands are prefixed and executed.

---

Intended Use

• Personal finance automation
• Ledger querying via chat
• Integration with Telegram or WhatsApp bots powered by OpenClaw
• Financial reporting pipelines

---

Version

1.0.0