openclaw-shopify-manager
# 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.
2. Use `scripts/setup-runtime.mjs guided-setup` to create the runtime directory, config files, `.env`, logs/state folders, and optional systemd unit template.
3. Read `references/tailscale.md` when using Tailscale for public HTTPS callback exposure.
4. Read `references/systemd.md` for host/systemd operation.
5. Read `references/docker.md` for Docker or sidecar deployment.
6. Use `scripts/shopify-connector.mjs` for auth URL generation, callback handling, webhook validation, and Shopify API calls.
7. Use `scripts/setup-runtime.mjs doctor` to verify runtime completeness.
8. 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:
- `shop-info`
- `list-products`
- `find-products`
- `get-product`
- `list-blogs`
- `list-articles`
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:
- `update-product`
- `create-article`
- `update-article`
Use write commands only after user confirmation.
## Resource map
- Setup guide: `references/setup.md`
- Tailscale guide: `references/tailscale.md`
- systemd guide: `references/systemd.md`
- Docker guide: `references/docker.md`
- Shopify scopes and safety: `references/scopes-and-safety.md`
- Runtime bootstrap: `scripts/setup-runtime.mjs`
- Canonical host installer: `scripts/install-host-runtime.sh`
- Connector runtime: `scripts/shopify-connector.mjs`
- Service template: `assets/shopify-connector.service.txt`
- Tailscale checker: `scripts/check-tailscale.sh`
标签
skill
ai