Order & Fulfillment Monitoring with OpenClaw

# AGENTS.md — order-monitor agent

agents:
  order-monitor:
    description: "Daily order summary and flagging for fulfillment issues"
    tools:
      - shopify-admin-api   # swap for woocommerce-api if needed
    config:
      platform: shopify     # or: woocommerce
      credentials:
        store: "${SHOPIFY_STORE}"
        token: "${SHOPIFY_TOKEN}"
      time_window_hours: 24           # pull orders from last 24 hours
      high_value_threshold: 200       # flag orders above this amount
      fulfillment_delay_threshold: 2  # days before flagging as delayed
      include_fields:
        - order_id
        - customer_name
        - order_total
        - financial_status
        - fulfillment_status
        - created_at
        - items (top product by revenue)
    output:
      format: markdown
      sections:
        - summary (total_orders, total_revenue, avg_order_value)
        - top_product_by_revenue
        - high_value_orders
        - fulfillment_warnings
      include_summary: true

# WooCommerce variant — adjust credentials and endpoint
WOO_URL=https://yourstore.com
WOO_CONSUMER_KEY=ck_xxxxxxxxxxxxxxxxxxxx
WOO_CONSUMER_SECRET=cs_xxxxxxxxxxxxxxxxxxxx

# Query string: ?after=2026-03-24T07:00:00&before=2026-03-25T07:00:00&per_page=100

# AGENTS.md — fulfillment-delay-checker agent

agents:
  fulfillment-delay-checker:
    description: "Flag paid orders not yet fulfilled, with escalation tiers"
    tools:
      - shopify-admin-api
    config:
      platform: shopify
      credentials:
        store: "${SHOPIFY_STORE}"
        token: "${SHOPIFY_TOKEN}"
      query_filters:
        financial_status: paid
        fulfillment_status: null    # unfulfilled
      age_threshold_days: 2
      escalation_tiers:
        warning:  [2, 3]            # 2–3 days: WARNING
        urgent:   [4, 9999]         # 4+ days: URGENT
    output:
      format: markdown_table
      columns:
        - order_id
        - customer_name
        - order_date
        - days_unfulfilled
        - order_value
        - items
        - fulfillment_status
      sort_by: days_unfulfilled (descending)
      escalation_colors: true

# AGENTS.md — carrier-tracker agent

agents:
  carrier-tracker:
    description: "Monitor shipment tracking and flag delays or exceptions"
    tools:
      - easypost-api
    config:
      platform: shopify
      credentials:
        easypost_api_key: "${EASYPOST_API_KEY}"
        shopify_store: "${SHOPIFY_STORE}"
        shopify_token: "${SHOPIFY_TOKEN}"
      tracking_statuses_to_alert:
        - pre_transit (stuck 3+ days)
        - in_transit (stuck 5+ days)
        - failure
        - error
        - unknown
      max_days_in_status: 5         # flag if status hasn't changed in 5 days
    output:
      format: markdown
      columns:
        - tracking_code
        - carrier
        - status
        - last_status_update
        - days_in_status
        - estimated_delivery
      sort_by: days_in_status (descending)

# AGENTS.md — returns-monitor agent

agents:
  returns-monitor:
    description: "Track refund volume and spike alerts"
    tools:
      - shopify-admin-api
    config:
      platform: shopify
      credentials:
        store: "${SHOPIFY_STORE}"
        token: "${SHOPIFY_TOKEN}"
      time_window_days: 7           # track last 7 days
      returns_spike_threshold: 8    # alert if return rate > 8%
    output:
      format: markdown
      include_fields:
        - total_refunded_orders
        - returns_rate (%)
        - comparison_to_prior_week
        - items_by_return_reason (if available)

# HEARTBEAT.md — morning order brief

schedule:
  - name: "Morning Order Brief"
    cron: "0 7 * * *"           # every day at 7 AM
    agents:
      - order-monitor
      - fulfillment-delay-checker
    output:
      file: "daily_order_brief.md"
      notify: true
    prompt: |
      Combine order-monitor and fulfillment-delay-checker outputs into a single morning briefing.
      Format:
      1. DAILY SNAPSHOT — total orders, revenue, AOV, top product
      2. HIGH-VALUE ORDERS — list orders above threshold with customer and total
      3. FULFILLMENT WARNINGS — unfulfilled orders by escalation tier
      4. ACTION ITEMS — summary of what needs attention today
      If all metrics are healthy, output one-line confirmation: "✓ All orders on track."

# HEARTBEAT.md — carrier tracking

schedule:
  - name: "Carrier Exception Check"
    cron: "0 9,14 * * *"         # 9 AM and 2 PM daily
    agents:
      - carrier-tracker
    output:
      file: "carrier_exceptions.md"
      notify: true

# HEARTBEAT.md — weekly returns

schedule:
  - name: "Weekly Returns Report"
    cron: "0 8 * * 1"           # Mondays at 8 AM
    agents:
      - returns-monitor
    output:
      file: "weekly_returns.md"
      notify: true
    prompt: |
      Summarize returns from the past week. Compare return rate to the prior week.
      If return rate > 8%, flag spike and suggest investigation into the top return reasons.