← 返回 Skills 市场

Aoineco Ledger — AI Agent Financial Tracking Engine

Name: Aoineco Ledger — AI Agent Financial Tracking Engine
Author: edmonddantesj

作者 edmonddantesj · GitHub ↗ · v1.0.0

cross-platform ⚠ suspicious

653

总下载

当前安装

版本数

在 OpenClaw 中安装

/install aoineco-ledger

功能描述

Track detailed AI agent expenses, revenues, budgets, and ROI with per-agent attribution and alerts for efficient micro-budget financial management.

使用说明 (SKILL.md)

Aoineco Ledger — AI Agent Financial Tracking Engine

\x3C!-- 🌌 Aoineco-Verified | S-DNA: AOI-2026-0213-SDNA-AL01 -->

Version: 1.0.0
Author: Aoineco & Co.
License: MIT
Tags: finance, expense-tracking, budget, roi, bootstrap, multi-agent, accounting

Description

Financial tracking engine built for AI agents operating on extreme budgets. Tracks every API call, gas fee, and revenue stream with per-agent cost attribution. Native support for the $7 Bootstrap Protocol.

Rebuilt from agentledger (Node.js) into Python with major enhancements for multi-agent squads and micro-budget operations.

Core metric: Intelligence per Dollar (IPD) — how many operations you get per cent spent.

Problem

AI agents spend money (API calls, gas fees, subscriptions) but rarely track it. When you're running a 9-agent squad on a $7 seed budget, every fraction of a cent matters. You need:

Real-time visibility into burn rate and runway
Per-agent cost attribution (who's spending what?)
Budget alerts BEFORE you overspend
Revenue tracking to measure actual ROI

Features

Feature	Description
Transaction Logging	Log expenses, revenue, API costs, gas fees with one-liner methods
$7 Bootstrap Metrics	Seed tracking, ROI%, runway days, daily burn rate, IPD
Per-Agent Cost Attribution	Track spending by squad member (oracle, blue-sound, etc.)
Budget Alerts	Set limits per category/period — warns at 80%, blocks at 100%
Category System	Pre-configured for AI ops: API/LLM, Gas/Blockchain, Revenue/Gig, etc.
CSV/JSON Export	Full transaction export for tax, audit, or analysis
JSONL Storage	Append-only transaction log — fast, corruption-resistant
Period Filtering	Query by today, this-week, this-month, this-year, or all

Quick Start

from ledger_engine import AoinecoLedger

ledger = AoinecoLedger()

# Log API cost
ledger.log_api_cost(0.0042, "Google", "gemini-3-flash", tokens_used=150000, agent="oracle")

# Log gas fee
ledger.log_gas(0.0003, chain="base", tx_hash="0xabc123", agent="blue-sound")

# Log revenue
ledger.log_revenue(0.01, "MoltLaunch", "Tier-1 Intel Report", category="Revenue/Gig")

# Set budget
ledger.set_budget("API/LLM", limit=3.00, period="daily")

# Check $7 Bootstrap metrics
metrics = ledger.get_bootstrap_metrics()
# → Seed: $7.00, Burn: $0.02/day, Runway: 300 days, IPD: 257.5 ops/$

Bootstrap Metrics Output

💰 Seed Amount: $7.00
📈 Total Revenue: $0.0150
📉 Total Expenses: $0.0233
🤖 API/LLM Cost: $0.0230
💵 Net Profit: $-0.0083
📊 ROI: -0.1%
💎 Remaining Balance: $6.9917
🔥 Daily Burn Rate: $0.0233/day
⏱️ Runway: 300 days
🧠 IPD: 257.5 ops/$

Pre-Configured Categories

API/LLM — OpenAI, Anthropic, Google API costs
Gas/Blockchain — On-chain transaction fees
Revenue/Gig — MoltLaunch gig income
Revenue/DeFi — Meteora, LP yields
Revenue/Music — claw.fm royalties
Infrastructure, Marketing, Tools, Subscriptions, Other

File Structure

aoineco-ledger/
├── SKILL.md              # This file
└── scripts/
    └── ledger_engine.py  # Main engine (zero external dependencies)

Zero Dependencies

Pure Python 3.10+. No pip install needed. Designed for the $7 Bootstrap Protocol — every byte counts.

安全使用建议

This package looks like a local bookkeeping library and asks for no secrets, but there are a few red flags to check before installing or using it with real data: - Ask the author or inspect the full ledger_engine.py for any network calls, hard-coded endpoints, or subprocess executions that are not visible in the truncated snippet. The file header promises VaultCrypto encryption and currency auto-conversion — verify how those are implemented and where keys or FX rates come from. - Confirm there is no hidden code that attempts to send the ledger contents to an external server or to read unrelated files on disk. Search the full file for 'requests', 'urllib', 'socket', 'subprocess', 'open', or any HTTP endpoints/URLs. - If you plan to record sensitive billing data, run the skill in an isolated environment (sandbox/container) and review the created ledger directory (~/.openclaw/workspace/ledger by default) to ensure only expected files are written. - If you need encrypted storage, require the implementation detail: how keys are derived/stored and whether the vault integration requires secrets. If the skill claims encryption but offers no key management, do not rely on it. If you can provide the remaining portion of scripts/ledger_engine.py (the truncated part) I can re-evaluate and raise the confidence level or surface specific lines of concern.

功能分析

Type: OpenClaw Skill Name: aoineco-ledger Version: 1.0.0 The OpenClaw AgentSkills bundle 'aoineco-ledger' is a financial tracking engine for AI agents. The `SKILL.md` provides clear instructions and descriptions without any prompt injection attempts. The `scripts/ledger_engine.py` uses only standard Python libraries, performs file I/O strictly within a designated workspace directory (`~/.openclaw/workspace/ledger` or `OPENCLAW_WORKSPACE/ledger`), and does not engage in network communication, arbitrary command execution, or access to sensitive system files or environment variables beyond `OPENCLAW_WORKSPACE`. The code's behavior is fully aligned with its stated purpose, lacking any indicators of malicious intent or significant vulnerabilities.

能力评估

ℹ Purpose & Capability

The SKILL.md and included Python implement a local ledger for per-agent cost tracking which matches the stated purpose. However the header and docs claim features such as “Encrypted storage via VaultCrypto integration” and “auto-conversion” (multi-currency) while the package declares zero external dependencies and no credentials/config for a vault or FX service — that is an internal inconsistency that should be explained.

✓ Instruction Scope

Runtime instructions in SKILL.md are narrowly scoped: import the AoinecoLedger class and call logging/export methods. The implementation shown only reads/writes files in a ledger directory (default ~/.openclaw/workspace/ledger or OPENCLAW_WORKSPACE override). There are no SKILL.md instructions to read other unrelated files, exfiltrate data, or contact external endpoints.

✓ Install Mechanism

No install spec is provided (instruction-only skill + included script). The code claims 'zero external dependencies' and is pure Python; that is low risk from a supply/install perspective. Still, the codebase includes features that normally require external services (vaults, FX rates) but no install/credential hints for those, which is inconsistent.

✓ Credentials

The skill declares no required environment variables or credentials. The implementation optionally respects OPENCLAW_WORKSPACE for the storage location — a reasonable integration point. There are no requests for API keys, cloud credentials, or unrelated secrets in metadata or visible code.

✓ Persistence & Privilege

The skill is not force-enabled (always=false) and will persist only to its own ledger directory. It creates and writes local files (transactions.jsonl, accounts.json, budgets.json, config.json) under the chosen workspace. It does not request elevation or attempt to modify other skills' configs in the visible code.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install aoineco-ledger
安装完成后，直接呼叫该 Skill 的名称或使用 /aoineco-ledger 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Initial release: Bootstrap ROI tracking, per-agent cost attribution, IPD metric, budget alerts, API/gas/revenue logging, CSV/JSON export. Rebuilt from agentledger (JS→Python). Zero dependencies.

元数据

Slug aoineco-ledger

版本 1.0.0

许可证 —

累计安装 1

当前安装数 1

历史版本数 1

常见问题