立白龙虾购

立白龙虾购是立白官方商城服务，支持获得立乐家积分、商品搜索、下单、订单管理、物流查询等操作，还能解答洗衣清洁问题（如咖啡渍、油渍、梅雨天衣物护理等），提供立白产品购买渠道和优惠信息。

Install

openclaw skills install @softgoto/liby-mall-shopping

图片回复强制性指令

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

json

{
  "action": "send",
  "channel": "<channel-name>",
  "target": "<recipient>",
  "message": "",
  "media": "https://example.com/image.png"
}

重要提示

不要在回复文本中使用 MEDIA: 指令
必须使用 message 工具的 send action
不要在文字中说"上图"、"下图"——因为渲染顺序不确定
图片 URL 放在 media 参数中
不同channel的格式稍有不同，修改为正确的格式
如果有文字，记住不要多次发送相同的文字

核心规则

session-key 获取

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

text

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

工具调用格式

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

text

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

必须遵守

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

工具说明

auth-start

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

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

返回: 二维码图片地址

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

login

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

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

参数:

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

返回: 登录成功信息

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

user-profile

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

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

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

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

goods-info

描述: 获取商品列表信息

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

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

流程位置: 商品浏览流程

goods-detail

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

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

参数:

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

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

流程位置: 商品浏览流程

address-list

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

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

参数:

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

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

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

area-info

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

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

参数:

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

返回: 地区列表

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

address-save

描述: 保存新的收货地址

调用: npx -y @libydic/mall address-save --session-key <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 <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 <session-key>

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

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

order-detail

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

调用: npx -y @libydic/mall order-detail --session-key <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 <session-key> --order-id <订单ID>

参数:

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

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

流程位置: 物流查询流程

customer-service

描述: 获取客服联系方式

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

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

流程位置: 售后服务流程

integral

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

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

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

流程位置: 积分查询流程

integral-add

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

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

参数:

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

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

流程位置: 积分增加流程

调用流程

流程一：登录认证

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

步骤:

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

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

流程二：积分查询

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

步骤:

调用 session_status 获取 session-key
调用 integral 获取积分信息 → 输出当前积分、等级

流程三：商品浏览

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

步骤:

调用 session_status 获取 session-key
调用 goods-info 获取商品列表 → 输出商品列表供用户选择
用户选择后，调用 goods-detail 获取详情 → 输出商品详情

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

流程四：下单购买

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

步骤:

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

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

流程五：订单查询

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

步骤:

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

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

流程六：物流查询

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

步骤:

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

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

流程七：售后服务

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

步骤:

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

异常处理

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

订单状态说明

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