OpenClaw Shopify 管理器

使用此技能，可通过引导式配置流程、本地密钥存储以及一个轻量级本地连接器，将 OpenClaw 与 Shopify 进行集成，支持 OAuth 授权、Webhook 接收及 Shopify Admin API 调用。

核心工作流

1. 阅读 references/setup.md 了解标准配置路径。
2. 运行 scripts/setup-runtime.mjs guided-setup 创建运行时目录、配置文件、.env 文件、日志/状态目录，以及可选的 systemd 单元模板。
3. 若使用 Tailscale 实现公网 HTTPS 回调地址暴露，请阅读 references/tailscale.md。
4. 如需在宿主机上以 systemd 方式运行，请参阅 references/systemd.md。
5. 如需使用 Docker 或 Sidecar 模式部署，请参阅 references/docker.md。
6. 使用 scripts/shopify-connector.mjs 生成授权 URL、处理回调请求、验证 Webhook 签名，并执行 Shopify API 调用。
7. 运行 scripts/setup-runtime.mjs doctor 验证运行时环境是否完整就绪。
8. 当用户希望采用标准的面向宿主机的配置流程时，请运行 scripts/install-host-runtime.sh。

安全规范

• Shopify 密钥与令牌必须保存在 .env 文件中，不得写入受版本控制的配置文件。
• 默认行为应为只读；仅当用户明确要求变更操作时，才执行写入类操作。
• 执行任何影响店铺数据的操作前，须简要复述拟执行的变更内容，并获得用户确认。
• 应优先选用最小权限所需的 API 权限范围（scopes）。
• 每次配置变更后，均需验证回调 URL 和健康检查端点是否可用。

常见面向用户的任务

连接店铺

• 运行 scripts/setup-runtime.mjs guided-setup。
• 将 Shopify 应用凭证填入 .env 文件。
• 启动连接器服务。
• 通过 HTTPS 将回调路径（callback path）对外公开。
• 使用 scripts/shopify-connector.mjs auth-url 生成授权 URL。
• 完成 OAuth 流程。
• 运行 shop-info 命令验证连接状态。

读取 Shopify 数据

支持的辅助命令包括：

• shop-info
• list-products
• find-products
• get-product
• list-blogs
• list-articles

使用 get-product --id ... 进行精确 ID 查询；使用 get-product --title ... 或 find-products --query ... 进行基于标题的模糊查询。

更新 Shopify 数据

支持的变更类辅助命令包括：

• update-product
• create-article
• update-article

所有写入类命令必须在获得用户明确确认后方可执行。

资源映射表

• 配置指南：references/setup.md
• Tailscale 使用指南：references/tailscale.md
• systemd 部署指南：references/systemd.md
• Docker 部署指南：references/docker.md
• Shopify 权限范围与安全规范：references/scopes-and-safety.md
• 运行时初始化脚本：scripts/setup-runtime.mjs
• 标准宿主机安装脚本：scripts/install-host-runtime.sh
• 连接器运行时脚本：scripts/shopify-connector.mjs
• 服务单元模板：assets/shopify-connector.service.txt
• Tailscale 状态检查脚本：scripts/check-tailscale.sh