erpclaw
# ERPClaw — AI-Native ERP for OpenClaw <!-- SYNC:facts:start --> ERPClaw v4.7.0 | 46 modules (46 active + 0 preview) | 3,169 actions <!-- SYNC:facts:end --> A complete ERP system built as an [OpenClaw](https://openclaw.org) skill. Full double-entry accounting, invoicing, inventory, purchasing, tax, billing, HR, payroll, and financial reporting — all in a single install. The foundation ships 483 actions across 14 user-facing domains; total project surface is 3,131 actions across 46 modules. ## 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 (483 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 45 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** (19): CRM, Manufacturing, Projects, Assets, Quality, Fleet, POS, Logistics, Stripe, Shopify, OS Engine, and more - **Healthcare** (5): Core clinical + Dental, Veterinary, Mental Health, Home Health - **Education** (7): Core SIS + Financial Aid, K-12, Scheduling, LMS, State Reporting, Higher Ed - **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 │ │ (infrastructure, not user-facing domains:) ├── erpclaw-meta → Module metadata, registry helpers └── erpclaw-os → Read-only validate / inspect layer │ ▼ SQLite (local database) WAL mode, FK enforcement, parameterized queries ``` The 14 user-facing domains map 1:1 with the routing rows above (`setup` through `accounting-adv`). `erpclaw-meta` and `erpclaw-os` live alongside in `scripts/` but are infrastructure (registry helpers + module-validation reads). The generate / deploy / DGM half of the OS lives in the optional `erpclaw-os-engine` addon, not the foundation. ### 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 46 modules across 16 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 ``` - **Stripe Marketplace listing:** [marketplace.stripe.com/apps/erpclaw-accounting](https://marketplace.stripe.com/apps/erpclaw-accounting) - **Docs:** [erpclaw.ai/docs/stripe](https://www.erpclaw.ai/docs/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 ``` - **Shopify App Store:** ERPClaw Accounting & ERP (listing pending approval) - **Docs:** [erpclaw.ai/docs/shopify](https://www.erpclaw.ai/docs/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](https://github.com/avansaber/erpclaw-web) is a purpose-built dashboard for ERPClaw with live data tables, action execution, AI chat, and real-time WebSocket updates. ```bash git clone https://github.com/avansaber/erpclaw-web.git cd erpclaw-web && npm install && pip install -r api/requirements.txt ``` See [erpclaw-web README](https://github.com/avansaber/erpclaw-web#readme) for setup and deployment. ### WebClaw (Universal) [WebClaw](https://github.com/avansaber/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`](https://github.com/avansaber/erpclaw-addons/tree/main/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 - **Website**: [erpclaw.ai](https://www.erpclaw.ai) - **ERPClaw Web**: [erpclaw-web](https://github.com/avansaber/erpclaw-web) — purpose-built web dashboard - **WebClaw**: [webclaw](https://github.com/avansaber/webclaw) — universal OpenClaw dashboard - **OpenClaw**: [openclaw.org](https://openclaw.org) - **All modules**: [github.com/avansaber](https://github.com/avansaber) ## License GNU General Public License v3 — Copyright (c) 2026 AvanSaber See [LICENSE.txt](LICENSE.txt) for details.