How to Connect OpenClaw to Shopify

# 1. Go to Shopify Admin → Settings → Apps and sales channels
# 2. Click "Develop apps" → "Allow custom app development"
# 3. Click "Create an app"
# 4. Set:
#    - App name: OpenClaw AI
#    - App developer: Your email
# 5. Click "Create app"

# In your custom app settings:
# Click "Configure Admin API scopes"
# Enable scopes:
#   - read_orders (query orders)
#   - write_orders (update order tags, notes)
#   - read_products (query product catalog)
#   - read_customers (query customer data)
#   - write_customers (update customer notes)
#   - read_fulfillments (check shipping status)
# Click "Save"
# Click "Install app" to generate API credentials

# After installing the app, copy:
# - Admin API access token (shpat_xxx)
# - Store domain (yourstore.myshopify.com)

# In config/skills/shopify.yaml:
shopify:
  enabled: true
  store_domain: "yourstore.myshopify.com"
  api_token: "shpat_YOUR_ADMIN_API_ACCESS_TOKEN"
  api_version: "2024-01"  # Use latest stable version

# Install the skill:
openclaw skill install shopify

# Test connection:
openclaw skill test shopify --action get_shop_info

# In Shopify Admin → Settings → Notifications → Webhooks:
# Create webhooks for:
#   - Order creation: https://your-domain.com/webhooks/shopify/orders/create
#   - Order fulfillment: https://your-domain.com/webhooks/shopify/orders/fulfilled
#   - Customer creation: https://your-domain.com/webhooks/shopify/customers/create

# In config/skills/shopify.yaml (continued):
webhooks:
  enabled: true
  webhook_path: "/webhooks/shopify"
  verify_signature: true  # Verify HMAC signature from Shopify
  webhook_secret: "YOUR_WEBHOOK_SECRET"  # From Shopify webhook settings

# Query recent orders:
openclaw chat "Show me the 5 most recent orders from Shopify"

# Search products:
openclaw chat "Find all products in Shopify with 'organic' in the title"

# Get customer info:
openclaw chat "Show me customer details for email customer@example.com from Shopify"

# Update order:
openclaw chat "Add tag 'reviewed-by-ai' to Shopify order #1234"

# Check logs:
tail -f ~/.openclaw/logs/skills.log | grep shopify

# Example: Order status automation
# config/workflows/shopify_order_status.yaml:
workflows:
  shopify_order_status:
    trigger:
      type: webhook
      path: /webhooks/shopify/orders/create
    steps:
      - name: Get order details
        action: shopify.get_order
        params:
          order_id: "{{ webhook.body.id }}"
      - name: Generate confirmation message
        action: ai.generate
        input: "Create a friendly order confirmation message for {{ steps.get_order_details.output.customer.first_name }}"
      - name: Send to customer (via email or SMS)
        action: notify.send
        params:
          to: "{{ steps.get_order_details.output.customer.email }}"
          message: "{{ steps.generate_confirmation_message.output }}"