android-order

# Android Order Skill (点餐)

This skill uses the paired Android device (`OpenClaw SMS Demo` app with order capability) to manage an in-app menu and cart: get menu, add/remove items, view cart, submit order. Inspired by EdgeOSToolService (MEOW PAY); implementation is in-memory on the device (demo, no real POS backend).

## When to use this skill

- User asks to order food/drinks, view menu, add to cart, or submit an order on the paired Android device: use the `order.*` commands below.

## Commands overview

| Command | Description |
|--------|-------------|
| `order.getGoods` | Return menu (id, name, priceCents, price). |
| `order.getSelectedGoods` | Return current cart with quantities and subtotals. |
| `order.addGoods` | Add by `id` or `name` (and optional `quantity`). |
| `order.removeGoods` | Remove by `id` or `name` (and optional `quantity`). |
| `order.clearGoods` | Clear cart. |
| `order.submitOrder` | Submit cart as order; returns summary (demo only). |
| `order.batchAddGoods` | Add multiple items: `list` = `[{"id":"1","quantity":2},...]`. |

## How to call the underlying commands

Invoke via the OpenClaw gateway node invoke API:

- **command**: one of `order.getGoods`, `order.getSelectedGoods`, `order.addGoods`, `order.removeGoods`, `order.clearGoods`, `order.submitOrder`, `order.batchAddGoods`.
- **paramsJSON**: JSON object string, or `null` for no-param commands.

### order.getGoods

- `command`: `"order.getGoods"`
- `paramsJSON`: `null` or `"{}"`
- Success: payload is a JSON array of `{ "id", "name", "priceCents", "price" }`.

### order.getSelectedGoods

- `command`: `"order.getSelectedGoods"`
- `paramsJSON`: `null` or `"{}"`
- Success: payload is a JSON array of cart items with `id`, `name`, `quantity`, `priceCents`, `subtotalCents`.

### order.addGoods

- `command`: `"order.addGoods"`
- `paramsJSON`: provide **id** or **name** (or both); optional **quantity** (default 1).

  ```json
  { "id": "1", "quantity": "2" }
  ```
  or
  ```json
  { "name": "拿铁", "quantity": "1" }
  ```

- Success: payload includes `success: true` and `message` (e.g. "已添加 拿铁 x1").

### order.removeGoods

- `command`: `"order.removeGoods"`
- `paramsJSON`: same shape as addGoods (`id` or `name`, optional `quantity`).

### order.clearGoods

- `command`: `"order.clearGoods"`
- `paramsJSON`: `null` or `"{}"`.

### order.submitOrder

- `command`: `"order.submitOrder"`
- `paramsJSON`: `null` or `"{}"`.
- Success: payload includes `success`, `message`, `totalCents`, `items`. Cart is cleared after submit.
- Error: `CART_EMPTY` if cart is empty.

### order.batchAddGoods

- `command`: `"order.batchAddGoods"`
- `paramsJSON`: `{ "list": "[{\"id\":\"1\",\"quantity\":2},{\"id\":\"2\",\"quantity\":1}]" }`
- Success: payload includes `success` and `message` (e.g. "已批量添加 2 项").

## Error handling

- **GOODS_NOT_FOUND**: No menu item matched the given id or name. Suggest calling `order.getGoods` to see the menu.
- **NOT_IN_CART**: Item not in cart when removing.
- **CART_EMPTY**: Cannot submit when cart is empty.
- **INVALID_REQUEST**: Missing or malformed params (e.g. empty `list` for batchAddGoods).

## Demo menu (default on device)

The in-app menu includes items such as: 拿铁, 美式, 卡布奇诺, 三明治, 沙拉, 蛋糕 (with ids "1"–"6"). Use `order.getGoods` to get the current list and prices.

## Safety notes

- This is a demo flow: submit order does not charge or send to a real POS. Do not expose as real payment.
- Prefer confirming with the user before submitting an order (e.g. read back cart and total).