连接 WooCommerce 商店

将 WooCommerce 商店接入 StoreClaw 后，AI 可以直接读取订单、商品、库存、客户等数据，用于分析、运营决策支持与定时任务。本文适用于 自托管（Self-Hosted）WooCommerce 商店。

为什么需要连接 WooCommerce

连接成功后，StoreClaw 可以在授权范围内执行以下工作：

• 订单分析： 读取订单列表、订单状态与时间区间数据，生成销售趋势分析。
• 商品与库存管理： 查询商品、SKU、库存数量，识别低库存和补货风险。
• 客户洞察： 读取客户列表与消费历史，辅助做客户分层和复购分析。
• 自动化任务： 将 WooCommerce 数据接入定时任务，让日报、周报和预警基于真实业务数据运行。

接入前请先确认

StoreClaw WooCommerce Connector 仅支持标准自托管环境，即您在自己的服务器或第三方主机商上独立安装 WordPress + WooCommerce 的部署方式。

部署方式	是否支持	说明
自托管服务器（VPS / 独立服务器）	支持	完整支持，按本文操作即可
托管主机商（WP Engine / Kinsta / SiteGround 等）	支持	本质仍为自托管，操作路径相同
Bluehost / HostGator 等共享主机	支持	只要拥有 wp-admin 权限即可
WordPress.com Business 计划	不支持	外部 REST API 认证机制不兼容
WordPress.com eCommerce 计划	不支持	与标准 WooCommerce 自托管环境不同

如果您登录后台的入口是 wordpress.com/home，或商店虽然绑定了自定义域名，但后台仍在 wordpress.com 体系中，通常不属于当前支持范围。

接入前提条件

请确保您的 WooCommerce 环境满足以下要求：

• WooCommerce 版本为 6.0+
• 商店可以通过公网访问
• WordPress 已启用固定链接，且不是“朴素”模式
• 服务器未屏蔽外部对 /wp-json/ 的访问
• 商店未额外开启 HTTP Basic Auth 二次密码保护

获取 WooCommerce 连接信息

在 StoreClaw 中连接 WooCommerce 时，您需要准备以下三项信息：

字段	示例格式	说明
Store URL	https://your-store.com	WooCommerce 商店根域名，建议使用 HTTPS
Consumer Key	ck_xxxxxxxxxx...	以 ck_ 开头的 REST API Key
Consumer Secret	cs_xxxxxxxxxx...	以 cs_ 开头的 REST API Secret

获取 WooCommerce REST API Key

StoreClaw 使用 WooCommerce 内置 REST API 完成授权，无需额外安装插件。

步骤一：进入 REST API 管理页面

1. 登录 WordPress 后台：https://your-store.com/wp-admin
2. 在左侧菜单进入 WooCommerce → 设置
3. 打开顶部的 高级（Advanced） 选项卡
4. 进入子菜单 REST API

您也可以直接访问以下路径：

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

步骤二：创建新的 API Key

1. 点击右上角 Add key（添加密钥）
2. 在 Description（描述） 中建议填写 StoreClaw
3. 在 User（用户） 中选择一个具有管理员权限的 WordPress 用户
4. 在 Permissions（权限） 中选择所需权限：
   • 如果希望 StoreClaw 只读分析数据，选择 Read
   • 如果希望 StoreClaw 可执行店内操作，选择 Read/Write
5. 点击 Generate API key（生成 API key）

重要： Consumer Secret 只会在生成页展示一次。请立即复制并保存。如果未保存，只能删除旧密钥后重新生成。

步骤三：确认密钥格式

生成后的密钥通常符合以下格式：

• Consumer Key 固定以 ck_ 开头
• Consumer Secret 固定以 cs_ 开头
• 两串密钥都是较长的随机字符串，复制时请确保首尾没有空格

示例

Consumer Key:    ck_a1b2c3d4e5f6g7h8i9j0k1l2m3n4o5p6q7r8
Consumer Secret: cs_z9y8x7w6v5u4t3s2r1q0p9o8n7m6l5k4j3i2

在 StoreClaw 中完成接入

1. 在 StoreClaw 左侧导航栏点击 连接器
2. 在连接器列表中找到 WooCommerce
3. 点击右侧的 + 按钮
4. 填写以下字段：
   • 店铺网址： https://your-store.com
   • Consumer Key： 粘贴以 ck_ 开头的密钥
   • Consumer Secret： 粘贴以 cs_ 开头的密钥
5. 点击 连接 WooCommerce
6. 连接成功后，卡片状态将变为 已连接

Store URL 填写规范

Store URL 必须是商店根域名，请参考以下示例：

示例	是否正确	说明
https://your-store.com	正确	推荐填写方式
https://your-store.com/	正确	末尾斜杠会自动处理
http://your-store.com	可用但不推荐	建议升级为 HTTPS
https://your-store.com/shop	错误	不要带子路径
https://your-store.com/wp-admin	错误	不要填写后台地址

接入后可用功能

成功连接后，StoreClaw 可在授权范围内调用以下能力：

工具模块	可用能力
订单同步	获取订单列表、订单详情、订单状态，按时间或状态筛选
商品管理	查询商品、变体、SKU、价格、描述与分类
库存管理	查看库存、识别低库存商品，必要时更新库存
客户洞察	获取客户列表、消费历史与客户分层信息

示例指令

• 帮我分析最近 30 天 WooCommerce 店铺的订单趋势
• 检查低库存商品，列出需要优先补货的 SKU
• 统计复购客户占比，并按消费金额做简单分层

连接失败？常见问题排查

Q1：提示 Connection failed 或 401 Unauthorized

请重点检查以下几项：

• Consumer Key 和 Consumer Secret 是否完整复制，首尾无空格
• 生成密钥时选择的用户是否具有 Administrator 或 Shop Manager 权限
• WooCommerce REST API 页面中的密钥状态是否为 Active

Q2：提示 Store URL is not reachable 或 404

可以按下面顺序检查：

• 确认 Store URL 填写的是根域名，而不是 /wp-admin 或其他子路径
• 访问 https://your-store.com/wp-json/wc/v3/system_status
• 如果返回 JSON，说明 REST API 正常
• 如果返回 404，请检查固定链接配置，并在 设置 → 固定链接 中点击一次 保存更改

Q3：出现 403 Forbidden 或 REST API 被禁用

常见原因包括：

• 安全插件（如 Wordfence、iThemes Security）限制了 REST API
• .htaccess 或 Nginx 配置屏蔽了 /wp-json/
• 防火墙、CDN 或服务器策略阻止了外部请求

Q4：商店启用了 HTTP Basic Auth

部分测试环境会在 WooCommerce 前增加一层基础认证。当前 StoreClaw 不支持在 WooCommerce REST API 之外再叠加 Basic Auth，因此请使用未开启该保护的正式环境接入。

Q5：可以连接多个 WooCommerce 商店吗？

可以。您可以在 Connectors 页面多次点击 WooCommerce 的 + 按钮，为每个商店分别填写独立的 Store URL、Consumer Key 和 Consumer Secret。

安全建议

为降低密钥风险，建议遵循以下做法：

• 仅为 StoreClaw 单独创建一对 API Key，不与其他系统共用
• 如仅需读取数据，优先使用 Read 权限
• 如怀疑密钥泄露，立即在 WooCommerce 后台 Revoke 旧密钥并重新生成
• 定期检查 WooCommerce REST API 日志，确认无异常请求

常见问题 (FAQ)