openclaw-commerce-shopify_skill

Overview

This skill lets you manage Shopify stores through the OpenClaw Commerce API using direct HTTP requests. It requires the OpenClaw Commerce Shopify app to be installed on the merchant store and an API key configured locally. The skill exposes a unified operation endpoint to perform shop, order, customer, product, collection, catalog, and discount tasks.

How this skill works

The skill sends authenticated HTTP requests to the OpenClaw Commerce API base URL (https://shopify.openclawcommerce.com/api/v1). You test connectivity with /test (GET) and perform specific actions by POSTing a JSON payload with a GraphQL-like query to /operation, including the X-OpenClaw-Commerce-Token header. Responses follow a simple success or error format intended for business users.

When to use it

• Sync or manage orders, customers, products, collections, catalogs, and discounts from an external service.
• Automate bulk create, update, or delete operations across Shopify resources without using Shopify admin UI.
• Integrate storefront or backend workflows with a single unified API endpoint for multiple Shopify actions.
• Run scheduled maintenance tasks like catalog updates, price changes, or discount creation.
• Validate connectivity and credentials for the OpenClaw Commerce bridge before launching integrations.

Best practices

• Install the OpenClaw Commerce Shopify app on your store before attempting any calls; the skill cannot function without it.
• Store your API key in ~/.openclaw/openclaw.json and restrict access to that file for security.
• Use POST for complex queries and request only the fields you need to improve performance.
• Start with small pagination sizes (first) when listing collections or orders to avoid large responses.
• Always include the X-OpenClaw-Commerce-Token header and handle 401/400/500 responses with clear business-friendly messages.

Example use cases

• Create or update products in bulk from an external catalog feed by posting createProduct or updateProduct queries.
• Fetch recent orders for fulfillment workflows using the getOrders query and process them in your fulfillment system.
• Add customers or update customer profiles when onboarding new subscribers or importing CRM contacts.
• Create time-limited discount codes or automatic discounts for promotions and campaigns via createCodeDiscount or createAutomaticDiscount.
• Archive or back up store data by exporting products, collections, and orders through the unified operation endpoint.