立白龙虾购

---

name: liby-mall-shopping description: 立白龙虾购是立白官方商城服务，支持获得立乐家积分、商品搜索、下单、订单管理、物流查询等操作，还能解答洗衣清洁问题（如咖啡渍、油渍、梅雨天衣物护理等），提供立白产品购买渠道和优惠信息。 triggers: - "搜索商品" - "查看商品" - "下单" - "购买" - "查看订单" - "查询物流" - "收货地址" - "联系客服" - "积分" - "洗衣" - "怎么洗" - "污渍" - "衣服不干" - "梅雨天" - "立白" - "立白商城" - "帮我买东西" metadata: openclaw: emoji: "🛒" os: ["darwin", "linux", "windows"]

---

图片回复强制性指令

当用户请求单张图片时，必须使用 message 工具发送，不要使用 MEDIA: 指令

{
  "action": "send",
  "channel": "",
  "target": "",
  "message": "",
  "media": "https://example.com/image.png"
}

重要提示

不要在回复文本中使用 MEDIA: 指令

必须使用 message 工具的 send action

不要在文字中说"上图"、"下图"——因为渲染顺序不确定

图片 URL 放在 media 参数中

不同channel的格式稍有不同，修改为正确的格式

如果有文字，记住不要多次发送相同的文字

核心规则

session-key 获取

所有工具调用前必须先获取 session-key

调用 session_status 工具
取返回结果中的 Session 字段值, 赋值到 session-key
格式: agent:main:feishu:direct:xxx@im.feichu

工具调用格式

所有工具通过 npx -y @libydic/mall 命令调用：

npx -y @libydic/mall <工具名> --session-key  [其他参数]

必须遵守

1. 先获取 session-key，再调用其他工具 2. 不编造商品、订单、物流信息 3. 下单前必须向用户确认商品和地址 4. 接口失败时给出友好提示 5. 登录只有一种方式，使用auth-start获取二维码，作为首选登录方式，明确告知用户在手机端获取口令码，不能使用其他方式登录 6. 减少一次性调用多个工具(登录成功后integral-add、integral工具除外)，获取结果后先输出给用户，再决定下一步，避免耗时过长 7. 保持交互节奏，让用户参与决策过程 8. 用户切换账号或者退出账号，必须删除用户的历史会话信息，避免会话冲突, 之后的操作必须重新查找 9. 用户再询问订单、地址、商品信息时，总是要调用工具，确保数据最新 9. 通过npx -y @libydic/mall调用的工具列表仅有工具说明中的内容，禁止提供不存在工具，引导用户联系客服 10. 工具参数中: 订单ID 和 订单编号不是一个数字，不能混用，工具参数只能使用 订单ID 11. 商品发货规则：1、因日化品运输较为特殊，港澳台、海外等地就近地区无仓库，暂不支持配送。2、发货时效：兑换成功后，产品将于5个工作日内安排发货（如遇不可抗力因素导致无法发货的，将在物流恢复后安排发货），国家法定节假日期间不发货（顺延至假期结束后安排发货）。 12. 商品定价为"积分+现金"组合价，例如：200积分+0.01元。下单时用户必须同时满足这两部分支付条件，不可拆分。

***

工具说明

auth-start

描述: 获取小程序登录二维码，用于用户扫码登录

调用: npx -y @libydic/mall auth-start --session-key

返回: 二维码图片地址

流程位置: 登录认证流程第一步

---

login

描述: 使用手机号和验证码完成登录

调用: npx -y @libydic/mall login --session-key --mobile <手机号> --verify-code <口令码>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | mobile | string | 是 | 用户手机号 | | verify-code | string | 是 | 用户提供的口令码: 长度6位|

返回: 登录成功信息

流程位置: 登录认证流程第二步

---

user-profile

描述: 检查用户登录状态，获取用户绑定信息

调用: npx -y @libydic/mall user-profile --session-key

返回: 用户信息或未登录提示

流程位置: 所有流程的入口检查

---

goods-info

描述: 获取商品列表信息

调用: npx -y @libydic/mall goods-info --session-key

返回: 商品列表(ID、名称、价格、库存)

流程位置: 商品浏览流程

---

goods-detail

描述: 获取单个商品的详细信息

调用: npx -y @libydic/mall goods-detail --session-key --id <商品ID>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | id | string | 是 | 商品ID |

返回: 商品完整信息(规格、价格、库存、简介、主图)

流程位置: 商品浏览流程

---

address-list

描述: 获取用户的收货地址列表

调用: npx -y @libydic/mall address-list --session-key --default <是否默认>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | default | int | 否 | 是否默认地址（1: 默认, 0: 全部）, 默认值为0 |

返回: 地址列表(地址ID、收货人、电话、省市区、详细地址)

流程位置: 下单购买流程第一步

---

area-info

描述: 获取省市区信息，用于地址选择

调用: npx -y @libydic/mall area-info --session-key --parent-id <父级ID>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | parent-id | int | 否 | 父级ID，0或不传=省份列表 |

返回: 地区列表

流程位置: 新增地址时使用

---

address-save

描述: 保存新的收货地址

调用: npx -y @libydic/mall address-save --session-key --name <姓名> --receiver-mobile <电话> --province <省> --city <市> --district <区> --area-info <详细地址> --area-id <地区ID> --default <是否默认>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | name | string | 是 | 收货人姓名 | | receiver-mobile | string | 是 | 收货人电话 | | province | string | 是 | 省份 | | city | string | 是 | 城市 | | district | string | 是 | 区县 | | area-info | string | 是 | 详细地址 | | area-id | int | 否 | 地区ID | | default | int | 否 | 是否默认地址(0: 否, 1: 是), 默认值为0 |

返回: 新地址ID

流程位置: 下单购买流程(地址不存在时)

---

create-order

描述: 创建订单

调用: npx -y @libydic/mall create-order --session-key --secondary-goods-id <商品ID> --address-id <地址ID>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | secondary-goods-id | string | 是 | 商品ID | | address-id | int | 是 | 地址ID | | msg | string | 否 | 订单留言 |

返回: 订单号、支付信息

流程位置: 下单购买流程最后一步

---

order-list

描述: 获取用户订单列表

调用: npx -y @libydic/mall order-list --session-key

返回: 订单列表(订单号、状态、金额)

流程位置: 订单查询流程、物流查询流程

---

order-detail

描述: 获取单个订单的详细信息

调用: npx -y @libydic/mall order-detail --session-key --order-id <订单ID> --current-page <当前页> --page-size <每页数量>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | order-id | string | 是 | 订单ID | | current-page | int | 否 | 当前页, 默认值为1 | | page-size | int | 否 | 每页数量, 默认值为10 |

返回: 订单完整信息

流程位置: 订单查询流程

---

logistics-track

描述: 查询订单物流轨迹

调用: npx -y @libydic/mall logistics-track --session-key --order-id <订单ID>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | order-id | string | 是 | 订单ID |

返回: 物流轨迹、预计送达时间

流程位置: 物流查询流程

---

customer-service

描述: 获取客服联系方式

调用: npx -y @libydic/mall customer-service --session-key

返回: 客服二维码图片、客服联系方式

流程位置: 售后服务流程

---

integral

描述: 查询用户当前积分信息

调用: npx -y @libydic/mall integral --session-key

返回: 用户积分、等级、手机号、用户ID

流程位置: 积分查询流程

---

integral-add

描述: 通过事件增加用户积分

调用: npx -y @libydic/mall integral-add --session-key --event <事件> --channel <渠道>

参数: | 参数 | 类型 | 必需 | 说明 | |------|------|------|------| | event | string | 是 | 事件名称，默认：claw_regist | | channel | string | 是 | 渠道，默认：SHQC |

返回: 增加积分数量、变更前后积分、总积分

流程位置: 积分增加流程

***

调用流程

流程一：登录认证

触发: 用户首次使用商城，或提示"请先登录"

步骤: 1. 调用 session_status 获取 session-key 2. 调用 user-profile 检查登录状态 → 输出登录状态 3. 若未登录: - 调用 auth-start 获取二维码 -> 调用 message 工具发送二维码图片 - 等待用户提供手机号和扫码后获取的口令码 - 调用 login 完成登录 - 继续调用 integral-add 增加注册积分 - 继续调用 integral 查看积分详情 → 输出登录结果、增加积分情况结果、最新积分详情 4. 若用户要求退出登录: - 调用 logout 退出登录 - 清除上文信息, 包括用户积分、商品、地址、订单等信息，避免用户信息混乱 → 输出退出结果 5. 若用户要求切换用户登录: - 调用 logout 退出登录 - 清除上文信息, 包括用户积分、商品、地址、订单等信息，避免用户信息混乱 → 输出退出结果 - 重复步骤2-4

异常: 登录失败 → 重新执行 auth-start 异常: 增加注册积分失败 → 提示"积分活动提示已参加过"

---

流程二：积分查询

触发: 用户说"查询积分"、"我的积分"、"有多少积分"

步骤: 1. 调用 session_status 获取 session-key 2. 调用 integral 获取积分信息 → 输出当前积分、等级

---

流程三：商品浏览

触发: 用户说"搜索xxx"、"查看商品"、"有什么商品"

步骤: 1. 调用 session_status 获取 session-key 2. 调用 goods-info 获取商品列表 → 输出商品列表供用户选择 3. 用户选择后，调用 goods-detail 获取详情 → 输出商品详情

异常: 商品无结果 → 建议重新选择 异常: 商品列表为空 → 提示"暂无商品"

---

流程四：下单购买

触发: 用户说"购买xxx"、"下单"、"我要买"

步骤: 1. 调用 session_status 获取 session-key 2. 必须调用 address-list 获取地址列表 → 输出地址列表供用户选择 3. 若用户选择已有地址 → 记录 address-id，输出确认信息 4. 若用户没有地址或者需要新增地址, 且已给出完整的信息(解析用户给出的地址，包含省份、城市、区县、详细地址，逐层调用 area-info 获取地区信息进行匹配，信息缺失时候提示用户补充)，如果没有给出地址信息（则提示用户逐层输入详细地址，信息缺失时候提示用户补充）: - 调用 area-info --parent-id 0 获取省份 - 识别省份后，调用 area-info --parent-id <省份ID> 获取城市 - 识别城市后，调用 area-info --parent-id <城市ID> 获取区县 - 识别区县和详细地址、联系人、手机号后 → 确认是否默认地址 → 调用 address-save 保存地址 - 记录返回的 address-id 5. 向用户确认商品和地址，并且向用户声明发货规则 6. 用户确认后，调用 create-order 创建订单 - 若创建成功，响应中有支付链接 → 调用 message 工具发送支付二维码图片 - 若创建成功，是纯积分支付，无支付链接 → 提示用户下单完成 - 若创建失败 → 提示用户失败及原因，建议稍后重试

异常: 下单失败 → 提示稍后重试 异常: 地址解析无法匹配 → 提示检查地址信息，给定对应省市区的地区名称供用户选择 异常: 用户要除微信其他支付方式 → 提示"暂不支持除微信支付外的其他支付方式" 异常: 用户地址为空 → 提示用户新增地址

---

流程五：订单查询

触发: 用户说"查看订单"、"我的/当前订单"、"支付成功"

步骤: 1. 调用 session_status 获取 session-key 2. 如果用户说支付成功，查当前订单, 调用 order-detail 获取详情 → 输出订单详情 3. 如果是其他情况，调用 order-list 获取订单列表 → 输出订单列表供用户选择 4. 用户选择后，调用 order-detail 获取详情 → 输出订单详情

异常: 订单不存在 → 提示"订单不存在" 异常: 订单状态为待支付 → 输出订单详情

---

流程六：物流查询

触发: 用户说"查询物流"、"快递到哪了"

步骤: 1. 调用 session_status 获取 session-key 2. 若用户未提供订单号，调用 order-list → 输出订单列表供用户选择 3. 用户选择后，调用 logistics-track 查询物流 → 输出物流信息

异常: 订单未发货 → 提示"待发货，暂无物流信息"

---

流程七：售后服务

触发: 用户说"退款"、"退货"、"联系客服"、"发票问题"

步骤: 1. 调用 session_status 获取 session-key 2. 调用 customer-service 获取客服信息 -> 调用 message 工具发送二维码图片 3. 提示用户准备订单号、问题描述、照片

---

***

异常处理

| 异常 | 处理方式 | 后续操作 | |------|----------|----------| | 未登录 | 提示登录 | auth-start → login | | Token失效 | 提示重新登录 | auth-start | | 商品无结果 | 建议稍后重试 | goods-info | | 下单失败 | 提示稍后重试 | create-order | | 物流异常 | 引导联系客服 | customer-service | | 地址保存失败 | 检查参数重试 | address-save | | 积分已领取 | 提示已参加过 | integral|

***

订单状态说明

| 状态 | 说明 | |------|------| | 待支付 | 订单已创建，等待支付 | | 待发货 | 等待商家发货 | | 已发货 | 已发货，运输中 | | 已签收 | 已签收 | | 已取消 | 订单已取消 | | 已完成 | 订单已完成 |