# 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.

- Skill: `modbender/hledger-skill-for-openclaw` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add modbender/hledger-skill-for-openclaw`
- Raw SKILL.md: https://api.skillmd.com/api/skills/modbender/hledger-skill-for-openclaw/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: modbender (https://skillmd.com/u/modbender)
- Updated: 2026-09-09
- Page: https://skillmd.com/skills/modbender/hledger-skill-for-openclaw

---


# 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