Openclaw向けShopify Runtime Toolkit

セットアップの検査、ドキュメントの検索、および JavaScript の実行のために、単一の Shopify ストアへの直接的でスクリプト可能なアクセスを提供する強力なツールキットです。

ypyf
v1.0.0
Mar 21, 2026
1
718
0

インストール&ダウンロード

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 の仕組み

  1. スキルは、ストアドメインやクライアント資格情報を含む Openclaw Skills 環境によって注入された環境変数を読み取ることにより初期化されます。
  2. クライアント資格情報(ID と Secret)を Shopify Admin API アクセストークンと交換することで認証します。
  3. ユーザーは status コマンドを実行して、ローカルスキルが準備完了しており、ターゲットドメインを正しく指していることを確認できます。
  4. search コマンドにより、ユーザーはドキュメントを照会して、API リクエストが正しい schema とパラメータを使用していることを確認できます。
  5. 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、およびログが含まれます。
environment SHOPIFY_STORE_DOMAIN、SHOPIFY_CLIENT_ID、および SHOPIFY_API_VERSION から読み取られた構成。

Shopify Runtime Toolkit の高度な機能

  • 読み取りモード時に REST 書き込みメソッドと GraphQL mutation をブロックするローカルセーフティガードを備えたデュアルモード実行(読み取り/書き込み)。
  • 正確な API 使用を保証するために、プロバイダーノートと公式 Shopify エントリを照会する統合ドキュメント検索エンジン。
  • stdin パイピングを介した直接スクリプト実行のサポートにより、一時ファイルのオーバーヘッドなしで動的なスクリプト生成が可能。
  • 特定の Shopify リリースサイクルに対するテストをサポートする、カスタマイズ可能な API バージョニング。
  • 複雑な Openclaw Skills ワークフローのデバッグのための、リクエストサマリーと生レスポンスを含む詳細な実行証拠。

SKILL.md


ローディング

関連するOpenclawのスキル

METADATA

Requires
Github Stars: 0
forks: 0

特徴*