Ledger Project Expense Entry for Openclaw

A streamlined utility for converting natural language messages into structured financial ledger entries for project tracking.

shing19
v1.0.0
Mar 31, 2026
0
644
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install ledger-project-expense-entry

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install ledger-project-expense-entry 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 Ledger Project Expense Entry?

The Ledger Project Expense Entry skill is a specialized tool designed for the Openclaw Skills ecosystem to simplify financial record-keeping. It allows developers and project managers to log expenses or income by simply sending short, natural-language messages like "OpenClaw server 89". The skill intelligently parses these inputs to extract project names, descriptions, and amounts while defaulting to standard project settings.

By integrating this skill, users can maintain a precise JSONL-based ledger without manual data entry friction. It ensures data consistency by cross-referencing an existing category catalog and automatically handling timezone-aware date stamping, making it an essential component of a robust Openclaw Skills financial workflow.

Ledger Project Expense Entry Use Cases

  • Quick bookkeeping for server costs, domain renewals, or software subscriptions.
  • Logging project-related meals, travel expenses, or transportation costs on the go.
  • Appending manual financial entries to a centralized project ledger using simple chat commands.
  • Standardizing expense reports across multiple team members using a shared category catalog.

How Ledger Project Expense Entry Works

  1. The skill receives a natural language message containing at least a project name and an amount.
  2. It extracts key entities including project, description, amount, currency, and direction (income or expense).
  3. The agent retrieves the current date in the Asia/Taipei timezone to determine the correct month-based storage file.
  4. It consults the CATEGORY_CATALOG.md file to ensure tags and categories remain consistent with existing records.
  5. A Python script is executed to append the formatted entry into the target JSONL ledger file.
  6. The system returns a confirmation including the file path and a formatted summary of the transaction.

Ledger Project Expense Entry Setup

To enable this skill within your Openclaw Skills environment, ensure you have the ledger script and catalog documentation in place.

# Ensure the data directory exists
mkdir -p projects/data

# The skill relies on a local Python helper
# Path: projects/scripts/add_ledger_entry.py

# Ensure you have a category catalog for validation
# Path: projects/docs/CATEGORY_CATALOG.md

Ledger Project Expense Entry Data Schema & Taxonomy

The skill organizes financial data using a flat-file JSONL structure, categorized by month.

Field Description Default
date YYYY-MM-DD format Current Date (Asia/Taipei)
direction Transaction flow (支出/收入) 支出 (Expense)
amount Numerical value of transaction Required
currency ISO currency code CNY
description Combined <project> - <description> Parsed from text
tags Comma-separated labels Based on Tag Suggestion Rules
source Origin of entry manual

Ledger Project Expense Entry Advanced Features

  • Context-aware tag suggestions that map keywords like 'server' or 'domain' to specific cost categories like 开发成本.
  • Automated file routing based on the current month to prevent oversized ledger files.
  • Intelligent parsing logic that merges project and description fields for cleaner reporting.
  • Strict validation against a master CATEGORY_CATALOG.md to prevent label duplication and maintain data integrity across Openclaw Skills.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*