适用于 Openclaw 的 Shopify Runtime Toolkit

一个功能强大的工具包，提供对单个 Shopify 商店的直接脚本化访问，用于检查设置、搜索文档和执行 JavaScript。

ypyf

v1.0.0

2026年3月21日

安装

基本信息

Skill.md

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。


                  npx clawhub@latest install shopify-runtime

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式

~/.openclaw/skills/

工作区

<project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。


                  请帮我使用 Clawhub 安装 shopify-runtime。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

更倾向于下载？

获取包含原生技能文件的ZIP压缩包。

什么是 Shopify Runtime Toolkit？

Shopify Runtime 工具包是为需要对 Shopify 商店环境进行细粒度控制的 Openclaw Skills 用户设计的专用实用程序。与高层工作流技能不同，此运行时专注于通过脚本执行进行直接交互，允许开发人员排查设置问题、搜索官方文档，并直接针对 Shopify Admin API 运行 GraphQL 或 REST 请求。它作为一个独立的技能运行，可以轻松集成到任何工作区进行即时商店管理。

该技能对于需要验证 Shopify 设置状态或执行超出标准 API 封装器的自定义逻辑的开发人员特别有价值。通过利用 Openclaw Skills 框架，它确保以安全高效的方式处理身份验证和环境管理。

Shopify Runtime Toolkit 应用场景

验证 Shopify 商店连接和 API 版本配置。
在编写脚本前搜索官方 Shopify 文档和提供商注释。
执行只读 GraphQL 查询以获取商店数据（如产品或订单）。
在需要特定 mutation 时执行经过身份验证的写操作进行商店管理。
排查 Shopify 生态系统内的身份验证和作用域问题。

Shopify Runtime Toolkit 工作原理

技能通过读取由 Openclaw Skills 环境注入的环境变量（包括商店域名和客户端凭据）进行初始化。
它通过将客户端凭据（ID 和 Secret）交换为 Shopify Admin API 访问令牌来进行身份验证。
用户可以运行 status 命令来确认本地技能已准备就绪并正确指向目标域名。
search 命令允许用户查询文档，以确保 API 请求使用正确的 schema 和参数。
execute 命令通过 stdin 接收 JavaScript 输入，利用 provider 对象在读取或写入模式下与 Shopify API 进行交互。

Shopify Runtime Toolkit 配置指南

要在 Openclaw Skills 中设置此技能，您必须为特定的 Shopify 商店配置环境变量。请按照以下步骤开始：

# Navigate to your workspace skills directory
# Copy the shopify-runtime folder into workspace/skills/

# Configure environment variables
export SHOPIFY_STORE_DOMAIN="your-store.myshopify.com"
export SHOPIFY_CLIENT_ID="your_client_id"
export SHOPIFY_CLIENT_SECRET="your_client_secret"

Openclaw Skills 的示例 JSON 配置：

{
  "skills": {
    "entries": {
      "shopify-runtime": {
        "apiKey": { "source": "env", "provider": "default", "id": "SHOPIFY_CLIENT_SECRET" },
        "env": {
          "SHOPIFY_STORE_DOMAIN": "your-store.myshopify.com",
          "SHOPIFY_CLIENT_ID": "your_shopify_client_id",
          "SHOPIFY_API_VERSION": "2026-01"
        }
      }
    }
  }
}

Shopify Runtime Toolkit 数据架构与分类体系

该技能使用结构化的运行时合约来处理交互和数据流。以下是数据和命令输出的组织结构：

组件	描述
provider.graphql()	执行 GraphQL 查询或 mutation 的主要方法；直接返回验证后的数据对象。
provider.request()	当 GraphQL 不适用时，用于 REST API 请求的备用方法。
execution context	包含 requestSummary、rawResponses 和 logs，用于完整的执行证据。
environment	从 SHOPIFY_STORE_DOMAIN、SHOPIFY_CLIENT_ID 和 SHOPIFY_API_VERSION 读取的配置。