Little Beaver Invoice Assistant for Openclaw

Little Beaver Invoice Assistant helps AI agents locally inspect, analyze, and summarize invoice data, rankings, and archived attachments through a localhost API.

yk-niu
v1.0.1
Jul 31, 2026
0
1k
0

Install & Download

1. ClawHub CLI

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

npx clawhub@latest install invoice-assistant

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 invoice-assistant 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 Little Beaver Invoice Assistant?

Little Beaver Invoice Assistant is an Openclaw Skills tool for working with a locally running invoice management app and its invoice datasets through a private localhost API. It is designed for finance-oriented analysis tasks such as selecting companies, reviewing invoice ledgers and details, summarizing tax totals, comparing customer/supplier/product rankings, and inspecting archived electronic invoice attachments.

This skill emphasizes safe local-only processing: the AI agent connects to the desktop application on the same machine, discovers the app if needed, and reads data without uploading invoices through the skill. Openclaw Skills users can rely on it for structured invoice retrieval, fuzzy searching, attachment metadata lookup, and cautious financial analysis that preserves invoice status distinctions such as voided records.

Little Beaver Invoice Assistant Use Cases

  • Connect to a local invoice assistant app and read finance data without uploading files.
  • Select a company before running invoice analysis or summary queries.
  • Review invoice ledgers, invoice details, and monthly invoicing trends.
  • Compare customer, supplier, or product rankings for procurement and sales analysis.
  • Search invoices and line items by keyword, date range, direction, or pagination.
  • Inspect archived electronic invoice attachments such as PDF, OFD, and XML metadata.
  • Retrieve attachment open links for local viewing when the user explicitly requests it.
  • Support local finance Q&A workflows inside Openclaw Skills with minimal data access.

How Little Beaver Invoice Assistant Works

  1. The skill starts by using the local client script to find and connect to the invoice assistant application running on the user’s machine.
  2. If the user provides a base URL, the skill uses that address directly; otherwise it scans the configured localhost port range and discovers the app via /api/metadata.
  3. Once connected, it queries the relevant local Skill API endpoint based on the user’s intent, such as company lookup, summaries, invoice search, item analysis, attachments, or rankings.
  4. For analytical questions, it fetches the smallest sufficient dataset first, such as companies or summaries, before moving to detailed invoice records when precision is needed.
  5. The skill applies finance-aware interpretation rules, including using Chinese fiscal terminology, formatting amounts in RMB with two decimals, and excluding voided invoices from summary and ranking calculations unless the user asks otherwise.
  6. For attachment requests, it returns metadata and an open_api path instead of exposing local file paths, and only opens files locally when the user explicitly asks to do so.
  7. The final response is generated from local data only, preserving status distinctions so Openclaw Skills can support traceable invoice analysis and local finance workflows.

Little Beaver Invoice Assistant Setup

  1. Ensure the "Little Beaver Invoice Assistant" desktop application is installed and running on the same computer as the AI agent.
  2. Prefer the bundled client script for all local queries.
  3. If the app is running on a custom port, pass the base URL explicitly.
  4. If no URL is provided, the skill will scan the default localhost range and discover the app automatically.
  5. Optionally configure environment variables to simplify repeated use.
# Use the local client script from the skill directory
python scripts/invoice_assistant_client.py info

# If the app is on a custom local port
python scripts/invoice_assistant_client.py --base-url http://127.0.0.1:8876 companies

# Optional environment variables
export INVOICE_ASSISTANT_BASE_URL=http://127.0.0.1:8876
export INVOICE_ASSISTANT_PORTS=8876-8895,9000
  1. For implementation details or full parameter definitions, consult references/api.md.
  2. Before opening an attachment, confirm the user explicitly wants to open a local file.

Little Beaver Invoice Assistant Data Schema & Taxonomy

The skill organizes invoice intelligence around a small set of local API resources and metadata fields.

Core API resources

Endpoint Purpose
/api/skill/health Health check for the local skill service
/api/skill/info App and skill metadata
/api/skill/companies List available companies
/api/skill/summary Invoice totals and monthly trend summary
/api/skill/invoices Detailed invoice search and filtering
/api/skill/items Invoice item and service detail analysis
/api/skill/attachments Archived electronic invoice attachment lookup
/api/skill/attachments/<id>/open Open a local attachment through the default app
/api/skill/rankings Customer, supplier, and product ranking analysis

Common filter taxonomy

  • company_id: repeatable company selector.
  • start / end: date range in yyyy-mm-dd format.
  • direction: 开具 or 取得.
  • keyword: fuzzy search for invoices and line items.
  • page / page_size: pagination for detailed results.
  • limit: controls ranking result count.
  • invoice_id: filters attachments by invoice master ID.
  • file_type: PDF, OFD, or XML.

Attachment metadata returned

  • file type
  • file name
  • invoice number
  • company
  • export time
  • file size
  • file existence flag
  • open_api path

Data handling notes

  • Summary and ranking endpoints exclude invoices marked as voided.
  • Detail endpoints preserve all statuses for auditing and exception review.
  • The skill does not expose absolute local file paths.
  • Attachment open actions are local-only and do not upload file contents.
  • Openclaw Skills prompts should request the minimum dataset needed before escalating to detailed queries.

Little Beaver Invoice Assistant Advanced Features

  • Localhost-only invoice intelligence with no invoice upload through the skill.
  • Automatic discovery across a configurable localhost port range when the app URL is unknown.
  • Built-in support for company selection, summaries, invoice detail search, line-item analysis, and ranking workflows.
  • Fuzzy keyword search across invoices and items for faster investigation.
  • Attachment metadata lookup for PDF, OFD, and XML archived invoices.
  • Local file opening via open_api without exposing absolute file system paths.
  • Summary and ranking logic that excludes voided invoices for cleaner analytics.
  • Finance-aware output conventions, including RMB formatting and Chinese fiscal terminology.
  • Designed for progressive disclosure: start with minimal data, then drill into details only when needed.
  • Ideal for Openclaw Skills automation in local accounting, procurement, and sales analysis tasks.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*