OpenClaw Shopify Manager
Use this skill to connect OpenClaw to Shopify with a guided setup flow, local secret storage, and a small local connector for OAuth, webhooks, and Shopify Admin API operations.
Core workflow
- 1. Read
references/setup.md for the canonical setup path. - Use
scripts/setup-runtime.mjs guided-setup to create the runtime directory, config files, .env, logs/state folders, and optional systemd unit template. - Read
references/tailscale.md when using Tailscale for public HTTPS callback exposure. - Read
references/systemd.md for host/systemd operation. - Read
references/docker.md for Docker or sidecar deployment. - Use
scripts/shopify-connector.mjs for auth URL generation, callback handling, webhook validation, and Shopify API calls. - Use
scripts/setup-runtime.mjs doctor to verify runtime completeness. - Use
scripts/install-host-runtime.sh when the user wants the canonical host-oriented setup flow.
Safety rules
- - Keep Shopify secrets and tokens in
.env, not in tracked config files. - Default to read-first behavior unless the user clearly asks for mutations.
- Before any store-changing action, restate the intended change briefly and get confirmation.
- Prefer least-privilege scopes.
- Verify callback URLs and health endpoints after setup changes.
Common user-facing tasks
Connect a store
- - Run
scripts/setup-runtime.mjs guided-setup. - Fill Shopify app credentials into
.env. - Start the connector.
- Expose the callback path publicly over HTTPS.
- Generate the auth URL with
scripts/shopify-connector.mjs auth-url. - Complete OAuth.
- Verify with
shop-info.
Read Shopify data
Supported helper commands include:
- - INLINECODE14
- INLINECODE15
- INLINECODE16
- INLINECODE17
- INLINECODE18
- INLINECODE19
Use get-product --id ... for exact lookup and get-product --title ... or find-products --query ... for title-based lookup.
Update Shopify data
Supported mutation helpers include:
- - INLINECODE23
- INLINECODE24
- INLINECODE25
Use write commands only after user confirmation.
Resource map
- - Setup guide: INLINECODE26
- Tailscale guide: INLINECODE27
- systemd guide: INLINECODE28
- Docker guide: INLINECODE29
- Shopify scopes and safety: INLINECODE30
- Runtime bootstrap: INLINECODE31
- Canonical host installer: INLINECODE32
- Connector runtime: INLINECODE33
- Service template: INLINECODE34
- Tailscale checker: INLINECODE35
OpenClaw Shopify 管理器
使用此技能可通过引导式设置流程、本地密钥存储以及用于OAuth、Webhook和Shopify Admin API操作的小型本地连接器，将OpenClaw连接到Shopify。
核心工作流程
- 1. 阅读 references/setup.md 获取标准设置路径。
- 使用 scripts/setup-runtime.mjs guided-setup 创建运行时目录、配置文件、.env、日志/状态文件夹以及可选的systemd单元模板。
- 使用Tailscale进行公共HTTPS回调暴露时，阅读 references/tailscale.md。
- 阅读 references/systemd.md 了解主机/systemd操作。
- 阅读 references/docker.md 了解Docker或边车部署。
- 使用 scripts/shopify-connector.mjs 进行认证URL生成、回调处理、Webhook验证和Shopify API调用。
- 使用 scripts/setup-runtime.mjs doctor 验证运行时完整性。
- 当用户需要标准的主机导向设置流程时，使用 scripts/install-host-runtime.sh。
安全规则
- - 将Shopify密钥和令牌保存在 .env 中，而非受追踪的配置文件中。
- 默认采用先读后写行为，除非用户明确要求修改。
- 在执行任何店铺变更操作前，简要重述预期变更并获取确认。
- 优先使用最小权限范围。
- 设置变更后验证回调URL和健康检查端点。
常见用户任务
连接店铺
- - 运行 scripts/setup-runtime.mjs guided-setup。
- 将Shopify应用凭证填入 .env。
- 启动连接器。
- 通过HTTPS公开暴露回调路径。
- 使用 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 ... 进行精确查找，使用 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
