Connect a WooCommerce Store连接 WooCommerce 商店

After you connect a WooCommerce store to StoreClaw, AI can read orders, products, inventory, customers, and related data to support analysis, operational decisions, and scheduled tasks. This guide is intended for self-hosted WooCommerce stores.

Why Connect WooCommerce

After the connection is completed, StoreClaw can perform work such as:

• Order analysis: Read order lists, order statuses, and date-range data to generate sales trend analysis.
• Product and inventory management: Read products, SKUs, and stock quantities to identify low-stock and restocking risks.
• Customer insights: Read customer lists and purchase history to support segmentation and repeat-purchase analysis.
• Automation tasks: Use WooCommerce data in scheduled tasks so daily reports, weekly reports, and alerts are based on real business data.

Before You Start

StoreClaw's WooCommerce Connector currently supports only standard self-hosted environments, meaning WordPress and WooCommerce are installed on your own server or on third-party hosting that you control.

Deployment type	Supported	Notes
Self-hosted server (VPS / dedicated server)	Supported	Fully supported. Just follow this guide.
Managed hosting (WP Engine / Kinsta / SiteGround, etc.)	Supported	Still self-hosted in practice, with the same setup path.
Shared hosting (Bluehost / HostGator, etc.)	Supported	Works as long as you have wp-admin access.
WordPress.com Business plan	Not supported	External REST API authentication is not compatible.
WordPress.com eCommerce plan	Not supported	Different from a standard self-hosted WooCommerce environment.

If your admin entry point is wordpress.com/home, or your site uses a custom domain but the admin still runs inside the wordpress.com platform, it is usually outside the currently supported scope.

Prerequisites

Make sure your WooCommerce environment meets the following requirements:

• WooCommerce version 6.0+
• The store is publicly reachable over the internet
• WordPress permalinks are enabled and are not using the "Plain" mode
• Your server does not block external access to /wp-json/
• The store is not protected by an extra HTTP Basic Auth layer

WooCommerce Connection Information You Need

To connect WooCommerce in StoreClaw, prepare the following three values:

Field	Example format	Description
Store URL	https://your-store.com	The root domain of your WooCommerce store. HTTPS is recommended.
Consumer Key	ck_xxxxxxxxxx...	A REST API key that starts with ck_
Consumer Secret	cs_xxxxxxxxxx...	A REST API secret that starts with cs_

Get WooCommerce REST API Keys

StoreClaw uses WooCommerce's built-in REST API for authorization, so no additional plugin is required.

Step 1: Open the REST API Management Page

1. Sign in to WordPress Admin: https://your-store.com/wp-admin
2. In the left menu, go to WooCommerce -> Settings
3. Open the Advanced tab at the top
4. Open the REST API submenu

You can also open the page directly with this path:

https://your-store.com/wp-admin/admin.php?page=wc-settings&tab=advanced&section=keys

Step 2: Create a New API Key

1. Click Add key
2. In Description, it is recommended to enter StoreClaw
3. In User, choose a WordPress user with admin-level access

4. In Permissions, choose the access level you need:

   • If you only want StoreClaw to read data for analysis, choose Read
   • If you want StoreClaw to perform store-side operations, choose Read/Write
5. Click Generate API key

Step 3: Confirm the Key Format

Generated keys usually follow this format:

• Consumer Key always starts with ck_
• Consumer Secret always starts with cs_
• Both values are long random strings, so make sure you do not copy extra spaces at the beginning or end

Example:

Consumer Key:    ck_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8
        Consumer Secret: cs_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4j3i2

Complete the Setup in StoreClaw

1. In the left navigation of StoreClaw, click Connectors
2. Find WooCommerce in the connector list
3. Click the + button on the right

4. Fill in the following fields:

   • Store URL: https://your-store.com
   • Consumer Key: Paste the key that starts with ck_
   • Consumer Secret: Paste the secret that starts with cs_
5. Click Connect WooCommerce
6. After the connection succeeds, the card status changes to Connected

Store URL Format Rules

Store URL must be the root domain of the store. Use the examples below as a reference:

Example	Correct	Notes
https://your-store.com	Correct	Recommended format
https://your-store.com/	Correct	A trailing slash is handled automatically
http://your-store.com	Works but not recommended	HTTPS is recommended
https://your-store.com/shop	Incorrect	Do not include subpaths
https://your-store.com/wp-admin	Incorrect	Do not enter the admin URL

What Becomes Available After Connection

After the connection succeeds, StoreClaw can use WooCommerce capabilities such as:

Module	Available capability
Order Sync	Read order lists, order details, and order statuses, with filtering by date or status
Product Management	Read products, variants, SKUs, prices, descriptions, and categories
Inventory Management	Check stock levels, identify low-stock products, and update inventory when needed
Customer Insights	Read customer lists, purchase history, and basic segmentation data

Example Prompts

• Analyze my WooCommerce order trends for the last 30 days.
• Check low-stock products and list the SKUs that should be restocked first.
• Calculate the repeat customer rate and group customers by spending level.

Connection Failed? Common Troubleshooting

Q1: Connection failed or 401 Unauthorized

Check the following first:

• Make sure Consumer Key and Consumer Secret were copied completely, with no extra spaces
• Make sure the selected WordPress user has the Administrator or Shop Manager role
• Make sure the key status is Active on the WooCommerce REST API page

Q2: Store URL is not reachable or 404

Check the following in order:

• Make sure Store URL is the root domain and not /wp-admin or another subpath
• Open https://your-store.com/wp-json/wc/v3/system_status
• If it returns JSON, the REST API is working normally
• If it returns 404, check your permalink configuration and click Save Changes once under Settings -> Permalinks

Q3: 403 Forbidden or REST API Disabled

Common causes include:

• Security plugins such as Wordfence or iThemes Security blocking REST API access
• .htaccess or Nginx rules blocking /wp-json/
• Firewall, CDN, or server policies blocking external requests

Q4: The Store Uses HTTP Basic Auth

Some test environments add an extra Basic Auth layer in front of WooCommerce. StoreClaw currently does not support combining WooCommerce REST API authentication with an additional Basic Auth layer, so use a production environment without this protection enabled.

Q5: Can I connect multiple WooCommerce stores?

Yes. On the Connectors page, you can add WooCommerce multiple times and provide a separate Store URL, Consumer Key, and Consumer Secret for each store.

Security Recommendations

To reduce key-related risk, follow these practices:

• Create a dedicated API key pair for StoreClaw only and do not share it with other systems
• If you only need data access, prefer the Read permission
• If you suspect the key is compromised, revoke it in WooCommerce immediately and generate a new one
• Review WooCommerce REST API logs regularly for unusual requests

FAQ

Consumer Key:    ck_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8
        Consumer Secret: cs_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4j3i2