Android 订单技能（点餐）

该技能利用配对的 Android 设备（安装有具备订单能力的 OpenClaw SMS Demo 应用）来管理应用内菜单与购物车：获取菜单、添加/删除商品、查看购物车、提交订单。设计灵感源自 EdgeOSToolService（MEOW PAY）；当前实现为设备内存中运行（仅用于演示，无真实 POS 后端）。

适用场景

• 当用户请求在配对的 Android 设备上点餐/饮品、查看菜单、加入购物车或提交订单时，请使用下方 order.* 命令。

命令概览

底层命令调用方式

通过 OpenClaw 网关节点的 invoke API 调用：

• command：取值为以下之一：order.getGoods、order.getSelectedGoods、order.addGoods、order.removeGoods、order.clearGoods、order.submitOrder、order.batchAddGoods。
• paramsJSON：JSON 对象字符串；若命令无需参数，则传 null。

order.getGoods

• command："order.getGoods"
• paramsJSON：null 或 "{}"
• 成功响应：payload 为 JSON 数组，元素结构为 { "id", "name", "priceCents", "price" }。

order.getSelectedGoods

• command："order.getSelectedGoods"
• paramsJSON：null 或 "{}"
• 成功响应：payload 为购物车商品 JSON 数组，每项含 id、name、quantity、priceCents、subtotalCents。

order.addGoods

• command："order.addGoods"

• paramsJSON：需提供 id 或 name（二者可同时提供）；quantity 为可选字段（默认为 1）。

  { "id": "1", "quantity": "2" }
  

  或

  { "name": "拿铁", "quantity": "1" }
  

• 成功响应：payload 包含 success: true 及 message 字段（例如："已添加 拿铁 x1"）。

order.removeGoods

• command："order.removeGoods"
• paramsJSON：结构同 order.addGoods（即提供 id 或 name，可选 quantity）。

order.clearGoods

• command："order.clearGoods"
• paramsJSON：null 或 "{}"。

order.submitOrder

• command："order.submitOrder"
• paramsJSON：null 或 "{}"。
• 成功响应：payload 包含 success、message、totalCents、items；提交后购物车自动清空。
• 错误响应：若购物车为空，则返回错误码 CART_EMPTY。

order.batchAddGoods

• command："order.batchAddGoods"
• paramsJSON：{ "list": "[{"id":"1","quantity":2},{"id":"2","quantity":1}]" }
• 成功响应：payload 包含 success 及 message 字段（例如："已批量添加 2 项"）。

错误处理

• GOODS_NOT_FOUND：未找到匹配给定 id 或 name 的菜单项。建议先调用 order.getGoods 查看当前菜单。
• NOT_IN_CART：移除商品时，该商品不在购物车中。
• CART_EMPTY：购物车为空时无法提交订单。
• INVALID_REQUEST：参数缺失或格式错误（例如 batchAddGoods 的 list 为空）。

演示菜单（设备默认菜单）

应用内菜单包含如下商品：拿铁、美式、卡布奇诺、三明治、沙拉、蛋糕（对应 id 为 "1"–"6"）。请使用 order.getGoods 获取当前菜单及价格信息。

安全说明

• 本流程仅为演示用途：submitOrder 不会实际扣款，也不会发送至真实 POS 系统，请勿将其暴露为真实支付通道。
• 建议在提交订单前主动向用户确认（例如：复述购物车内容及总金额）。