本文件中的说明为纯 Markdown 格式（不含隐藏或编码内容）。

捆绑包版本： 1.1.0

Shopify 专家：用户指南

该技能的作用

本技能为您的 OpenClaw agent 提供结构化指引，以及来自Shopify 官方 LLM 文档快照的精选片段合集（已重新生成至 references/DOC_*.md），另附人工整理的Admin REST API 参考文档（references/ADMIN_REST_API.md）。内容涵盖应用（apps）、GraphQL Admin API、REST Admin JSON 接口、CLI、Polaris、结账 / 后台管理 / 客户账户 / POS 扩展、Functions、webhooks、metafields、Liquid、主题（themes）、Hydrogen / 无头架构（headless） 以及部署等——但均为某一特定时间点的快照；请始终以您所用 API 版本对应的实时 shopify.dev 文档为准并进行核验。

非穷尽性说明： 本捆绑包并非 Shopify 全部文档或所有变更日志的完整镜像。请将其视为入口点 + 检查清单。

预期角色：知识支持与路由引导 —— 帮助 agent 快速定位上下文，选取最小且相关的 references/ 文件，并将捆绑文本作为起点。本技能不能替代实时的 shopify.dev 文档；当请求体（payload）、字段或版本号必须精确时，请使用在线开发者文档（或网关允许的 Web 工具）。

AI 通常通过HTTPS（如 curl 或类似工具）与 Shopify 通信。更广泛的网关工具则遵循您的主机策略；详见 {baseDir}/references/OPENCLAW_INTEGRATION.md 和 {baseDir}/references/SAFETY.md。

无配套插件（v1 版本）

v1 版本中没有 OpenClaw 插件 —— 仅含本技能及可选的curl。优先采用已文档化的 Admin GraphQL（DOC_ADMIN_API.md）、REST（ADMIN_REST_API.md）和 CLI 使用模式；详见 {baseDir}/references/TOOLING.md 和 {baseDir}/references/AUTH.md。

安装（典型流程）

1. 安装该技能（通过 ClawHub 或在网关主机上安装 skills/shopify-expert）。
2. 设置 SHOPIFY_SHOP_DOMAIN（例如 your-store.myshopify.com —— 参见 {baseDir}/references/AUTH.md）。
3. 启用 curl（其他工具仅在您的策略允许时方可启用）。
4. 若修改了技能或环境变量，可能需重启网关。

详细信息参见：{baseDir}/README.md、{baseDir}/references/CONNECTING.md、{baseDir}/references/AUTH.md。

您可对 AI 的预期表现

• 当涉及 API 结构、版本或合规性要求时，使用实时 shopify.dev 文档。
• 执行写入操作前，务必确认店铺上下文、API 版本及访问权限范围（access scopes）。
• 聊天中不暴露密钥 —— 密钥仅存储于环境变量或密钥库中；参见 {baseDir}/references/AUTH.md。

必需配置（准入条件）

依据 metadata.openclaw.requires 要求：

1. SHOPIFY_SHOP_DOMAIN —— 管理后台 / API 主机后缀，例如 example.myshopify.com（不含 https://，也不含尾部路径）。

如需实际调用 API，还需可选配置：访问令牌（access token）与 API 版本 —— 详见 {baseDir}/references/AUTH.md。

Agent 应何时使用本技能

适用于Shopify 开发场景：应用（apps）、扩展（extensions）、Storefront API、Liquid / 主题（themes）、Hydrogen、webhooks、Functions、metafields、部署等。

请首先加载 {baseDir}/references/OVERVIEW.md，再按需加载最小匹配的 DOC_*.md、ADMIN_REST_API.md（REST）或其他人工编写的参考文件。

助手须遵守的规则（摘要）

1. 优先明确版本与上下文 —— 包括店铺域名、API 版本、应用类型（public/custom）及权限范围（scopes）。
2. 在可行前提下，优先采用官方 GraphQL Admin API 与REST Admin API，并参考 CLI 文档，而非猜测请求体（payload）结构。
3. 严禁在输出中回显令牌（token）；仅引用环境变量名称。
4. 修改工具或环境变量后，可能需要重启网关。

工作执行位置： 在OpenClaw 网关上运行（通过 HTTP 与 Shopify 通信），而非 Shopify 运行时环境内 —— 除非用户自身配置明确支持后者。