Instructions in this file are plain Markdown (no hidden or encoded content).
Bundle version: 1.1.0
Shopify Expert: User Guide
What this skill is
This skill gives your OpenClaw agent structured guidance and bundled excerpts from Shopify official LLM documentation snapshot (regenerated into references/DOC_*.md), plus a hand-curated Admin REST API reference (references/ADMIN_REST_API.md). It covers apps, GraphQL Admin API, REST Admin JSON endpoints, CLI, Polaris, checkout / admin / customer account / POS extensions, Functions, webhooks, metafields, Liquid, themes, Hydrogen / headless, and deployment — at a point in time; always verify against live shopify.dev for your API version.
Not exhaustive: the bundle is not a full mirror of Shopify docs or every changelog. Treat it as entry points + checklists.
Intended role: Knowledge and routing — orient the agent, pick the smallest relevant references/ file, and use bundled text as a starting point. This skill is not a complete offline substitute for shopify.dev; when payloads, fields, or versioning must be exact, use live developer docs (or web tools your gateway allows).
The AI usually talks to Shopify over HTTPS (curl or similar). Broader gateway tools follow your host policy; see {baseDir}/references/OPENCLAW_INTEGRATION.md and {baseDir}/references/SAFETY.md.
No companion plugin (v1)
There is no OpenClaw plugin in v1 — only this skill and optional curl. Prefer documented Admin GraphQL (DOC_ADMIN_API.md), REST (ADMIN_REST_API.md), and CLI patterns; see {baseDir}/references/TOOLING.md and {baseDir}/references/AUTH.md.
Installation (typical)
- 1. Install the skill (ClawHub or
skills/shopify-expert on the gateway host). - Set
SHOPIFY_SHOP_DOMAIN (e.g. your-store.myshopify.com — see {baseDir}/references/AUTH.md). - Allow
curl (and other tools only if your policy permits). - Restart the gateway after skill or env changes if needed.
Details: {baseDir}/README.md, {baseDir}/references/CONNECTING.md, {baseDir}/references/AUTH.md.
What you can expect from the AI
- - Use live shopify.dev when API shape, versions, or compliance matter.
- Confirm the shop context, API version, and access scopes before writes.
- No secrets in chat — env and secret stores only; see
{baseDir}/references/AUTH.md.
Required setup (eligibility)
Per metadata.openclaw.requires:
- 1.
SHOPIFY_SHOP_DOMAIN — Admin / API host suffix, e.g. example.myshopify.com (no https://, no trailing path).
Optional for real API calls: access token and API version — see {baseDir}/references/AUTH.md.
When the agent should use this skill
Use for Shopify development: apps, extensions, Storefront API, Liquid/themes, Hydrogen, webhooks, Functions, metafields, deployment.
Load {baseDir}/references/OVERVIEW.md first, then the smallest matching DOC_*.md, ADMIN_REST_API.md (REST), or other hand-authored file.
Rules for the assistant (summary)
- 1. Version and context first — shop domain, API version, app type (public/custom), and scopes.
- Prefer official GraphQL Admin API, REST Admin API where applicable, and CLI docs over guessing payloads.
- Never echo tokens; reference env names only.
- After tool or env changes, gateway restart may be required.
Where work runs: on the OpenClaw gateway (HTTP to Shopify), not inside Shopify’s runtime unless the user’s setup allows it.
Shopify 专家：用户指南
本技能的功能
本技能为您的 OpenClaw 智能体提供结构化指导和来自 Shopify 官方 LLM 文档快照的捆绑摘录（重新生成为 references/DOC*.md），以及一份精心整理的 Admin REST API 参考文档（references/ADMINRESTAPI.md）。内容涵盖应用、GraphQL Admin API、REST Admin JSON 端点、CLI、Polaris、结账/后台/客户账户/POS 扩展、Functions、Webhooks、元字段、Liquid、主题、Hydrogen/无头架构以及部署——均为特定时间点的快照；请务必对照 shopify.dev 上的最新内容验证您的 API 版本。
非详尽说明： 本捆绑包并非 Shopify 文档或所有变更日志的完整镜像。请将其视为入口点 + 检查清单。
预期角色： 知识导航与路由——为智能体提供方向指引，选择最小的相关 references/ 文件，并将捆绑文本作为起点。本技能不能完全替代 shopify.dev 的离线使用；当需要精确的负载、字段或版本信息时，请使用在线开发者文档（或您的网关允许的 Web 工具）。
AI 通常通过 HTTPS（curl 或类似工具）与 Shopify 通信。更广泛的网关工具遵循您的主机策略；请参阅 {baseDir}/references/OPENCLAW_INTEGRATION.md 和 {baseDir}/references/SAFETY.md。
无配套插件（v1 版本）
v1 版本没有 OpenClaw 插件——仅包含本技能和可选的 curl。建议优先使用有文档支持的 Admin GraphQL（DOCADMINAPI.md）、REST（ADMINRESTAPI.md）和 CLI 模式；请参阅 {baseDir}/references/TOOLING.md 和 {baseDir}/references/AUTH.md。
安装（典型流程）
- 1. 安装本技能（通过 ClawHub 或网关主机上的 skills/shopify-expert）。
- 设置 SHOPIFYSHOPDOMAIN（例如 your-store.myshopify.com——请参阅 {baseDir}/references/AUTH.md）。
- 允许 curl（以及其他工具，但需符合您的策略）。
- 如有必要，在技能或环境变量更改后重启网关。
详细信息：{baseDir}/README.md、{baseDir}/references/CONNECTING.md、{baseDir}/references/AUTH.md。
您对 AI 的预期
- - 当 API 结构、版本或合规性重要时，使用在线 shopify.dev。
- 在写入操作前确认商店上下文、API 版本和访问范围。
- 聊天中不透露密钥——仅使用环境变量和密钥存储；请参阅 {baseDir}/references/AUTH.md。
必要设置（资格要求）
根据 metadata.openclaw.requires：
- 1. SHOPIFYSHOPDOMAIN——Admin/API 主机后缀，例如 example.myshopify.com（不含 https://，不含尾部路径）。
实际 API 调用可选：访问令牌和 API 版本——请参阅 {baseDir}/references/AUTH.md。
智能体何时使用本技能
用于 Shopify 开发：应用、扩展、Storefront API、Liquid/主题、Hydrogen、Webhooks、Functions、元字段、部署。
首先加载 {baseDir}/references/OVERVIEW.md，然后加载最小的匹配 DOC*.md、ADMINREST_API.md（REST）或其他手动编写的文件。
助手规则（摘要）
- 1. 版本和上下文优先——商店域名、API 版本、应用类型（公开/自定义）和范围。
- 优先使用官方 GraphQL Admin API、REST Admin API（适用时）和 CLI 文档，而非猜测负载。
- 绝不回显令牌；仅引用环境变量名称。
- 工具或环境变量更改后，可能需要重启网关。
运行位置： 在 OpenClaw 网关上运行（通过 HTTP 连接 Shopify），除非用户设置允许，否则不在 Shopify 运行时内部运行。
