A smart retail promotion calculator that computes final prices, applies discount stacking rules, and provides transparent savings breakdowns for customers.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install promotion-engine
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install promotion-engine 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 Promotion Engine?
The Promotion Engine is a robust Openclaw Skills component designed for digital employees and AI agents in the retail sector. It serves as a centralized intelligence layer for lookup and calculation of active promotions, ensuring that customers always receive the most accurate and beneficial pricing based on current marketing campaigns.
By synthesizing data from a local knowledge base of active promotions and membership configurations, this skill eliminates pricing ambiguity. It handles complex logic including threshold-based discounts, bundle deals, and VIP tier pricing while maintaining full transparency by showing the step-by-step mathematical breakdown of every final price.
Promotion Engine Use Cases
- Automatically answering customer inquiries about active discounts and sale events.
- Calculating complex cart totals involving multiple items, tiered thresholds, and membership-specific pricing.
- Optimizing purchase strategies by identifying the best possible discount combinations for a user.
- Verifying the applicability and stackability of specific coupons or promotional codes.
How Promotion Engine Works
- The agent identifies applicable promotions by checking the knowledge base for active, non-expired offers that match the product scope.
- Excluded items and membership-specific eligibility are filtered out to ensure rule compliance.
- The skill invokes a dedicated calculation script to process rules like thresholds, percentages, and bundle pricing.
- Stacking logic is applied to determine if multiple promotions can be combined or if the single highest-value offer should be used.
- A final transparent result is generated, displaying the original price, applied discounts, and total customer savings.
Promotion Engine Setup
To integrate the Promotion Engine into your digital workspace, ensure your Openclaw Skills environment is configured with a promotions array in your knowledge base.
# Install the necessary calculation dependencies
pip install openclaw-retail-utils
# Configure your membership tiers
openclaw config set membership_tiers="VIP1,VIP2,VIP3"
# Validate the promotion script
python scripts/calculate_promotion.py --test
Promotion Engine Data Schema & Taxonomy
The skill organizes data using a structured metadata approach to ensure precise calculation. Below is the primary taxonomy used within the Openclaw Skills framework:
| Field | Description | Type |
|---|---|---|
promotions[] |
List of active campaign objects in the knowledge base. | Array |
membership{} |
Configuration object defining tier-based discount rates. | Object |
stackable |
Boolean flag indicating if a promo can be combined. | Boolean |
applicable_to |
Scope defining which product IDs or categories qualify. | List |
Promotion Engine Advanced Features
- Intelligent Stacking Logic: Automatically prioritizes the combination of rules that provides the maximum benefit to the customer.
- Membership Tier Integration: Dynamically adjusts calculations based on the detected VIP level of the user.
- Edge Case Handling: Provides polite, pre-defined responses for expired promotions or unverified customer claims.
- Script-Based Computation: Offloads complex math to an external Python script for high-precision financial accuracy.
SKILL.md
Loading
Related Openclaw Skills
Multi-Environment Isolator
A professional tool to generate fully isolated development, testing, and production environments for Python web projects with integrated frontend support.
MooTeam
A powerful API integration for OpenClaw that enables AI agents to manage projects, tasks, and time tracking through the MooTeam platform.
Category Page Generator
A specialized tool for creating and auditing high-converting e-commerce category pages and listing structures.
Shopify Traffic Analyzer
A strategic intelligence tool for Shopify merchants to benchmark competitor traffic and execute a 90-day growth roadmap.
Xiaohongshu Keyword Collector
An automated browser-based tool that extracts real-time search suggestions and trending keywords directly from Xiaohongshu's Explore page.
RPM Packaging Standard
A definitive technical guide and automation resource for creating, building, and maintaining high-quality RPM packages across all major Linux distributions.
Featured*
