Skip to content

avansaber/erpclaw

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

71 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ERPClaw — AI-Native ERP for OpenClaw

A complete ERP system built as an OpenClaw skill. Full double-entry accounting, invoicing, inventory, purchasing, tax, billing, HR, payroll, and financial reporting — all in a single install. 478 actions across 14 domains.

Features

  • Double-entry GL — US GAAP chart of accounts, immutable journal entries, multi-company support
  • Sales — customers, sales orders, delivery notes, sales invoices, credit notes, payment tracking
  • Buying — suppliers, purchase orders, purchase invoices, goods received notes
  • Inventory — items, warehouses, stock entries, serial/batch tracking, reorder levels
  • Billing — usage-based billing, recurring invoices, subscription management
  • Tax — tax templates, multi-rate support, tax returns
  • Payments — payment entries, bank reconciliation, multi-currency
  • HR — employees, departments, designations, leave management, attendance, expenses
  • Payroll — salary structures, FICA, federal/state income tax, W-2 generation, garnishments
  • Advanced Accounting — ASC 606 revenue recognition, ASC 842 lease accounting, intercompany transactions, consolidation
  • Reports — trial balance, P&L, balance sheet, cash flow, AR/AP aging, inventory valuation
  • Module system — 45 additional modules (46 total including core) available via install-module from GitHub

Quick Start

Install via OpenClaw

clawhub install erpclaw

This installs the core ERP (413 actions) and initializes the database.

First Steps

Once installed, just talk to your AI assistant naturally:

"I'm opening a retail store called Sunrise Goods in Portland, Oregon. Set me up."

The bot will:

  1. Create your company with US GAAP chart of accounts (94 accounts)
  2. Set up fiscal year, tax rates, and cost center
  3. Suggest relevant modules for your industry

Adding Modules

ERPClaw has 43 additional modules for specific industries and features:

"I need manufacturing capabilities"
→ Installs erpclaw-ops (Manufacturing, Projects, Assets, Quality, Support)

"I need CRM"
→ Installs erpclaw-growth (CRM, Analytics, AI Engine)

"Set me up for healthcare"
→ Installs HealthClaw (140+ actions for clinical practice management)

Available modules:

  • Addon modules (16): CRM, Manufacturing, Projects, Assets, Quality, Fleet, POS, Logistics, and more
  • Healthcare (5): Core clinical + Dental, Veterinary, Mental Health, Home Health
  • Education (8): Core SIS + Financial Aid, K-12, Scheduling, LMS, State Reporting, Higher Ed, SPED
  • Property (2): Residential + Commercial property management
  • Industry verticals (8): Retail, Construction, Agriculture, Automotive, Food, Hospitality, Legal, Nonprofit
  • Regional (4): Canada, UK, India, EU (tax rules, COA templates, compliance)

Architecture

OpenClaw Bot → erpclaw/scripts/db_query.py --action {action} --args
                         │
                         ├── erpclaw-setup     → Company, COA, fiscal year, database init
                         ├── erpclaw-gl        → Chart of accounts, journal entries
                         ├── erpclaw-selling   → Customers, sales orders, invoices
                         ├── erpclaw-buying    → Suppliers, purchase orders
                         ├── erpclaw-inventory → Items, warehouses, stock
                         ├── erpclaw-billing   → Recurring invoices, subscriptions
                         ├── erpclaw-tax       → Tax templates, calculations
                         ├── erpclaw-payments  → Payment entries, reconciliation
                         ├── erpclaw-journals  → Manual journal entries
                         ├── erpclaw-reports   → Financial statements
                         ├── erpclaw-hr        → Employees, leave, attendance
                         ├── erpclaw-payroll   → Salary, tax withholding, W-2
                         └── erpclaw-accounting-adv → ASC 606/842, intercompany
                         │
                         ▼
              SQLite (local database)
              WAL mode, FK enforcement, parameterized queries

Data Integrity

  • All financial amounts stored as TEXT (Python Decimal) — never float
  • IDs are UUID4 (TEXT)
  • GL entries are immutable — cancellation creates reverse entries
  • All cross-table writes in single SQLite transactions
  • Comprehensive GL invariant validation on every posting

Database

Single SQLite database at ~/.openclaw/erpclaw/data.sqlite:

  • 688 tables across all modules (188 core)
  • WAL mode for concurrent reads
  • Foreign key enforcement ON
  • PRAGMA busy_timeout = 5000
  • Shared library at ~/.openclaw/erpclaw/lib/erpclaw_lib/

Module Registry

The module registry (scripts/module_registry.json) tracks all 48 modules across 14 GitHub repositories. Use install-module to add any module:

"Install the manufacturing module"
"Add retail capabilities"
"I need dental practice management"

Modules install from github.com/avansaber/* repos via sparse checkout — only the requested module is downloaded, not the entire repo.

Deep Integrations

ERPClaw ships with two free, open-source, self-hosted deep integrations that sync directly into your general ledger. Your data stays on your own ERPClaw instance.

Stripe (erpclaw-integrations-stripe)

Deep Stripe integration. 67 actions across 10 domains: account management, charges/refunds/disputes/payouts/subscriptions sync, customer mapping, GL posting with rule engine, payout reconciliation, ASC 606 revenue recognition, Connect platform fees, webhook processing, and financial reports (revenue, MRR, fees, disputes).

install-module erpclaw-integrations-stripe

Shopify (erpclaw-integrations-shopify)

Deep Shopify integration. 66 actions across 15 domains: order/refund/payout/dispute sync, product + customer mapping, 14 GL account mappings, configurable GL routing rules, three-layer payout reconciliation, COGS tracking, gift card deferred revenue, GDPR webhooks, App Store OAuth pairing with status mirror, and revenue/fee/refund reports.

install-module erpclaw-integrations-shopify

OAuth tokens are forwarded once to your ERPClaw during pairing and deleted from the Worker within 60 seconds. A custom-app flow is also available for air-gapped installs.

Web Dashboard

Two web dashboard options are available:

ERPClaw Web (Recommended)

ERPClaw Web is a purpose-built dashboard for ERPClaw with live data tables, action execution, AI chat, and real-time WebSocket updates.

git clone https://github.com/avansaber/erpclaw-web.git
cd erpclaw-web && npm install && pip install -r api/requirements.txt

See erpclaw-web README for setup and deployment.

WebClaw (Universal)

WebClaw is a universal OpenClaw dashboard that works with any skill:

clawhub install webclaw

WebClaw reads ERPClaw's SKILL.md and automatically generates forms, data tables, charts, and dashboards — zero per-skill configuration needed.

Optional: ERPClaw OS Engine (developer tooling)

A separate addon, erpclaw-os-engine, provides developer tooling for authoring new ERPClaw vertical modules. Generation runs sandbox-first; the user reviews diffs and approves before any deploy. Not installed by default. Foundation does not run module-generation code paths.

Links

License

GNU General Public License v3 — Copyright (c) 2026 AvanSaber

See LICENSE.txt for details.

About

AI-native ERP core: GL, AR/AP, inventory, selling, buying, HR, payroll + module installer. ~400 actions.

Topics

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages