Takeout 外卖助手 - Clawdot虾点·文档中心

这是什么

Takeout 外卖助手 帮用户把一顿外卖点完：搜附近店铺、看菜单选菜、预览下单、追踪订单——全流程一站搞定。它是一个建立在网关之上、可安装的技能包，装在你的 Agent（Claude Code / OpenClaw / Codex）上。装好后，Agent 通过调用技能 CLI 暴露的子命令（1:1 对应网关 MCP 工具名）来完成点单，不直接接触网关接口——交互流程、措辞规范、纠错引导都已封装在技能里，开箱即用。

想自己用裸接口编排底层能力？技能背后是网关的 24 个外卖 MCP 工具。需要细粒度控制时看 MCP 概览；本页讲的是”装上即用”的封装。

安装

技能仓为三个 Agent 平台各提供一条安装命令，把 <platform> 换成对应平台即可：

# Claude Code
curl -fsSL https://raw.githubusercontent.com/clawdot/open-gateway-clawdot-skill/main/install.sh | bash -s -- takeout claude-code

# OpenClaw
curl -fsSL https://raw.githubusercontent.com/clawdot/open-gateway-clawdot-skill/main/install.sh | bash -s -- takeout openclaw

# Codex（在项目根目录执行）
curl -fsSL https://raw.githubusercontent.com/clawdot/open-gateway-clawdot-skill/main/install.sh | bash -s -- takeout codex

安装脚本会从最新 Release 下载、校验 sha256、解压到正确位置（指定版本可在末尾加 v1.0.0）。装完后，在技能根目录放一个 .env：

API_KEY=clw_your_api_key                                    # 必填：Agent 身份
GATEWAY_MCP_URL=https://eleme-gateway.hicaspian.com/mcp/v1  # MCP 端点（默认即此，可不填）
# CONSENT_GRANT_ID=                                          # 只读预注入（可选）；正常流程绑定后凭证存共享缓存 ~/.clawdot/
# 可选：CLAWDOT_HOME（共享凭证缓存目录）、DEFAULT_LAT / DEFAULT_LNG（冷启动兜底定位）

其中 API_KEY 必填，GATEWAY_MCP_URL 用默认值即可。到控制台创建 Agent、开通外卖能力，拿到 clw_ 开头的 API Key。

鉴权

技能采用双层身份，但你只需注入一个值：API_KEY。

API_KEY（Agent 身份，clw_ 前缀）： 唯一必需注入项，写进 .env。缺失时脚本返回 RECOVERY[API_KEY_MISSING]，引导去控制台拿 key。
consent_grant（用户授权，cg_ 前缀）： 代表一个已授权用户，有效期 90 天。开局留空，由用户本人走一次绑定生成。

绑定走两步（SMS 默认，也支持 H5 链接）：

request_user_bind（第 1 步，发短信 / 返回授权链接）→ verify_user_bind（第 2 步，验码 / 轮询）→ 成功后凭证写入共享缓存（~/.clawdot/credentials.json，按 API_KEY + 手机号隔离，skill 升级重装不丢）。

单用户： 绑定一次后，业务调用无需 --phone。
多用户： 一个 API_KEY 可服务多个用户，各自绑定一次；业务调用带 --phone <11位手机号> 指定是谁（按手机号存共享缓存）。

无 admin 静默绑定。 每个用户必须本人授权一次——没有任何后台密钥能替用户跳过这一步。

12 个命令

Agent 通过 CLI 子命令调用（子命令 1:1 对应网关 MCP 工具名）：python3 scripts/clawdot.py <command> [--phone <手机号>]。

command	用途	关键参数
`search_addresses`	列出已存地址；带 `--keyword` 搜索新地址	`--keyword? --city? --lat? --lng?`
`select_address`	保存地址（候选 `--sug-ref` 或已存 `--address-id`）	`--sug-ref? --address-id? --contact-name --contact-phone --address-detail? --tag?`
`search_shops`	搜索附近店铺	`--keyword? --lat? --lng? --city?`
`recommend`	搜店 + 并行取 top N 家菜单一步到位（复合命令）	`--keyword? --lat? --lng? --top-n?`（默认 3，最多 5）
`get_shop_menu`	菜单钻取（概览 → 分类 → 商品详情）	`--shop-id --category? --item-id? --keyword?`
`get_item_options`	批量查商品完整规格 / 加料（含选中标记）	`--shop-id --items（JSON 数组）`
`preview_order`	预览订单 → `preview_id` + `confirmation_token`	`--shop-id --address-id --items（JSON 数组） --note?`
`create_order`	确认下单 → `order_id` + `payment_link`（付款链接）	`--preview-id --confirmation-token`
`get_order_status`	查询订单配送状态	`--order-id`
`get_user_auth_status`	查询用户授权状态（验活凭证）	`--phone?`
`request_user_bind`	绑定第 1 步（默认发短信；`--auth-type h5` 返回授权链接）	`--phone --auth-type?(sms/h5)`
`verify_user_bind`	绑定第 2 步（SMS 验码 / H5 轮询），成功写共享缓存	sms：`--phone --bind-id --code`；h5：`--phone --auth-type h5 --request-id`

下单 item 模型

preview_order 的 --items 是一个 JSON 数组，每个元素描述一个商品：

[
  {
    "item_id": "item_xxx",
    "quantity": 1,
    "sku_id": "sku_xxx",
    "ingredient_option_ids": ["opt_xxx"],
    "remark": "少冰"
  }
]

item_id、quantity 必填；sku_id、ingredient_option_ids、remark 可选。
sku_id 取自商品的 sku_options[].sku_id（不传用默认规格）；ingredient_option_ids 取自 ingredient_options[].option_id。
所有 id 都来自当前店的 get_shop_menu 输出——禁止跨店复用，禁止把中文菜名当 id。
金额字段单位均为分。

交互范式

技能的”灵魂”是一套统一的交互约定，让 Agent 知道每一步是成功还是失败、该怎么对用户说话。 成功 / 失败信号：

成功 = 脚本 stdout 返回 JSON。
失败 = stderr 输出中文错误 + RECOVERY[CODE]: <下一步>，非零退出码。Agent 按 RECOVERY 提示挑下一个 action——例如 USER_NOT_BOUND_NEEDS_SMS → 走 request_user_bind / verify_user_bind 绑定；引用过期（如 REFERENCE_STALE）→ 重新 search_shops → get_shop_menu 拿新 id。

执行铁律：

默认能服务——技能已加载就当可点单推进，别凭空拒答。
不谎报成功——成功结论以 stdout 实际返回为准。
地址先确认——选定收货地址、跟用户确认后再推进下单。
追问带选项——需要用户决策时给出 2~3 个选项，别开放式发问。

对用户说人话： 用用户视角讲”你做了什么、我帮你找了什么、下一步是什么”。禁止对用户暴露内部术语、字段名、内部 id（preview_id、confirmation_token 等只在 Agent 内部流转）。

下一步

MCP 概览

想自己编排底层 24 个工具、做细粒度控制？看裸 MCP 工具契约。

安装与平台

Claude Code / OpenClaw / Codex 各平台的安装与触发细节。

​这是什么

​安装

​鉴权

​12 个命令

​下单 item 模型

​交互范式

​下一步

MCP 概览

安装与平台

这是什么

安装

鉴权

12 个命令

下单 item 模型

交互范式

下一步