连接 Shopify 店铺

连接店铺后，StoreClaw 可在授权范围内读取 Shopify 订单、库存、商品、客户等数据，用于分析、简报和定时任务。本文说明如何创建 Shopify 自定义应用并完成连接。

在当前版本中，Shopify 连接器通过对应的插件进行管理。请先安装 Shopify 插件，再进入插件详情页，在连接器区域连接店铺。

适合的工作流

• 商品、订单、库存和客户数据分析。
• 折扣、促销、SEO 和店铺内容优化。
• 围绕独立站生成日常经营简报和异常诊断。

为什么需要连接店铺

连接店铺后，StoreClaw 可以基于实际业务数据执行相关任务：

• 数据分析： StoreClaw 将基于已授权的订单、库存和流量数据生成分析结果。
• 定时任务： 连接数据源后，定时任务 才能按计划检查店铺指标并生成提醒。

通过 Shopify OAuth 授权连接

1. 登录 StoreClaw，安装 Shopify 插件，或打开 Shopify 插件详情页，点击 安装。
2. 在连接器区域找到 Shopify，点击 连接。
3. 在弹窗中输入你的店铺域名。

   注意：通过当前方式授权 Shopify 店铺连接，需要安装 StoreClaw 扩展，如未安装，点击页面的 去安装 即可。

4. 点击 连接 Shopify。
5. 使用需要连接的 Shopify 账号登录。
6. 在 Shopify 授权页面确认授权范围后，点击同意授权。
7. 授权完成后，页面会自动返回 StoreClaw。
8. 回到 StoreClaw 后，确认 Shopify 账号在插件详情页显示为 已连接。

可选方式：通过 Shopify API 凭证连接店铺

获取 Shopify API 凭据

由于 Shopify 的安全性要求，您需要以“自定义应用”的方式授权 StoreClaw。请按照以下步骤获取 Client ID 和 Client Secret。

步骤一：在 Shopify 后台启动应用开发

1. 登录 Shopify 后台，进入 设置 -> 应用。
2. 点击 开发应用，然后点击页面右上角的 在 Dev Dashboard 中创建应用。
3. 系统将自动跳转至 Shopify dev dashboard（开发者控制台）。

步骤二：在开发者控制台中创建应用

1. 进入 Shopify dev dashboard，点击 创建应用。
2. 选择 从 Dev Dashboard 开始，输入应用名称，点击 创建。

步骤三：配置应用权限与设置

1. 继续完成应用的配置流程，找到 应用 URL，填入我们的地址：https://www.storeclaw.ai/app/connectors?platform=shopify

2. 取消勾选 内嵌至 Shopify app 选项框。

3. 

4. 在 访问权限 部分，点击 选择权限范围。

5. 勾选所需权限项。点击 完成。

   StoreClaw 的操作范围由您勾选的权限决定。 勾选了哪些 scope，StoreClaw 就能执行哪些对应操作；未勾选的操作，StoreClaw 执行时将提示权限不足。建议仅勾选当前任务需要的权限。

   以下是常见权限与对应能力的参考：

   权限代码	勾选后 StoreClaw 可以做	未勾选则不能做
   read_orders	查询订单、分析销售趋势、生成销售报表	无法获取任何订单数据
   write_orders	更新订单状态、备注	只能查看订单，无法修改
   read_products	查询产品信息、分析选品表现	无法读取产品数据
   write_products	修改产品标题、描述、价格、上下架	只能查看产品，无法编辑
   read_inventory	查询库存数量、触发补货预警	无法获取库存数据
   write_inventory	调整库存数量	只能查看库存，无法修改
   read_analytics	获取店铺流量、转化等分析数据	无法读取 Shopify 内置分析报告
   read_customers	分析客户画像、查询客户历史	无法获取客户信息
   read_shopify_payments_payouts	查询收款与提现记录	无法获取支付流水数据

6. 点击 发布，在弹出的确认窗口中再次点击 发布。

步骤四：在店铺中安装应用

1. 发布成功后，点击左侧导航栏的应用名称，进入应用详情页。

2. 在 概览 页点击右上角的 安装应用，系统会跳转至 Shopify 商户后台。

3. 选择要安装的店铺，在确认页面点击 安装。

4. 安装完成后会自动跳转回到 StoreClaw 页面。

   提示： 除 Shopify Plus 用户外，每个自定义应用只能安装到一家店铺。如果您有多家店铺需要连接 StoreClaw，请为每家店铺分别在 Shopify dev dashboard 中创建一个独立应用，重复本流程完成安装。

步骤五：提取 API 凭据

1. 应用安装完成后，返回 Shopify dev dashboard。
2. 进入该应用的详情页，点击左侧菜单的 设置。
3. 在 凭据 部分，获取 客户端 ID 和 加密秘钥（点击 眼睛 图标即可查看密钥内容）。

在 StoreClaw 中完成配置

1. 进入 Shopify 插件： 在 StoreClaw 中安装 Shopify 插件，或打开 Shopify 插件详情页。
2. 打开连接表单： 在连接器区域找到 Shopify，点击 连接。
3. 在弹窗中找到 高级设置，点击展开。
4. 点击 手动授权 后的 手动配置。
5. 填写字段：
   • 店铺域名: 您的店铺后台地址（例如：your-store.myshopify.com）。
   • Client ID: 填入刚才获取的 API key。
   • Client Secret: 填入刚才获取的 API secret key。
6. 激活连接： 点击 连接 Shopify。
7. 验证状态： 连接成功后，该店铺会在插件详情页显示为已连接。

连接失败？常见问题排查

如连接未成功，请检查以下常见问题：

问题现象	可能原因	解决方法
提示凭据错误	Client ID 或 Client Secret 填写错误	确认复制的是完整的 API key 和 API secret key，注意不要包含多余空格
提示权限不足	权限未发布或未安装应用	返回 Shopify dev dashboard，确保已点击 发布 并完成 安装应用 步骤

应用场景

连接成功后，您可以在对话中直接向 StoreClaw 发送指令。以下是一些常用示例——能否执行成功取决于您在步骤三中开放的权限范围，未授权的操作 StoreClaw 会提示权限不足。

所需权限	示例指令
read_orders	帮我分析一下最近 7 天的订单趋势
read_inventory	检查一下库存，列出需要补货的商品
read_customers	分析一下我的客户画像

常见问题 (FAQ)