ziniao-store

Store Management (ZClaw)

CRITICAL — Before starting, you MUST first use the Read tool to read ../ziniao-shared/SKILL.md CRITICAL — Before executing Shortcuts, be sure to read the corresponding references/ documentation first. CRITICAL — When calling the ZClaw local interface, you must use the ziniao-cli command in this skill; do not use the ziniao-assistant skill to call it on your own.

Prerequisite: The Ziniao Browser client must already be running. Available ziniao-cli doctor detection.

When retrieving the store list, prefer store list(local ZClaw Bridge), because regular members do not have server-side account list permission. The member type can be determined via the ziniao-cli config show field in the isBoss result.

ZClaw authentication failure troubleshooting: If API Key authentication failure is still returned after initializing the application, remind the user to go to https://open.ziniao.com and check whether the user application "Terminal Management" has bound the current terminal identification code (the identification code can be viewed in the Ziniao Browser settings).

Store commands control Ziniao Browser through the local ZClaw Bridge (127.0.0.1:9481), using the same unified apiKey as the server-side API.

Note the distinction: store commands controllocal browser windows(open/close/list connected stores). If you need to perform backend management operations on stores (create, delete, authorize, tags), use the account command (which goes through the server-side API).

Shortcuts

Command	Description	Detailed Documentation
store list	List all stores	references/ziniao-store-list.md
store open	Open store browser	references/ziniao-store-open.md
store resolve	Resolve store by name/ID	--name "xxx" or --id xxx --expected-name "yyy"
store close	Close store	--id xxx
store prepare-agent	Prepare Agent resources	No parameters

Generic zclaw override

All store operations can also be invoked through the generic zclaw invoke command:

ziniao-cli zclaw invoke list_stores
ziniao-cli zclaw invoke open_store --args '{"storeName":"Rosehut"}'
ziniao-cli zclaw invoke close_store --args '{"storeId":"abc123"}'
ziniao-cli zclaw invoke prepare_agent

Error Handling

Error	Resolution
Unable to connect to Bridge	Start the Ziniao Browser client
API Key authentication failure (still errors after initialization)	Go to https://open.ziniao.com user application "Terminal Management" to bind the current terminal identification code
Store does not exist	ziniao-cli store list View available stores