A powerful integration skill for managing Punchh loyalty programs, customer data, and rewards through an automated AI agent workflow.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install punchh
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 punchh 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 Punchh?
The Punchh skill for Openclaw Skills enables seamless interaction with the leading loyalty and marketing platform for brick-and-mortar retailers. By leveraging this skill, developers can automate the management of guest accounts, loyalty rewards, and customer orders without manually handling complex authentication flows.
Built on the Membrane framework, this integration ensures that your AI agents have secure, reliable access to Punchh data. It eliminates the need for managing local secrets or API keys, as the platform handles credential refreshes and secure connection states server-side, allowing for high-performance customer engagement automation.
Punchh Use Cases
- Automating the creation and management of customer loyalty accounts and reward programs.
- Synchronizing guest order data between physical retail locations and digital marketing databases.
- Running targeted customer engagement campaigns based on real-time purchase history.
- Fetching granular reward details to provide personalized support via AI agents.
- Proxying complex API requests to the Punchh developer platform with automatic header injection.
How Punchh Works
- Installation: The Membrane CLI is installed globally to provide the underlying communication layer for Openclaw Skills.
- Authentication: The user logs in via a tenant-based flow, identifying the agent type (e.g., openclaw) to optimize tooling.
- Connection Establishment: A connection to the Punchh domain is ensured, triggering an OAuth or API key handshake in a secure browser environment.
- Action Discovery: The AI agent uses natural language intent to search for specific pre-built actions like fetching guest records or updating orders.
- Execution: Actions are executed with JSON parameters, or raw requests are sent through a managed proxy that handles all authentication headers and base URL formatting automatically.
Punchh Setup
First, install the necessary CLI tool:
npm install -g @membranehq/cli@latest
Next, authenticate your environment for Openclaw Skills:
membrane login --tenant --clientName=openclaw
Create a secure connection to the Punchh API:
membrane connection ensure "https://punchh.com" --json
Punchh Data Schema & Taxonomy
The Punchh skill organizes data around four primary entities, accessible via structured actions or the proxy requester:
| Entity | Description |
|---|---|
| Guest | Core customer profile data and identification. |
| Loyalty Account | Point balances, membership tiers, and status. |
| Reward | Available vouchers, discounts, and redemption history. |
| Order | Transactional data including items, timestamps, and locations. |
All responses are returned as machine-readable JSON objects when the --json flag is utilized.
Punchh Advanced Features
- Natural Language Intent Discovery: Find the right API function by describing your goal instead of hunting through documentation.
- Transparent Credential Refresh: Automatically handles token expiration without interrupting long-running agent workflows.
- Headless Environment Support: Support for CLI-based authentication in remote servers or CI/CD pipelines.
- Automated API Proxying: Directly query any Punchh endpoint while Membrane manages base URLs and security headers.
- Long-polling Connection Management: Built-in
--waitflags to synchronize agent actions with asynchronous authentication states.
SKILL.md
Loading
Related Openclaw Skills
Rapyd AI Agent Skill
A powerful financial integration skill that enables AI agents to manage global payments, wallets, and local currency transactions through the Rapyd network.
QuestDB Integration for AI Agents
A high-performance time-series database skill that enables AI agents to query and manage large-scale time-stamped data using SQL.
Mentionlytics
A powerful media monitoring integration for tracking brand mentions and social signals across the web.
Mabl
A powerful Mabl integration that allows AI agents to manage automated end-to-end testing and quality assurance workflows.
RapiDoc AI Agent Skill
A powerful integration for AI agents to visualize OpenAPI specifications and automate RESTful API interactions through the Membrane ecosystem.
Pageclip
Collect form data from static websites and automate submission workflows effortlessly using Pageclip with Openclaw Skills.
Featured*
