Shop

Version 0.0.28 - Updated authentication endpoints: now use `/agents/auth/device-code`, `/agents/auth/token`, and `/agents/auth/userinfo` with plain text markdown responses. - Device authorization flow no longer requires `client_id` or `scope` parameters; these are handled by the proxy. - Clarified the required use of `similarTo.id` or `similarTo.media` for "Find Similar Products" requests. - Minor restructuring of documentation for improved clarity and consistency. - Session state storage requirements are moved and more clearly described under authentication.

Version 0.0.27 of the Shop skill - Updated skill description and metadata version. - Refined scope in "When to Use" for greater clarity. - Shortened and streamlined documentation for Product Search, Find Similar Products, and error handling sections. - Orders section expanded with clearer structure and new "Order Fetch Pattern" documentation. - General language and formatting improvements throughout for simplicity and readability.

- Rolled back skill metadata: version set to 0.0.23 and author field removed. - No functional or API changes; all endpoints and usage remain the same. - Minor changes to documentation wording, particularly around token handling and session memory requirements. - No file or implementation changes were detected in this version.

Version 0.0.25 - Added detailed guidance on persisting state across session turns, including which fields to store (access/refresh token, device ID, country). - Expanded authentication section: now documents the full device authorization flow (device code, polling, validation, refresh) and error recovery on expired tokens. - Clarified that product search and similar product features do not require auth, but all order-related APIs do. - No API or endpoint changes; documentation improved for reliability and multi-turn support.

Version 0.0.24 of the Shop skill updates error handling and documentation: - Error responses for product search and orders now return markdown-formatted errors, not JSON. - Product search errors for missing/empty queries return `# Error\n\nquery is missing (400)`. - Orders error responses are given as markdown (e.g., `# Error\n\n{message} ({status})`), clarifying format and behavior. - Documentation clarified around response formats for easier integration and troubleshooting. - No functional or code changes detected.

- Version bumped to 0.0.23 in metadata. - Removed the OpenClaw metadata section, along with references to primaryEnv and required environment variables. - No functional or API changes; documentation clean-up only.

Version 0.0.21 - Added new metadata section for openclaw, specifying required environment variables: `SHOP_ACCESS_TOKEN` and `SHOP_CLIENT_ID`. - No changes to search, order, or return functionality. - Version bump in metadata from 0.0.20 to 0.0.21.

- Product Search now uses the SHOP_ACCESS_TOKEN for personalized results when available, while still supporting anonymous search. - Find Similar Products now allows passing the product image URL (not just file path) with the image_path parameter. - Orders section clarifies that Shop order tracking supports all stores (not just Shopify) by aggregating orders from users’ connected email receipts. - Updated descriptions to reflect more explicit authentication and capabilities for both search and order aggregation.

- Clarified that authentication is not needed for searching products, but is required for order tracking in Shop. - No changes to APIs or functionality—documentation update only.

shop 0.0.18 - Version bump from 0.0.17 to 0.0.18; no file or documentation changes detected.

No user-visible changes in this version. - Version bump only; no file or functionality changes detected.

No user-facing changes in this release; version bump only.

Version 0.0.9 adds a capabilities table and makes the skill's supported features clearer. - Added a concise "Capabilities" table describing available functions and authentication requirements. - No code or functional changes to endpoints or behavior. - Documentation now organized for quicker reference to supported operations.

- Added explicit OAuth device authorization flow documentation under metadata, including required environment variable and endpoints. - Updated metadata with `requiredEnv` and `auth` sections detailing authentication method, scopes, and data policy. - No changes to API endpoints or functionality; documentation now clarifies authentication and configuration requirements.

No file changes detected in this release. - No updates or modifications were made to the source code or documentation in version 0.0.7. - Functionality and instructions remain the same as the previous release.

- Added primary environment variable setting: SHOP_CLIENT_ID is now specified as required for configuration. - Updated skill version to 0.0.6. - No changes to behavior or endpoints; API reference, features, and usage remain the same.

**Expanded capabilities: Shop is now your assistant for searching, buying, tracking, and managing orders from any online store.** - New order management features: track deliveries, check order status, process returns, and re-order items from any retailer (not just Shopify stores). - Updated product search: now uses a new endpoint and clearly states scope is Shopify-powered stores only. - Find similar products remains available for Shopify items, via a new API path and ID requirements. - Richer API documentation: details on errors, pagination, filtering, and required headers. - Clarified formatting and key field extraction for both product and order responses. - Updated skill description and usage guidance to emphasize full shopping and post-purchase assistance.

shop v0.0.2 Changelog - Updated version metadata to 0.0.4 and added a homepage link to metadata. - No changes to API behavior, formatting, search strategy, or core functionality. - Documentation only: reflects updated version and new homepage URL.

Initial Shop Skill

- Updated description to "Shop Claw | Give your agent spending power. Financial management for Agents and OpenClaw bots." - No changes to skill files or capabilities; documentation wording updated only. - No code or functional modifications detected in this release.