retailclaw

name	retailclaw
version	1.1.0
description	Retail Management -- 87 actions across 9 domains. Pricing, promotions, loyalty programs, gift cards, merchandising, planograms, wholesale/B2B, returns/exchanges, store locations, multi-channel, procurement, and analytics.
author	AvanSaber
homepage	https://github.com/avansaber/retailclaw
source	https://github.com/avansaber/retailclaw
tier	4
category	retail
requires	["erpclaw"]
database	~/.openclaw/erpclaw/data.sqlite
user-invocable	true
tags	["retailclaw","retail","pricing","promotion","coupon","loyalty","rewards","gift-card","merchandising","planogram","category","wholesale","b2b","returns","exchange","rma","pos","margin","channel","store","procurement","shrinkage","barcode"]
scripts	["scripts/db_query.py"]
metadata	{"openclaw":{"type":"executable","install":{"post":"python3 scripts/db_query.py --action status"},"requires":{"bins":"[Truncated]","env":"[Truncated]","optionalEnv":"[Truncated]"},"os":["darwin","linux"]}}

retailclaw

Retail Operations Manager for RetailClaw -- AI-native retail management on ERPClaw. Manages pricing/promotions, loyalty programs (points, tiers, gift cards), visual merchandising (categories, planograms), wholesale/B2B (customers, pricing, orders), returns/exchanges, multi-location store management, procurement, and retail analytics. All financials use ERPClaw GL with Decimal precision.

Skill Activation Triggers

Activate when user mentions: pricing, price list, promotion, coupon, discount, BOGO, loyalty, rewards, points, tier, gift card, planogram, merchandising, display, category, wholesale, B2B, bulk order, return, exchange, RMA, refund, store credit, margin, retail, store location, shrinkage, barcode, procurement, inter-store transfer.

Setup

python3 {baseDir}/../erpclaw/scripts/erpclaw-setup/db_query.py --action initialize-database
python3 {baseDir}/init_db.py
python3 {baseDir}/scripts/db_query.py --action status

Quick Start

--action retail-add-price-list --company-id {id} --name "Retail Standard"
--action retail-add-price-list-item --price-list-id {id} --item-name "Widget A" --rate "25.99"
--action retail-add-promotion --company-id {id} --name "Summer Sale" --promo-type percentage --discount-value "15.00" --start-date "2026-06-01" --end-date "2026-08-31"
--action retail-activate-promotion --promotion-id {id}
--action retail-add-loyalty-program --company-id {id} --name "Rewards Plus"
--action retail-add-loyalty-member --company-id {id} --program-id {id} --customer-name "Jane" --enrollment-date "2026-01-01"

All 87 Actions

Pricing (12 actions)

Action	Description
retail-add-price-list	Create price list
retail-update-price-list	Update price list
retail-get-price-list	Get price list details
retail-list-price-lists	List price lists
retail-add-price-list-item	Add item to price list
retail-update-price-list-item	Update price list item
retail-list-price-list-items	List price list items
retail-add-promotion	Create promotion
retail-update-promotion