Shopify Runtime Toolkit para Openclaw

Un potente toolkit que proporciona acceso directo mediante scripts a una única tienda Shopify para inspeccionar la configuración, buscar documentos y ejecutar JavaScript.

ypyf
v1.0.0
Mar 21, 2026
1
698
0

Instalar y Descargar

1. ClawHub CLI

La forma más rápida de instalar una habilidad directamente desde el registro.

npx clawhub@latest install shopify-runtime

2. Instalación manual

Copia la carpeta de la habilidad a una de estas ubicaciones

Global
~/.openclaw/skills/
Espacio de trabajo
<project>/skills/

Prioridad: Espacio de trabajo > Local > Integrado

3. Instalación del prompt

Copia este prompt en OpenClaw para instalarlo automáticamente.

Ayúdame a instalar shopify-runtime usando Clawhub. Si Clawhub no está instalado, instálalo primero (npm i -g clawhub).

¿Prefieres descargar?

Obtén los archivos originales de la habilidad en un archivo ZIP.

¿Qué es Shopify Runtime Toolkit?

El toolkit Shopify Runtime es una utilidad especializada diseñada para usuarios de Openclaw Skills que requieren un control granular sobre el entorno de una tienda Shopify. A diferencia de las habilidades de flujo de trabajo de alto nivel, este runtime se centra en la interacción directa mediante la ejecución de scripts, lo que permite a los desarrolladores solucionar problemas de configuración, buscar en la documentación oficial y ejecutar solicitudes GraphQL o REST directamente contra la Shopify Admin API. Funciona como una habilidad independiente que se puede integrar fácilmente en cualquier workspace para la gestión inmediata de la tienda.

Esta habilidad es particularmente valiosa para los desarrolladores que necesitan verificar el estado de la configuración de Shopify o ejecutar lógica personalizada que va más allá de los envoltorios de API estándar. Al aprovechar el marco de Openclaw Skills, garantiza que la autenticación y la gestión del entorno se manejen de forma segura y eficiente.

Casos de uso de Shopify Runtime Toolkit

  • Verificación de la conexión de la tienda Shopify y la configuración de la versión de la API.
  • Búsqueda en la documentación oficial de Shopify y notas del proveedor antes de la creación de scripts.
  • Ejecución de consultas GraphQL de solo lectura para obtener datos de la tienda como productos o pedidos.
  • Realización de operaciones de escritura autenticadas para la gestión de la tienda cuando se requieren mutations específicas.
  • Solución de problemas de autenticación y alcance dentro del ecosistema Shopify.

Cómo funciona Shopify Runtime Toolkit

  1. La habilidad se inicializa leyendo las variables de entorno inyectadas por el entorno de Openclaw Skills, incluido el dominio de la tienda y las credenciales del cliente.
  2. Se autentica intercambiando las credenciales del cliente (ID y Secret) por un token de acceso de la Shopify Admin API.
  3. Los usuarios pueden ejecutar el comando status para confirmar que la habilidad local está lista y apunta correctamente al dominio de destino.
  4. El comando search permite a los usuarios consultar la documentación para garantizar que las solicitudes de la API utilicen el schema y los parámetros correctos.
  5. El comando execute recibe la entrada de JavaScript a través de stdin, utilizando un objeto provider para interactuar con la API de Shopify en modo de lectura o escritura.

Configuración de Shopify Runtime Toolkit

Para configurar esta habilidad dentro de Openclaw Skills, debe configurar las variables de entorno para su tienda Shopify específica. Siga los siguientes pasos para comenzar:

# 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"

Ejemplo de configuración JSON para Openclaw Skills:

{
  "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"
        }
      }
    }
  }
}

Esquema de datos y taxonomía de Shopify Runtime Toolkit

La habilidad utiliza un contrato de runtime estructurado para manejar las interacciones y el flujo de datos. A continuación se muestra la organización de los datos y las salidas de los comandos:

Componente Descripción
provider.graphql() Método principal para ejecutar consultas o mutations de GraphQL; devuelve directamente el objeto de datos validado.
provider.request() Método alternativo para solicitudes de REST API cuando GraphQL no es adecuado.
execution context Incluye requestSummary, rawResponses y logs para una evidencia completa de la ejecución.
environment Configuración leída de SHOPIFY_STORE_DOMAIN, SHOPIFY_CLIENT_ID y SHOPIFY_API_VERSION.

Funciones avanzadas de Shopify Runtime Toolkit

  • Ejecución en modo dual (lectura/escritura) con protectores de seguridad locales que bloquean los métodos de escritura REST y las mutations GraphQL cuando se está en modo de lectura.
  • Motor de búsqueda de documentación integrado que consulta las notas del proveedor y las entradas oficiales de Shopify para garantizar un uso preciso de la API.
  • Soporte para la ejecución directa de scripts a través de tuberías stdin, lo que permite la generación dinámica de scripts sin la sobrecarga de archivos temporales.
  • Versionado de API personalizable para admitir pruebas contra ciclos de lanzamiento específicos de Shopify.
  • Evidencia de ejecución detallada que incluye resúmenes de solicitudes y respuestas sin procesar para depurar flujos de trabajo complejos de Openclaw Skills.

SKILL.md


Cargando

Habilidades relacionadas de Openclaw

METADATA

Requires
Github Stars: 0
forks: 0

Presentado*