OpenClaw + WooCommerce 統合ガイド

WooCommerce は、他のどの e コマースプラットフォームよりも多く、世界中のすべてのオンラインストアの 39% を支えています。その柔軟性と WordPress との緊密な統合により、スタックを制御したい企業にとって最適なプラットフォームとなっています。ただし、その柔軟性には運用の複雑さが伴います。 WooCommerce には、Shopify の独自のワークフローやネイティブの自動化エコシステムがありません。その結果、WooCommerce ストアでは、サブスクリプションプラグイン、ロイヤリティプラグイン、在庫プラグイン、サポートプラグインなど、あらゆる運用上の問題に対するプラグインが蓄積されることが多く、それぞれに独自の管理インターフェイスがあり、データをインテリジェントに共有するプラグインはありません。

OpenClaw は、プラグインのパッチワークを一貫した推論可能な自動化システムに置き換える、WooCommerce 用の統合 AI オペレーションレイヤーを提供します。 REST API、WordPress Webhook、必要に応じて直接データベースアクセスを通じて WooCommerce に接続し、単一のエージェントフレームワークからすべての運用ドメインを調整します。

重要なポイント

OpenClaw は、アプリケーションパスワードを使用して REST API 経由で WooCommerce に接続します。WordPress 側にプラグインをインストールする必要はありません。

Webhook 登録は、自動シークレットローテーションと署名検証を使用して、WooCommerce API を通じてプログラムで処理されます。

Order Automation Agent は、ステータスの遷移、フルフィルメントのルーティング、顧客とのコミュニケーションをエンドツーエンドで処理します。

在庫エージェントは、WooCommerce の場所と外部倉庫全体の在庫を監視し、在庫切れになる前に補充をトリガーします。

サブスクリプション管理の自動化は、失敗した支払いの回復、解約予測、アップグレード/ダウングレードのワークフローを処理します。

SEO エージェントは製品ランキングを監視し、最適化の機会を特定し、最適化された製品説明を生成します。

データベースへの直接アクセス (読み取り専用、リードレプリカ経由) は、REST API では効率的に提供できない分析とレポートに使用されます。

ECOSIRE の OpenClaw WooCommerce 統合サービスは、本番環境にすぐに使える自動化を 4 ～ 6 週間で提供します。

認証と接続のセットアップ

WooCommerce の REST API は、認証に 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
});

Webhook 登録: OpenClaw は、最初の起動時に必要な Webhook を登録し、再起動のたびに検証します。

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 の注文ステータスには、支払い保留中、処理中、保留中、完了、キャンセル、返金、失敗があります。 Order Automation Agent は、各ステップに適用されるビジネスロジックを使用してステータスの遷移を管理します。

保留中→処理中: 支払いゲートウェイ Webhook によって支払いが確認されると、エージェントは注文を処理中に移動し、在庫状況を確認してフルフィルメントを開始します。

処理 → 完了: 倉庫が出荷を確認し、追跡が利用可能になると、エージェントは注文ステータスを更新し、追跡情報をカスタムフィールドとして追加し、顧客に出荷通知を送信します。

支払いの回復の失敗: 支払いが失敗しても、エージェントはすぐには注文をキャンセルしません。代わりに、支払い回復電子メールシーケンス (失敗後 1 時間、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 が全体の数量を表示すると、エージェントは場所ごとの内訳を知ることができます。

再注文ポイントの監視: エージェントは、設定された再注文ポイントに対して 1 時間ごとにチェックを実行します。製品の数量が再注文ポイントを下回ると、製品の調達構成に基づいて適切な補充アクションがトリガーされます。

サプライヤー調達製品: ERP で注文書を作成します (Odoo、QuickBooks、またはサプライヤーへの注文書電子メール)。
製造された製品: 生産計画通知をトリガーします。
ドロップシッピング製品: サプライヤー API (利用可能な場合) を通じてサプライヤーの在庫状況を確認し、それに応じて製品の在庫状況を更新します。

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 エージェントは行動インテリジェンスを追加します。以前に失敗した支払いを取り戻した顧客の場合、最初の再試行は 2 時間以内に行われます。一貫した期日通りの支払い履歴がある顧客の場合、エージェントは再試行する前に丁寧な支払い更新リクエストを送信し、期限切れのカードを積極的にキャッチします。

チャーン予測: エージェントは、サブスクリプションの使用状況シグナル (使用状況データが利用可能な 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 };
  },
});

SEO と製品コンテンツの最適化

WooCommerce ストアはオーガニック検索によって存続し、消滅します。 SEO エージェントは、製品ランキングを監視し、コンテンツのギャップを特定し、コンバージョンを犠牲にすることなく見つけやすさを向上させる最適化された製品説明を生成します。

ランキング監視: エージェントは毎週 Google Search Console API にクエリを実行し、商品ページのランキングデータを取得します。ランキングが大幅に下がった製品はコンテンツ監査の対象となります。

説明の最適化: 説明が薄い (200 単語未満) か、ターゲットキーワードのランキングが低い製品の場合、エージェントは製品の仕様、顧客レビュー、競合他社の分析を使用して改善された説明を生成します。生成された説明はレビューキューに入れられ、公開前に人間が承認します。

スキーママークアップ監査: エージェントは、製品ページに有効な製品スキーママークアップ (価格、在庫状況、レビューの集計を含む) があることを確認します。欠落または不正なスキーマには、開発者による修正のフラグが立てられます。

顧客のセグメンテーションとマーケティングオートメーション

マーケティングエージェントは、購入行動に基づいて顧客をセグメント化し、電子メールサービスプロバイダー (Mailchimp、Klaviyo、ActiveCampaign) を通じてターゲットを絞ったキャンペーンを調整します。

顧客セグメントは自動的に維持されます。

新規顧客 (30 日以内の初回購入): オンボーディングシーケンス、製品教育、2 回目の購入インセンティブ。
アクティブな顧客 (90 日以内に購入、2 回以上の注文): ロイヤリティ特典の通知、新製品の発表、一連のクロスセル。
リスクのある顧客 (最後の購入から 90 ～ 180 日): ますます強力な特典を提供するウィンバックキャンペーン。
失効した顧客 (180 日以上): 最終的な獲得の試み、その後アクティブなマーケティングリストから除外されます。
価値の高い顧客 (生涯価値の上位 10%): VIP 待遇、新製品への早期アクセス、B2B アカウント向けの個人 CSM アウトリーチ。

セグメントの割り当ては、購入イベントが発生すると毎日更新されます。

分析とレポート

Analytics Agent は毎晩レポートを実行し、管理ダッシュボードに次の情報を入力します。

前年同期と比較した日次、週次、月次の収益
製品カテゴリ別の粗利益 (製品メタフィールドまたは ERP からのコストデータが必要)
注文内のUTMデータからの顧客獲得コスト
トラフィックソース別のコンバージョン率
平均注文額の推移
返金率と理由
サブスクリプションの MRR と解約率

注文量が多い WooCommerce ストアの場合、分析エージェントはクエリのレポートに REST API ではなく WordPress データベースのリードレプリカを使用し、運用データベースへの負荷を回避します。

よくある質問

OpenClaw を使用するには、WordPress プラグインをインストールする必要がありますか?

プラグインは必要ありません。 OpenClaw は、WooCommerce の組み込み REST API と WordPress Webhook システムを通じて完全に統合されています。唯一の要件は、WooCommerce REST API が有効になっていて (デフォルトです)、エージェント用にアプリケーションパスワードまたは API コンシューマキーが作成されていることです。これは、プラグインの互換性の問題、プラグインの更新の競合、または追加のライセンス費用がないことを意味します。

エージェントは、限られたリソースで共有ホスティング上の WooCommerce ストアをどのように処理しますか?

共有ホスティング環境には、専用サーバーよりも厳しいレート制限とリソース制限があります。 OpenClaw の WooCommerce ツールアダプターは、控えめなレート制限 (1 秒あたり 25 リクエストではなく 5 ～ 10 リクエスト) で構成し、ホスティングの制約内に収まるようリクエストのバッチ処理を行うことができます。 API パフォーマンスが懸念される店舗の場合、ECOSIRE は、負荷の高いバッチ操作 (在庫チェック、分析クエリ) にはオフピーク時間を使用し、注文処理用にリアルタイム API 容量を予約するように OpenClaw を構成することを推奨します。

在庫エージェントは外部の倉庫管理システムと同期できますか?

はい。 Inventory Agent は、API を提供する任意の WMS (ShipBob、ShipStation、Linnworks、Brightpearl など) と統合できます。 WMS で注文が履行されると、エージェントは履行イベントを受信し、WooCommerce の注文ステータスと追跡を更新し、在庫数を調整します。 API を持たない 3PL パートナーの場合、エージェントは電子メールまたは CSV インベントリレポートを自動的に処理できます。

履歴データのない新しいストアでは、サブスクリプションチャーン予測モデルはどのように機能しますか?

チャーンモデルは、ビジネスカテゴリ (SaaS、サブスクリプションボックス、消耗品など) の業界平均ベースラインから始まり、60 日以上のサブスクリプションデータが蓄積されるにつれて店舗固有のモデルに移行します。ベースライン期間中、ECOSIRE は製品タイプとサブスクリプション構造に基づいてチャーンシグナル構成を提供します。結果が観察され、トレーニングセットにフィードバックされると、モデルは自動的に改善されます。

WordPress/WooCommerce のパフォーマンスへの影響は何ですか?

OpenClaw は完全に WordPress の外部で実行されます。 OpenClaw から WooCommerce への API 呼び出しは、他の API クライアントと同じ処理の対象となる標準 HTTP リクエストです。ツールアダプターのレートリミッターは、エージェントが WordPress データベースに過剰な負荷をかけるのを防ぎます。トラフィックの多い店舗 (月あたり 10,000 件以上の注文) の場合、ECOSIRE は WordPress リードレプリカを設定し、OpenClaw の分析クエリをそこに向けることをお勧めします。リアルタイム注文処理クエリはプライマリデータベースに対して実行されますが、大量にキャッシュされます。

次のステップ

WooCommerce の柔軟性は最大の強みであり、運用上の課題でもあります。 OpenClaw は、WooCommerce が提供する制御とカスタマイズを放棄することなく、Shopify Plus 加盟店がネイティブに取得できる運用インテリジェンスを WooCommerce ストアに提供します。

ECOSIRE の OpenClaw WooCommerce 統合サービスは、店舗の特定の製品構成、運用ワークフロー、テクノロジースタックに合わせて調整された完全な自動化スタックを提供します。私たちのチームは、ブティック専門小売店から大量の B2B ディストリビューターに至るまで、OpenClaw を WooCommerce ストアと統合しました。

ECOSIRE に連絡して、WooCommerce オートメーション検出セッションをスケジュールしてください。

OpenClaw + WooCommerce Integration Guide