安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install shopify-admin-pro
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 shopify-admin-pro。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

Shopify Admin Pro 让 OpenClaw 能够通过 Admin GraphQL API，以受控方式检查和管理 Shopify 商店。它支持产品、库存、订单、履约、退款、折扣、客户、主题和批量编辑工作流程，同时仅使用您授予的访问权限范围。对于比较 Shopify 运营类 Openclaw Skills 的团队而言，其核心价值在于：安全检查由单一 Python 辅助程序强制执行，而非仅依赖惯例。
读取和导出操作与写入操作相互分离。每次变更在发送前都会预览，每项变更都需要明确批准，高风险操作还需要再次进行精确确认。此技能还避免盲目重试写入，保留不含 PII 的审计记录，可按要求屏蔽个人数据，并且只会将凭据发送到您自己的 Shopify 商店。目前尚未在真实商店中测试经确认的实时写入，因此首次写入应是在开发商店中进行低风险变更。

应用场景

执行开店前审计、每日运营简报、商店健康状况检查或低库存报告。
检查产品、变体、产品系列、SEO、媒体、库存、订单、履约、客户、折扣和主题。
使用 Shopify 的异步批量查询工作流程导出商品目录或订单历史，以供分析。
对产品、库存、订单备注、履约、折扣、客户、页面、重定向或主题进行审核后的更新。
通过检查订单并在请求批准前计算金额，准备退款或取消操作。
分批执行经过审核的商品目录批量编辑，先展示样例和准确的变更数量。
仅授予读取权限范围以保持任务只读；如果不需要写入能力，则使用独立的 shopify-audit-pro skill。

工作原理

辅助程序从主机的隐藏式 secrets 条目，或可选的受保护文件 ~/.openclaw/secrets/shopify.env 中加载 Shopify 凭据；它绝不会在聊天中索取或打印机密信息。
它会在内存中将客户端凭据交换为有效期 24 小时的令牌，并将令牌使用范围限制为已配置的 .myshopify.com 域名。
对于读取操作，query 用于单项查询，paginate 用于多页结果，bulk-query 用于启动 Shopify 异步批量导出。读取命令会拒绝包含 mutations 或 subscriptions 的文档。
变更前，代理会读取目标对象并提出具体更新方案。不带 --confirm 运行 mutate 会生成预览，其中显示 mutation 名称、风险等级和变量；不会发送任何内容。
用户明确批准变更后，辅助程序才会发送一条 mutation。高风险操作还必须使用预览中显示的准确名称提供 --confirm-high-risk。
辅助程序会将 Shopify userErrors 视为失败，不会盲目重试结果不确定的写入失败；仅对节流响应等能够证明操作未执行的情况重试。
写入成功后，代理会重新读取对象并报告已验证的结果。每次调用都会追加到不含 PII 的审计日志；--redact-pii 会在命令输出中屏蔽个人信息。

配置指南

在拥有该商店的同一 Shopify 组织下的 Shopify Dev Dashboard 中创建应用，选择所需权限范围，发布应用版本并将其安装到商店。客户端凭据授权无法跨组织使用。2026 年之前创建的旧版应用可能使用静态访问令牌。
从只读权限范围开始。仅在任务需要时添加所需的 write_* 权限范围，然后发布并批准更新后的应用版本。可考虑为不同权限级别使用不同应用。
通过主机的隐藏式 secrets 工具提供凭据。在没有注入 secrets 的节点主机上，可使用隐藏输入自行创建可选 env 文件，并将其权限限制为 600。绝不要在聊天中输入凭据，也不要让代理使用机密值创建文件。
mkdir -p ~/.openclaw/secrets
chmod 700 ~/.openclaw/secrets

使用隐藏输入安全地创建 ~/.openclaw/secrets/shopify.env。

chmod 600 ~/.openclaw/secrets/shopify.env
使用客户端凭据时，文件应包含 SHOPIFY_STORE_DOMAIN、SHOPIFY_CLIENT_ID 和 SHOPIFY_CLIENT_SECRET。辅助程序只读取 SHOPIFY_* 键。此 skill 需要 python3；其辅助程序使用 Python 标准库，不会安装软件包。使用 shopify scopes 和 shopify versions 验证配置。
shopify scopes
shopify versions
shopify --version
使用 {baseDir}/scripts/shopify_api.py 中的辅助程序（命令示例中简称为 shopify）。

数据架构

此 skill 使用 Shopify 的 Admin GraphQL API；它不定义单独的本地业务数据数据库。
数据或文件 用途和处理方式
~/.openclaw/secrets/shopify.env 可选的用户创建凭据文件；权限必须为 600。辅助程序只读取 SHOPIFY_* 键。令牌在内存中交换，不会写入磁盘或记录到日志。
~/.openclaw/logs/shopify-audit.jsonl 仅追加的审计记录，权限为 600。记录时间、商店、API 版本、mutation 名称、负载哈希和错误数量；不包含令牌和客户数据。
查询文件（.graphql、.gql、.txt） 使用 --file 提供的可选 GraphQL 文档。
变量文件（.json） 使用 --vars-file 提供的可选 GraphQL 变量。
批量导出输出 使用 --out 指定的新文件，通常为 JSONL。绝不覆盖现有文件。批量结果只从 https://storage.googleapis.com 下载，不会向该主机发送凭据。
Shopify 对象 根据应用获授的权限范围访问产品、变体、产品系列、库存、订单、履约、客户、折扣、主题和其他资源。
命令成功时返回退出代码 0，出错或拒绝文档时返回 1，需要确认且未发送任何内容时返回 2，Shopify 返回 userErrors 且操作未应用时返回 3。报告应区分 API 证据、屏幕证据和推断，并注明与权限范围相关的可见性限制，例如较早的订单可能需要 read_all_orders。

高级特性

预览优先的变更：
写入通过单一
mutate
命令执行，每次调用只执行一个操作，并且预览后必须使用 --confirm 。
高风险操作精确确认：
删除、退款、取消、收款、撤销、发布主题、编辑主题文件、编辑政策、账单、付款、礼品卡及相关敏感操作，必须使用预览中显示的准确确认名称。
GraphQL 防护检查：
读取命令会在去除注释和字符串后拒绝 mutations 和 subscriptions；mutation 解析也会阻止利用片段进行规避的模式。
审慎的失败处理：
网络或服务器失败情况不明确时，停止操作，不重试写入。即使 HTTP 响应为 200，Shopify
userErrors
仍视为失败。
权限范围访问：
只能使用已获授的 Shopify 权限范围；建议先采用只读权限，仅在需要时添加写入权限范围。
多种读取策略：
query
进行查询，使用
paginate
获取分页结果，使用异步
bulk-query
执行大型导出。授予
read_reports
后，可通过
shopifyqlQuery
使用 ShopifyQL 分析。
PII 感知操作： --redact-pii 会在输出中屏蔽姓名、电子邮件地址、电话号码和地址。客户信息不应复制到记忆文件、群聊或日志中。
运营操作手册：
支持开店前审计、每日简报、退款、附带追踪信息的履约、商品目录批量更新以及通过电子表格创建产品等工作流程。
可逆变更实践：
批处理工作流程应说明数量和样例，优先选择草稿或归档而非删除，并保留变更前后的值以便回滚。
版本感知的架构使用：
使用未知字段或输入重试前，先检查实时 API 架构，因为 Shopify 架构可能因 API 版本而异。
权限范围与证据透明度：
报告应说明应用能够和无法访问的内容，标明证据来源，并逐字报告实际 API 错误。
测试状态披露：
读取、权限范围检查、分页、批量查询和 mutation 防护均已测试；尚未在真实商店中执行经确认的实时写入。

name: shopify-admin-pro description: "Guarded Shopify Admin for OpenClaw: everything shopify-audit-pro does, plus acting as the store admin. Safety first: nothing is written without a preview and your explicit confirmation, delete/refund/cancel/publish and other high-risk actions need a second exact confirmation, a failed write is never blindly retried, your token goes only to your own *.myshopify.com store (no relay, no third-party plugin), secrets are never typed in chat, and a PII-free audit log records every call. Then the admin power: audits and reports, plus products, inventory, orders, fulfillment, refunds, discounts, customers, themes and bulk edits via the Admin GraphQL API. Only the scopes you grant are usable."