OpenClaw + WooCommerce-Integrationshandbuch

WooCommerce betreibt 39 % aller Online-Shops weltweit – mehr als jede andere E-Commerce-Plattform. Seine Flexibilität und tiefe WordPress-Integration machen es zur Plattform der Wahl für Unternehmen, die die Kontrolle über ihren Stack haben möchten. Diese Flexibilität geht jedoch mit der betrieblichen Komplexität einher. WooCommerce verfügt nicht über die eigenwilligen Workflows oder das native Automatisierungs-Ökosystem von Shopify. Das Ergebnis ist, dass WooCommerce-Shops oft Plugins für jedes Betriebsproblem sammeln – ein Abonnement-Plugin, ein Treue-Plugin, ein Inventar-Plugin, ein Support-Plugin – jedes mit seiner eigenen Admin-Oberfläche und keines von ihnen tauscht Daten intelligent aus.

OpenClaw bietet eine einheitliche KI-Operationsschicht für WooCommerce, die den Flickenteppich von Plugins durch ein kohärentes, argumentationsfähiges Automatisierungssystem ersetzt. Es stellt über die REST-API, WordPress-Webhooks und bei Bedarf direkten Datenbankzugriff eine Verbindung zu WooCommerce her und koordiniert alle Betriebsdomänen über ein einziges Agenten-Framework.

Wichtige Erkenntnisse

– OpenClaw stellt über die REST-API unter Verwendung von Anwendungskennwörtern eine Verbindung zu WooCommerce her – auf der WordPress-Seite ist keine Plugin-Installation erforderlich. – Die Webhook-Registrierung erfolgt programmgesteuert über die WooCommerce-API, mit automatischer Geheimrotation und Signaturüberprüfung. – Der Order Automation Agent kümmert sich durchgängig um Statusübergänge, Fulfillment-Routing und Kundenkommunikation. – Der Inventaragent überwacht den Bestand an WooCommerce-Standorten und externen Lagern und löst so eine Wiederauffüllung aus, bevor es zu Fehlbeständen kommt. – Die Automatisierung der Abonnementverwaltung kümmert sich um die Wiederherstellung fehlgeschlagener Zahlungen, die Abwanderungsvorhersage und Upgrade-/Downgrade-Workflows.

Der SEO-Agent überwacht Produktrankings, identifiziert Optimierungsmöglichkeiten und erstellt optimierte Produktbeschreibungen. – Direkter Datenbankzugriff (schreibgeschützt, über eine Lesereplikat) wird für Analysen und Berichte verwendet, die von der REST-API nicht effizient bereitgestellt werden können.

Der OpenClaw WooCommerce-Integrationsdienst von ECOSIRE liefert produktionsbereite Automatisierung in vier bis sechs Wochen.

Authentifizierung und Verbindungsaufbau

Die REST-API von WooCommerce verwendet OAuth 1.0 oder Anwendungskennwörter zur Authentifizierung. Anwendungskennwörter (verfügbar seit WordPress 5.6) sind für Server-zu-Server-Integrationen einfacher zu verwalten.

export const WooCommerceTool = defineTool({
  name: "woocommerce",
  type: "rest",
  baseUrl: `${process.env.WORDPRESS_URL}/wp-json/wc/v3`,
  auth: {
    type: "basic",
    username: "${WC_CONSUMER_KEY}", // Vault reference
    password: "${WC_CONSUMER_SECRET}", // Vault reference
  },
  rateLimiting: {
    type: "fixed-window",
    requestsPerSecond: 25, // WooCommerce default server capacity
    burstSize: 50,
  },
  sslVerification: true, // Always verify SSL on production
});

Webhook-Registrierung: OpenClaw registriert die benötigten Webhooks beim ersten Start und validiert sie bei jedem Neustart:

export const RegisterWebhooks = defineSkill({
  name: "register-webhooks",
  tools: ["woocommerce"],
  async run({ input, tools }) {
    const requiredWebhooks = [
      { topic: "order.created", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/order-created` },
      { topic: "order.updated", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/order-updated` },
      { topic: "product.updated", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/product-updated` },
      { topic: "customer.created", deliveryUrl: `${process.env.OPENCLAW_ENDPOINT}/webhooks/wc/customer-created` },
    ];

    const existingWebhooks = await tools.woocommerce.get("/webhooks?per_page=100");

    for (const required of requiredWebhooks) {
      const exists = existingWebhooks.find((w) => w.topic === required.topic && w.delivery_url === required.deliveryUrl);
      if (!exists) {
        await tools.woocommerce.post("/webhooks", {
          name: `OpenClaw - ${required.topic}`,
          topic: required.topic,
          delivery_url: required.deliveryUrl,
          secret: process.env.WC_WEBHOOK_SECRET,
          status: "active",
        });
      }
    }

    return { registered: requiredWebhooks.length };
  },
});

Auftragsautomatisierung: Statusverwaltung und Kommunikation

WooCommerce-Bestellstatus sind: ausstehende Zahlung, Verarbeitung, zurückgestellt, abgeschlossen, storniert, erstattet und fehlgeschlagen. Der Order Automation Agent verwaltet Statusübergänge mit bei jedem Schritt angewendeter Geschäftslogik.

Ausstehend → Verarbeitung: Wenn die Zahlung vom Zahlungs-Gateway-Webhook bestätigt wird, verschiebt der Agent die Bestellung in den Status „Verarbeitung“, prüft die Lagerbestandsverfügbarkeit und leitet die Ausführung ein.

Verarbeitung → Abgeschlossen: Wenn das Lager bestätigt, dass der Versand und die Sendungsverfolgung verfügbar sind, aktualisiert der Agent den Bestellstatus, fügt Sendungsverfolgungsinformationen als benutzerdefiniertes Feld hinzu und sendet dem Kunden eine Versandbenachrichtigung.

Wiederherstellung fehlgeschlagener Zahlung: Wenn eine Zahlung fehlschlägt, storniert der Agent die Bestellung nicht sofort. Stattdessen wird eine E-Mail-Sequenz zur Zahlungswiederherstellung gesendet (1 Stunde, 24 Stunden und 72 Stunden nach dem Scheitern), ein temporärer Zahlungslink generiert und nur dann abgebrochen, wenn nach Abschluss der Sequenz keine erfolgreiche Zahlung eingeht.

export const HandleOrderStatusChange = defineSkill({
  name: "handle-order-status-change",
  tools: ["woocommerce", "email", "warehouse"],
  async run({ input, tools }) {
    const { orderId, newStatus, previousStatus } = input;
    const order = await tools.woocommerce.get(`/orders/${orderId}`);

    if (previousStatus === "pending" && newStatus === "processing") {
      // Payment received — initiate fulfillment
      const fulfillmentResult = await initiateFulfillment(tools, order);
      if (!fulfillmentResult.success) {
        // Put on hold if fulfillment cannot proceed
        await tools.woocommerce.put(`/orders/${orderId}`, {
          status: "on-hold",
          customer_note: "We are reviewing your order and will update you shortly.",
        });
        return { handled: true, action: "ON_HOLD_FULFILLMENT_ISSUE" };
      }
    }

    if (newStatus === "failed") {
      // Schedule payment recovery sequence
      await schedulePaymentRecovery(tools, order);
      return { handled: true, action: "PAYMENT_RECOVERY_SCHEDULED" };
    }

    return { handled: true, action: "STATUS_UPDATED" };
  },
});

Bestandsverwaltung: Echte Bestandstransparenz

Die native Bestandsverwaltung von WooCommerce ist einfach – Bestandszählungen pro Produkt und pro Variation mit einfachem Out-of-Stock-Verhalten. Für Geschäfte mit mehreren Lagern, Lieferanten oder komplexer Lagerführung erweitert der Inventory Agent dies erheblich.

Lagerbestand mit mehreren Standorten: WooCommerce unterstützt nicht nativ mehrere Lagerstandorte. Der Inventaragent verwaltet in seinem Langzeitgedächtnis eine Standortkarte, die die Lagerbestände pro Standort verfolgt. Wenn WooCommerce die Gesamtmenge anzeigt, kennt der Agent die Aufschlüsselung pro Standort.

Nachbestellpunkt-Überwachung: Der Agent führt stündlich Überprüfungen anhand der konfigurierten Nachbestellpunkte durch. Wenn die Menge eines Produkts unter den Nachbestellpunkt fällt, wird die entsprechende Nachschubaktion basierend auf der Beschaffungskonfiguration des Produkts ausgelöst:

Vom Lieferanten bezogene Produkte: Erstellt eine Bestellung im ERP (Odoo, QuickBooks oder eine Bestell-E-Mail an den Lieferanten).
Hergestellte Produkte: Löst eine Produktionsplanungsbenachrichtigung aus.
Dropshipped-Produkte: Überprüft die Verfügbarkeit des Lieferantenbestands über die Lieferanten-API (falls verfügbar) und aktualisiert den Lagerstatus des Produkts entsprechend.

export const CheckReorderPoints = defineSkill({
  name: "check-reorder-points",
  tools: ["woocommerce"],
  async run({ input, tools }) {
    const products = await tools.woocommerce.get("/products?manage_stock=true&per_page=100&stock_status=instock");
    const replenishmentNeeded = [];

    for (const product of products) {
      const reorderPoint = product.meta_data.find(m => m.key === "_openclaw_reorder_point")?.value ?? 5;
      const reorderQty = product.meta_data.find(m => m.key === "_openclaw_reorder_qty")?.value ?? 50;

      if (product.stock_quantity <= parseInt(reorderPoint)) {
        replenishmentNeeded.push({
          productId: product.id,
          productSku: product.sku,
          currentStock: product.stock_quantity,
          reorderPoint: parseInt(reorderPoint),
          orderQty: parseInt(reorderQty),
          sourcingType: product.meta_data.find(m => m.key === "_openclaw_sourcing")?.value ?? "supplier",
        });
      }
    }

    return { replenishmentNeeded, checkedCount: products.length };
  },
});

Automatisierung der Abonnementverwaltung

Für WooCommerce-Shops, die WooCommerce-Abonnements verwenden, fügt der Agent zusätzlich zu den Basisfunktionen des Plugins eine intelligente Abonnementverwaltung hinzu.

Wiederherstellung der Zahlung fehlgeschlagen: Die native Wiederholungslogik für WooCommerce-Abonnements ist zeitbasiert. Der OpenClaw-Agent fügt Verhaltensintelligenz hinzu: Für Kunden, die zuvor eine fehlgeschlagene Zahlung zurückerhalten haben, erfolgt der erste erneute Versuch innerhalb von 2 Stunden. Für Kunden mit konsistent pünktlicher Zahlungshistorie sendet der Agent vor dem erneuten Versuch eine höfliche Anfrage zur Zahlungsaktualisierung und erkennt so proaktiv abgelaufene Karten.

Abwanderungsvorhersage: Der Agent überwacht die Abonnement-Nutzungssignale (für SaaS-Produkte, bei denen Nutzungsdaten verfügbar sind), die Anmeldehäufigkeit und die Stimmung bei Support-Tickets, um einen Abwanderungsrisiko-Score zu erstellen. Abonnements mit hohem Risiko lösen eine proaktive Kontaktaufnahme zur Kundenbindung durch das CS-Team aus.

Upgrade- und Downgrade-Abläufe: Wenn das Verhalten eines Abonnenten darauf hindeutet, dass er von einer höheren Stufe (konsistente Nutzung in der Nähe der Plangrenzen) oder einer niedrigeren Stufe (konsistente Nutzung seines Plans) profitieren würde, löst der Agent eine automatisierte Empfehlungssequenz aus, anstatt auf Abwanderung zu warten.

export const MonitorSubscriptionHealth = defineSkill({
  name: "monitor-subscription-health",
  tools: ["woocommerce", "analytics"],
  async run({ input, tools }) {
    const subscriptions = await tools.woocommerce.get(
      "/subscriptions?status=active&per_page=100"
    );

    const atRisk = [];
    for (const sub of subscriptions) {
      const signals = await collectChurnSignals(tools, sub);
      const churnScore = computeChurnScore(signals);

      if (churnScore > 0.65) {
        atRisk.push({ subscriptionId: sub.id, customerId: sub.customer_id, churnScore, signals });
      }
    }

    return { atRisk, total: subscriptions.length };
  },
});

SEO und Produktinhaltsoptimierung

WooCommerce-Shops leben und sterben von der organischen Suche. Der SEO-Agent überwacht Produktrankings, identifiziert Inhaltslücken und generiert optimierte Produktbeschreibungen, die die Auffindbarkeit verbessern, ohne die Konvertierung zu beeinträchtigen.

Ranking-Überwachung: Der Agent fragt wöchentlich die Google Search Console API ab, um Ranking-Daten für Produktseiten abzurufen. Produkte, die im Ranking deutlich zurückgefallen sind, lösen einen Content-Audit aus.

Beschreibungsoptimierung: Für Produkte mit dünnen Beschreibungen (weniger als 200 Wörter) oder einem schlechten Ranking für ihre Ziel-Keywords generiert der Agent verbesserte Beschreibungen anhand der Produktspezifikationen, Kundenbewertungen und Konkurrenzanalysen. Generierte Beschreibungen werden in eine Überprüfungswarteschlange gestellt – ein Mensch genehmigt sie vor der Veröffentlichung.

Schema-Markup-Audit: Der Agent prüft, ob Produktseiten über gültiges Produktschema-Markup verfügen (einschließlich Preis, Verfügbarkeit und Bewertungsaggregationen). Fehlendes oder fehlerhaftes Schema wird zur Korrektur durch den Entwickler markiert.

Kundensegmentierung und Marketingautomatisierung

Der Marketing Agent segmentiert Kunden anhand des Kaufverhaltens und orchestriert gezielte Kampagnen über Ihren E-Mail-Dienstanbieter (Mailchimp, Klaviyo, ActiveCampaign).

Automatisch gepflegte Kundensegmente:

Neukunden (erster Kauf innerhalb von 30 Tagen): Onboarding-Sequenz, Produktschulung, Zweitkaufanreiz.
Aktive Kunden (innerhalb von 90 Tagen gekauft, 2+ Bestellungen): Benachrichtigungen über Treueprämien, Ankündigungen neuer Produkte, Cross-Selling-Sequenzen.
Risikokunden (90–180 Tage seit dem letzten Kauf): Rückgewinnungskampagnen mit immer stärkeren Angeboten.
Verfallene Kunden (über 180 Tage): Letzter Rückgewinnungsversuch, dann Ausschluss von aktiven Marketinglisten.
Hochwertige Kunden (oberste 10 % nach Lifetime-Wert): VIP-Behandlung, frühzeitiger Zugang zu neuen Produkten, persönliche CSM-Kontaktaufnahme für B2B-Konten.

Segmentzuweisungen werden täglich aktualisiert, wenn Kaufereignisse eingehen.

Analytics und Reporting

Der Analytics-Agent führt nächtliche Berichte aus und füllt ein Management-Dashboard mit:

Täglicher, wöchentlicher und monatlicher Umsatz im Vergleich zum Vorjahreszeitraum
Bruttomarge nach Produktkategorie (erfordert Kostendaten aus Produkt-Metafeldern oder ERP)
Kundengewinnungskosten aus UTM-Daten in Bestellungen
Conversion-Rate nach Verkehrsquelle
Durchschnittlicher Bestellwerttrend
Rückerstattungssatz und Gründe
Abonnement-MRR und Abwanderungsrate

Für WooCommerce-Shops mit großen Bestellmengen verwendet der Analytics Agent für Berichtsabfragen eine Lesereplik der WordPress-Datenbank anstelle der REST-API und vermeidet so eine Belastung der Produktionsdatenbank.

Häufig gestellte Fragen

Erfordert OpenClaw die Installation von WordPress-Plugins?

Es sind keine Plugins erforderlich. OpenClaw lässt sich vollständig über die integrierte REST-API von WooCommerce und das WordPress-Webhook-System integrieren. Die einzige Voraussetzung besteht darin, dass die WooCommerce-REST-API aktiviert ist (dies ist standardmäßig der Fall) und dass ein Anwendungskennwort oder ein API-Verbraucherschlüssel für den Agenten erstellt wird. Dies bedeutet, dass es keine Plugin-Kompatibilitätsprobleme, Plugin-Update-Konflikte oder zusätzliche Lizenzkosten gibt.

Wie geht der Agent mit WooCommerce-Shops auf Shared Hosting mit begrenzten Ressourcen um?

Für Shared-Hosting-Umgebungen gelten strengere Ratenbeschränkungen und Ressourcenbeschränkungen als für dedizierte Server. Der WooCommerce-Tool-Adapter von OpenClaw kann mit konservativen Ratenlimits (5–10 Anfragen pro Sekunde statt 25) und Anfrage-Batching konfiguriert werden, um innerhalb der Hosting-Einschränkungen zu bleiben. Für Geschäfte, in denen die API-Leistung ein Problem darstellt, empfiehlt ECOSIRE, OpenClaw so zu konfigurieren, dass es außerhalb der Spitzenzeiten für umfangreiche Batch-Vorgänge (Bestandsprüfungen, Analyseabfragen) verwendet wird und Echtzeit-API-Kapazität für die Auftragsabwicklung reserviert.

Kann der Inventaragent mit externen Lagerverwaltungssystemen synchronisiert werden?

Ja. Der Inventory Agent kann in jedes WMS integriert werden, das eine API bereitstellt (ShipBob, ShipStation, Linnworks, Brightpearl und andere). Wenn eine Bestellung im WMS ausgeführt wird, empfängt der Agent das Erfüllungsereignis, aktualisiert den WooCommerce-Bestellstatus und die Nachverfolgung und gleicht die Lagerbestände ab. Für 3PL-Partner ohne APIs kann der Agent E-Mail- oder CSV-Bestandsberichte automatisch verarbeiten.

Wie funktioniert das Vorhersagemodell zur Abonnementabwanderung für neue Geschäfte ohne historische Daten?

Das Abwanderungsmodell beginnt mit branchenüblichen Basiswerten für Ihre Unternehmenskategorie (SaaS, Abonnementbox, Verbrauchsmaterialien usw.) und geht zu geschäftsspezifischen Modellen über, wenn sich Abonnementdaten von mehr als 60 Tagen ansammeln. Während des Basiszeitraums stellt ECOSIRE eine Abwanderungssignalkonfiguration basierend auf Ihrem Produkttyp und Ihrer Abonnementstruktur bereit. Das Modell verbessert sich automatisch, wenn Ergebnisse beobachtet und in den Trainingssatz zurückgeführt werden.

Welche Auswirkungen hat dies auf die Leistung von WordPress/WooCommerce?

OpenClaw läuft vollständig außerhalb von WordPress. API-Aufrufe von OpenClaw an WooCommerce sind Standard-HTTP-Anfragen, die der gleichen Verarbeitung unterliegen wie jeder API-Client. Der Ratenbegrenzer im Tool-Adapter verhindert, dass der Agent die WordPress-Datenbank überlastet. Für stark frequentierte Geschäfte (mehr als 10.000 Bestellungen pro Monat) empfiehlt ECOSIRE, eine WordPress-Lesereplikat einzurichten und die Analyseabfragen von OpenClaw dorthin zu leiten. Abfragen zur Auftragsabwicklung in Echtzeit werden in der Primärdatenbank ausgeführt, werden jedoch stark zwischengespeichert.

Nächste Schritte

Die Flexibilität von WooCommerce ist seine größte Stärke und seine betriebliche Herausforderung. OpenClaw bietet WooCommerce-Shops die Betriebsinformationen, die Shopify Plus-Händler nativ erhalten – ohne auf die Kontrolle und Anpassung zu verzichten, die WooCommerce bietet.

Der OpenClaw WooCommerce-Integrationsdienst von ECOSIRE liefert einen vollständigen Automatisierungs-Stack, der auf den spezifischen Produktmix, die Betriebsabläufe und den Technologie-Stack Ihres Shops zugeschnitten ist. Unser Team hat OpenClaw in WooCommerce-Shops integriert, die von Boutique-Fachhändlern bis hin zu großvolumigen B2B-Distributoren reichen.

Kontaktieren Sie ECOSIRE, um eine WooCommerce-Automatisierungserkennungssitzung zu vereinbaren.

OpenClaw + WooCommerce Integration Guide