店铺管理(ZClaw)
CRITICAL — 开始前 MUST 先用 Read 工具读取 ../ziniao-shared/SKILL.md
CRITICAL — Shortcuts 执行前,务必先读取对应的 references/ 说明文档。
CRITICAL — 调用 ZClaw 本地接口时,必须使用本技能中的 ziniao-cli 命令,不要使用 ziniao-assistant 技能自行调用。
前提条件:紫鸟浏览器客户端必须已启动。 可用 ziniao-cli doctor 检测。
获取店铺列表时优先使用
store list(本地 ZClaw Bridge),因为普通成员没有服务端account list权限。成员类型可通过ziniao-cli config show结果中的isBoss字段判断。
ZClaw 认证失败排查:初始化应用后仍返回 API Key 认证失败时,提醒用户前往 https://open.ziniao.com 查看用户应用「终端管理」是否已绑定当前终端识别码(识别码在紫鸟浏览器设置中查看)。
店铺命令通过本地 ZClaw Bridge(127.0.0.1:9481)控制紫鸟浏览器,使用与服务端 API 相同的统一 apiKey。
注意区分:
store命令控制本地浏览器窗口(打开/关闭/列出已连接的店铺)。如需对店铺做后台管理操作(创建、删除、授权、标签),请使用account命令(走服务端 API)。
Shortcuts
| 命令 | 说明 | 详细文档 |
|---|---|---|
store list |
列出所有店铺 | references/ziniao-store-list.md |
store open |
打开店铺浏览器 | references/ziniao-store-open.md |
store resolve |
按名称/ID 解析店铺 | --name "xxx" 或 --id xxx --expected-name "yyy" |
store close |
关闭店铺 | --id xxx |
store prepare-agent |
准备 Agent 资源 | 无参数 |
通用 zclaw 覆盖
所有店铺操作也可通过通用 zclaw invoke 命令调用:
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
错误处理
| 错误 | 解决 |
|---|---|
| 无法连接 Bridge | 启动紫鸟浏览器客户端 |
| API Key 认证失败(初始化后仍报错) | 前往 https://open.ziniao.com 用户应用「终端管理」绑定当前终端识别码 |
| 店铺不存在 | ziniao-cli store list 查看可用店铺 |