openclaw-commerce-shopify

# OpenClaw Commerce Shopify Integration

Full read/write access to Shopify Admin GraphQL API for managing orders, products, customers, collections, catalogs, and discounts through OpenClaw Commerce.

## Setup

### Environment Variables

| Variable                    | Description                              |
| --------------------------- | ---------------------------------------- |
| `OPENCLAW_COMMERCE_API_KEY` | API key from OpenClaw Commerce Dashboard |

### Authentication

All requests require this header:

```
X-OpenClaw-Commerce-Token: $OPENCLAW_COMMERCE_API_KEY
```

### If API Key is Missing (Agent Behavior)

**When `OPENCLAW_COMMERCE_API_KEY` is not set or is invalid, the agent MUST:**

1. **Stop and ask the user for the API key**, displaying these instructions:

   ***

   **I need your OpenClaw Commerce API key to connect to your Shopify store.**

   If you don't have one yet, here's how to get it:
   1. **Install the OpenClaw Commerce app** on your Shopify store at [openclawcommerce.com](https://openclawcommerce.com)
   2. **Open the Dashboard** and go to **Settings** → **API Keys**
   3. **Click "Create New API Key"** and copy the generated key (starts with `occ_`)

   **Please paste your API key here:**

   ***

2. **When the user provides the key:**
   - Validate format: must start with `occ_` and be non-empty
   - Save it to the `OPENCLAW_COMMERCE_API_KEY` environment variable
   - **Test the connection** by calling the `/test` endpoint:
     ```bash
     curl "$API_BASE/test" \
       -H "X-OpenClaw-Commerce-Token: $OPENCLAW_COMMERCE_API_KEY"
     ```
   - **If test succeeds (200 OK):** Confirm with "✅ API key saved successfully. You're now connected to your Shopify store."
   - **If test fails (401/403):** Explain "❌ The API key appears to be invalid or doesn't have access. Please check your key and try again."
   - **If test fails (other error):** Explain "⚠️ API key saved, but couldn't verify connection. Please check your internet connection or...

# OpenClaw Commerce Shopify Skill

Full read/write access to Shopify Admin GraphQL API for managing orders, products, customers, collections, catalogs, and discounts.

## Setup

### Environment Variables

| Variable | Description |
|----------|-------------|
| `OPENCLAW_COMMERCE_API_KEY` | API key from OpenClaw Commerce Dashboard |

### Getting an API Key

If the agent asks for your API key, follow these steps:

1. **Install the OpenClaw Commerce app** on your Shopify store at [openclawcommerce.com](https://openclawcommerce.com)
2. **Open the Dashboard** and go to **Settings** → **API Keys**
3. **Click "Create New API Key"** and copy the generated key (starts with `occ_`)
4. **Paste the key** when the agent prompts you

The agent will automatically test the connection and confirm when you're connected.

### Authentication

All requests require this header:
```
X-OpenClaw-Commerce-Token: $OPENCLAW_COMMERCE_API_KEY
```

### API Reference

**Base URL**: `https://app.openclawcommerce.com/api/v1`

## Structure

```
openclaw-commerce-shopify/
├── SKILL.md              # Main skill file (OpenClaw reads this)
├── queries/              # Query and mutation documentation
│   ├── getShop.md        # Shop information queries
│   ├── getCustomers.md   # Customer queries
│   ├── createCustomer.md # Customer creation mutations
│   ├── updateCustomer.md # Customer update mutations
│   ├── deleteCustomer.md # Customer deletion mutations
│   ├── getOrders.md      # Order queries
│   ├── createOrder.md    # Order creation mutations
│   ├── updateOrder.md    # Order update mutations
│   ├── deleteOrder.md    # Order deletion mutations
│   ├── getProducts.md    # Product queries
│   ├── createProduct.md  # Product creation mutations
│   ├── updateProduct.md  # Product update mutations
│   ├── deleteProduct.md  # Product deletion mutations
│   ├── getCollections.md # Collection queries
│   ├── createCollection.md # Collection creation mutations
│   ├── updateCollection.md # Collection up...