دليل تكامل OpenClaw + WooCommerce

تعمل WooCommerce على تشغيل 39% من جميع المتاجر عبر الإنترنت على مستوى العالم — أكثر من أي منصة أخرى للتجارة الإلكترونية. إن مرونته وتكامله العميق مع WordPress يجعله النظام الأساسي المفضل للشركات التي تريد التحكم في مجموعتها. لكن هذه المرونة تأتي مع التعقيد التشغيلي. لا يحتوي WooCommerce على مسارات عمل Shopify المحددة أو النظام البيئي الأصلي للأتمتة. والنتيجة هي أن متاجر WooCommerce غالبًا ما تقوم بتجميع المكونات الإضافية لكل مشكلة تشغيلية — مكون إضافي للاشتراك، ومكون إضافي للولاء، ومكون إضافي للمخزون، ومكون إضافي للدعم — ولكل منها واجهة الإدارة الخاصة بها ولا يقوم أي منها بمشاركة البيانات بذكاء.

يوفر OpenClaw طبقة عمليات الذكاء الاصطناعي الموحدة لـ WooCommerce التي تستبدل خليط المكونات الإضافية بنظام أتمتة متماسك وقادر على التفكير. وهو يتصل بـ WooCommerce من خلال REST API وخطافات الويب الخاصة بـ WordPress والوصول المباشر إلى قاعدة البيانات عند الضرورة، وينسق عبر جميع المجالات التشغيلية من إطار عمل وكيل واحد.

الوجبات الرئيسية

يتصل OpenClaw بـ WooCommerce عبر REST API باستخدام كلمات مرور التطبيق - لا يلزم تثبيت مكون إضافي على جانب WordPress.

تتم معالجة تسجيل Webhook برمجيًا من خلال WooCommerce API، مع التدوير السري التلقائي والتحقق من التوقيع.

يتعامل وكيل أتمتة الطلب مع انتقالات الحالة وتوجيه التنفيذ والتواصل مع العملاء من البداية إلى النهاية.

يقوم وكيل المخزون بمراقبة المخزون عبر مواقع WooCommerce والمستودعات الخارجية، مما يؤدي إلى تجديد المخزون قبل نفاد المخزون.

تعالج أتمتة إدارة الاشتراك عملية استرداد الدفعات الفاشلة، والتنبؤ بالتوقف عن العمل، وسير العمل للترقية/التخفيض.

يقوم وكيل تحسين محركات البحث (SEO) بمراقبة تصنيفات المنتجات، وتحديد فرص التحسين، وإنشاء أوصاف المنتج الأمثل.

يتم استخدام الوصول المباشر إلى قاعدة البيانات (للقراءة فقط، عبر نسخة متماثلة للقراءة) للتحليلات وإعداد التقارير التي لا يمكن تقديمها بكفاءة بواسطة REST API.

توفر خدمة تكامل OpenClaw WooCommerce من ECOSIRE أتمتة جاهزة للإنتاج خلال أربعة إلى ستة أسابيع.

إعداد المصادقة والاتصال

تستخدم واجهة REST API الخاصة بـ WooCommerce OAuth 1.0 أو كلمات مرور التطبيق للمصادقة. تعد كلمات مرور التطبيقات (المتوفرة منذ WordPress 5.6) أسهل في الإدارة لعمليات التكامل من خادم إلى خادم.

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
});

تسجيل الخطاف عبر الويب: يقوم OpenClaw بتسجيل خطافات الويب التي يحتاجها عند بدء التشغيل لأول مرة والتحقق من صحتها عند كل إعادة تشغيل:

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 };
  },
});

أتمتة الطلب: إدارة الحالة والاتصالات

حالات طلب WooCommerce هي: في انتظار الدفع، والمعالجة، وفي الانتظار، والمكتمل، والملغى، والمسترد، والفشل. يقوم وكيل أتمتة الطلب بإدارة انتقالات الحالة باستخدام منطق الأعمال المطبق في كل خطوة.

معلق → المعالجة: عندما يتم تأكيد الدفع بواسطة الخطاف الإلكتروني لبوابة الدفع، ينقل الوكيل الطلب إلى المعالجة، ويتحقق من توفر المخزون، ويبدأ التنفيذ.

المعالجة → مكتملة: عندما يؤكد المستودع توفر الشحن والتتبع، يقوم الوكيل بتحديث حالة الطلب وإضافة معلومات التتبع كحقل مخصص، ويرسل للعميل إشعار الشحن.

فشل استرداد الدفعة: عند فشل الدفع، لا يقوم الوكيل بإلغاء الطلب على الفور. وبدلاً من ذلك، يرسل تسلسل بريد إلكتروني لاسترداد الدفعة (في ساعة واحدة، و24 ساعة، و72 ساعة بعد الفشل)، وينشئ رابط دفع مؤقت، ولا يلغي إلا إذا لم يتم استلام دفعة ناجحة بعد اكتمال التسلسل.

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" };
  },
});

إدارة المخزون: رؤية المخزون الحقيقي

تعد إدارة المخزون الأصلي لـ WooCommerce أمرًا أساسيًا — حيث يتم حساب المخزون لكل منتج ولكل تنوع من خلال سلوك بسيط خارج المخزون. بالنسبة للمتاجر التي تحتوي على مستودعات أو موردين متعددين أو مسارات معقدة للمخزون، يقوم وكيل الجرد بتوسيع هذا بشكل كبير.

مخزون متعدد المواقع: لا يدعم WooCommerce في الأصل مواقع مخزون متعددة. يحتفظ وكيل الجرد بخريطة موقع في ذاكرته طويلة المدى تتتبع مستويات المخزون لكل موقع. عندما يعرض WooCommerce الكمية الإجمالية، يعرف الوكيل التوزيع حسب الموقع.

مراقبة نقطة إعادة الطلب: يجري الوكيل عمليات فحص كل ساعة مقابل نقاط إعادة الطلب التي تم تكوينها. عندما تنخفض كمية منتج ما عن نقطة إعادة الطلب، يؤدي ذلك إلى تشغيل إجراء التجديد المناسب استنادًا إلى تكوين مصادر المنتج:

المنتجات من مصادر الموردين: إنشاء أمر شراء في ERP (Odoo، أو QuickBooks، أو إرسال طلب شراء عبر البريد الإلكتروني إلى المورد).
المنتجات المصنعة: يؤدي ذلك إلى تشغيل إشعار تخطيط الإنتاج.
المنتجات التي يتم إسقاطها: التحقق من توفر مخزون المورد من خلال واجهة برمجة تطبيقات المورد (إن وجدت) وتحديث حالة مخزون المنتج وفقًا لذلك.

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 };
  },
});

أتمتة إدارة الاشتراك

بالنسبة لمتاجر WooCommerce التي تستخدم اشتراكات WooCommerce، يضيف الوكيل إدارة ذكية للاشتراكات بالإضافة إلى الإمكانات الأساسية للمكون الإضافي.

فشل استرداد الدفعة: يعتمد منطق إعادة محاولة اشتراكات WooCommerce الأصلي على الوقت. يضيف وكيل OpenClaw الذكاء السلوكي: بالنسبة للعملاء الذين سبق لهم استرداد دفعة فاشلة، تتم إعادة المحاولة الأولى في غضون ساعتين. بالنسبة للعملاء الذين لديهم سجل دفع ثابت في الوقت المحدد، يرسل الوكيل طلبًا مهذبًا لتحديث الدفع قبل محاولة إعادة المحاولة، ويلتقط البطاقات منتهية الصلاحية بشكل استباقي.

التنبؤ بالتوقف عن العمل: يراقب الوكيل إشارات استخدام الاشتراك (لمنتجات SaaS حيث تتوفر بيانات الاستخدام)، وتكرار تسجيل الدخول، ودعم مشاعر التذكرة لإنشاء درجة مخاطر التوقف. تؤدي الاشتراكات عالية المخاطر إلى تحفيز التواصل الاستباقي من فريق CS.

تدفقات الترقية والخفض: عندما يشير سلوك المشترك إلى أنه سيستفيد من مستوى أعلى (الاستخدام المستمر بالقرب من حدود الخطة) أو مستوى أدنى (الاستخدام غير الكافي لخطته باستمرار)، يقوم الوكيل بتشغيل تسلسل توصيات تلقائي بدلاً من انتظار التغيير.

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 };
  },
});

تحسين محركات البحث وتحسين محتوى المنتج

متاجر WooCommerce تعيش وتموت من خلال البحث العضوي. يقوم وكيل تحسين محركات البحث (SEO) بمراقبة تصنيفات المنتجات، وتحديد فجوات المحتوى، وإنشاء أوصاف منتج مُحسّنة تعمل على تحسين إمكانية الاكتشاف دون التضحية بالتحويل.

** مراقبة التصنيف **: يستعلم الوكيل عن Google Search Console API أسبوعيًا لسحب بيانات التصنيف لصفحات المنتج. تؤدي المنتجات التي انخفضت بشكل كبير في التصنيف إلى إجراء تدقيق للمحتوى.

تحسين الوصف: بالنسبة للمنتجات ذات الأوصاف الدقيقة (أقل من 200 كلمة) أو ذات التصنيف الضعيف للكلمات الرئيسية المستهدفة، يقوم الوكيل بإنشاء أوصاف محسنة باستخدام مواصفات المنتج ومراجعات العملاء وتحليل المنافسين. يتم وضع الأوصاف التي تم إنشاؤها في قائمة انتظار المراجعة - ويوافق عليها الإنسان قبل النشر.

تدقيق ترميز المخطط: يتحقق الوكيل من أن صفحات المنتج تحتوي على ترميز مخطط منتج صالح (بما في ذلك السعر والتوفر ومجموعات المراجعة). يتم وضع علامة على المخطط المفقود أو المشوه لتصحيحه من قبل المطور.

تقسيم العملاء وأتمتة التسويق

يقوم وكيل التسويق بتقسيم العملاء على أساس سلوك الشراء وتنظيم الحملات المستهدفة من خلال مزود خدمة البريد الإلكتروني الخاص بك (Mailchimp، Klaviyo، ActiveCampaign).

يتم الحفاظ على شرائح العملاء تلقائيًا:

العملاء الجدد (الشراء الأول خلال 30 يومًا): تسلسل الإعداد، وتعليم المنتج، وحافز الشراء الثاني.
العملاء النشطون (تم الشراء خلال 90 يومًا، أكثر من طلبين): إشعارات مكافآت الولاء، وإعلانات المنتجات الجديدة، وتسلسلات البيع المتبادل.
العملاء المعرضون للخطر (من 90 إلى 180 يومًا منذ آخر عملية شراء): حملات استرداد الأموال مع عروض قوية بشكل متزايد.
العملاء المنقضيون (أكثر من 180 يومًا): محاولة استرداد الأموال النهائية، ثم إلغاء قوائم التسويق النشطة.
العملاء ذوو القيمة العالية (أعلى 10% من حيث القيمة الدائمة): معاملة كبار الشخصيات، والوصول المبكر إلى المنتجات الجديدة، والتواصل الشخصي مع CSM لحسابات B2B.

يتم تحديث تعيينات الشريحة يوميًا عند ظهور أحداث الشراء.

التحليلات وإعداد التقارير

يقوم وكيل التحليلات بتشغيل تقارير ليلية وملء لوحة تحكم الإدارة بما يلي:

الإيرادات اليومية والأسبوعية والشهرية مقارنة بنفس الفترة من العام الماضي
هامش الربح الإجمالي حسب فئة المنتج (يتطلب بيانات التكلفة من حقول تعريف المنتج أو تخطيط موارد المؤسسات)
تكلفة اكتساب العميل من بيانات UTM في الطلبات
معدل التحويل حسب مصدر حركة المرور
متوسط اتجاه قيمة الطلب
معدل الاسترداد وأسبابه
MRR الاشتراك ومعدل زبد

بالنسبة لمتاجر WooCommerce ذات أحجام الطلبات الكبيرة، يستخدم وكيل التحليلات نسخة طبق الأصل للقراءة من قاعدة بيانات WordPress لإعداد التقارير عن الاستعلامات بدلاً من REST API، مما يتجنب التحميل على قاعدة بيانات الإنتاج.

الأسئلة المتداولة

هل يتطلب OpenClaw تثبيت أي مكونات إضافية لـ WordPress؟

ليست هناك حاجة للمكونات الإضافية. يتكامل OpenClaw بالكامل من خلال واجهة REST API المدمجة في WooCommerce ونظام WordPress webhook. الشرط الوحيد هو تمكين WooCommerce REST API (بشكل افتراضي) وإنشاء كلمة مرور التطبيق أو مفتاح عميل API للوكيل. وهذا يعني أنه لا توجد مشكلات في توافق المكونات الإضافية، أو تعارضات في تحديث المكونات الإضافية، أو تكاليف ترخيص إضافية.

كيف يتعامل الوكيل مع متاجر WooCommerce على الاستضافة المشتركة بموارد محدودة؟

تتمتع بيئات الاستضافة المشتركة بحدود أسعار وقيود على الموارد أكثر صرامة من الخوادم المخصصة. يمكن تكوين محول أداة WooCommerce الخاص بـ OpenClaw بحدود معدل متحفظة (5-10 طلبات في الثانية بدلاً من 25) وطلب التجميع للبقاء ضمن قيود الاستضافة. بالنسبة للمتاجر التي يمثل فيها أداء واجهة برمجة التطبيقات (API) مصدر قلق، توصي ECOSIRE بتكوين OpenClaw لاستخدام ساعات خارج أوقات الذروة لعمليات الدُفعات الثقيلة (فحص المخزون، واستعلامات التحليلات) وحجز سعة واجهة برمجة التطبيقات (API) في الوقت الفعلي لمعالجة الطلبات.

هل يمكن لوكيل المخزون المزامنة مع أنظمة إدارة المستودعات الخارجية؟

نعم. يمكن لوكيل الجرد التكامل مع أي WMS يوفر واجهة برمجة التطبيقات (ShipBob، وShipStation، وLinnworks، وBrightpearl، وغيرها). عند تنفيذ طلب في WMS، يتلقى الوكيل حدث التنفيذ، ويقوم بتحديث حالة طلب WooCommerce وتتبعه، ويقوم بتسوية أعداد المخزون. بالنسبة لشركاء 3PL الذين ليس لديهم واجهات برمجة التطبيقات، يمكن للوكيل معالجة تقارير مخزون البريد الإلكتروني أو CSV تلقائيًا.

كيف يعمل نموذج التنبؤ بتوقف الاشتراك في المتاجر الجديدة بدون بيانات تاريخية؟

يبدأ نموذج التغيير بخطوط أساسية متوسطة في الصناعة لفئة أعمالك (SaaS، وصندوق الاشتراك، والمواد الاستهلاكية، وما إلى ذلك) والانتقال إلى النماذج الخاصة بالمتجر مع تراكم بيانات الاشتراك لأكثر من 60 يومًا. خلال الفترة الأساسية، يوفر ECOSIRE تكوينًا لإشارة التوقف بناءً على نوع المنتج الخاص بك وهيكل الاشتراك. يتحسن النموذج تلقائيًا مع ملاحظة النتائج وإعادتها إلى مجموعة التدريب.

ما هو التأثير على أداء WordPress/WooCommerce؟

يعمل OpenClaw خارج WordPress بالكامل. استدعاءات واجهة برمجة التطبيقات (API) من OpenClaw إلى WooCommerce هي طلبات HTTP قياسية تخضع لنفس المعالجة مثل أي عميل API. يمنع محدد المعدل الموجود في محول الأداة الوكيل من إرباك قاعدة بيانات WordPress. بالنسبة للمتاجر ذات حركة المرور العالية (أكثر من 10000 طلب شهريًا)، توصي ECOSIRE بإعداد نسخة طبق الأصل من WordPress وتوجيه استعلامات تحليلات OpenClaw هناك. يتم تشغيل استعلامات معالجة الطلبات في الوقت الفعلي على قاعدة البيانات الأساسية ولكن يتم تخزينها مؤقتًا بشكل كبير.

الخطوات التالية

إن مرونة WooCommerce هي أعظم نقاط قوتها والتحدي التشغيلي الذي يواجهها. يوفر OpenClaw لمتاجر WooCommerce معلومات العمليات التي يحصل عليها تجار Shopify Plus محليًا - دون التخلي عن التحكم والتخصيص الذي يوفره WooCommerce.

تقدم ECOSIRE خدمة تكامل OpenClaw WooCommerce حزمة أتمتة كاملة مصممة خصيصًا لمزيج المنتجات المحدد لمتجرك، وسير العمل التشغيلي، ومجموعة التكنولوجيا. قام فريقنا بدمج OpenClaw مع متاجر WooCommerce التي تتراوح من تجار التجزئة المتخصصين إلى موزعي الأعمال التجارية كبيرة الحجم.

اتصل بـ ECOSIRE لجدولة جلسة اكتشاف أتمتة WooCommerce.

OpenClaw + WooCommerce Integration Guide