gumroad-pro

name	gumroad-pro
description	Comprehensive Gumroad merchant management for Products, Sales, Licenses, Discounts, Payouts, and Webhooks. Use when Claude needs to: (1) Manage digital or physical inventory, (2) Oversee transactions and process refunds/shipping, (3) Verify or rotate license keys, (4) Manage offer codes, or (5) Monitor payout history and store webhooks.

Gumroad Pro

🛑 AI PROTOCOL

1. PRIORITIZE HANDLER: Always attempt to use the interactive button-based GUI (handled by handler.js) for the best merchant experience.
2. CLI AS FALLBACK: Only use scripts/gumroad-pro.js via the CLI for complex data retrieval or specific actions not available in the GUI.
3. USE --json: When using the CLI, ALWAYS use the --json flag and check for "success": true.
4. REDUCE SPAM: Use action: 'edit' in renderResponse for all menu transitions and state updates. Only use action: 'send' for the initial menu or when the context fundamentally changes.
5. HANDLE ERRORS: Read the "error" field in JSON responses to inform the user of failures.

❓ Navigation & Data

• Primary Interaction: Use the adaptive logic in handler.js. See handler-guide.md for interaction patterns, ui-rendering.md for rendering protocols, and changelog.md for version history. Respond with button callback data (e.g., gp:products) or digits (1, 2, 3) where applicable.
• Secondary Interaction: Use scripts/gumroad-pro.js for direct actions. See api-reference.md for command specs.

🔑 Authentication

The skill requires a Gumroad API Key. It looks for the following environment variables (in order of preference):

1. GUMROAD_ACCESS_TOKEN
2. API_KEY

Configuration

You can set this in your ~/.openclaw/openclaw.json using the apiKey convenience field:

{
  "skills": {
    "entries": {
      "gumroad-pro": {
        "enabled": true,
        "apiKey": "YOUR_GUMROAD_TOKEN"
      }
    }
  }
}

The platform will automatically inject your apiKey into the preferred GUMROAD_ACCESS_TOKEN variable.

🛠️ Workflows

Product Inventory

• List all digital assets to monitor sales and availability.
• Toggle publication status or delete obsolete items.
• View detailed product commands.

Sales & Fulfillment

• Search transactions by email.
• Process refunds or mark physical goods as shipped.
• View detailed sales commands.

Licensing

• Verify keys for software distribution.
• Manage usage counts or rotate keys for security.
• View detailed license commands.

Offer Management

• Create, list, or remove discount codes for marketing campaigns.
• View detailed discount commands.

---

Developed for the OpenClaw community by Abdul Karim Mia.