核心用法
Hotel Booking AI 是一个面向 OpenClaw Agent 的 B2B 酒店预订技能,提供从搜索到支付的全链路实时预订能力。核心功能包括:
- 目的地搜索(
search_location):按城市、地标或酒店名称获取区域ID - 酒店搜索(
search_hotels):按区域ID、入住日期、离店日期、成人数查询,返回最多3家最低价酒店 - 房型比价(
query_room_rates):获取指定酒店的房型、价格、餐食、取消政策 - 价格确认与锁房(
check_room_availability):验证实时价格并锁定房源,返回最终有效的rate_code - 创建订单(
create_booking):无需手机号/邮箱,仅需客人姓名即可下单 - 支付发起(
pay_order):支持微信支付(payment_type: 11)和支付宝(payment_type: 12) - 订单管理(
query_booking/cancel_booking):查询状态、取消订单
标准流程:搜索区域 → 搜索酒店 → 查询房型 → 确认锁价 → 创建订单 → 发起支付 → 查询/取消
显著优点
1. 全流程自动化:从搜索到支付一站式完成,无需人工介入
2. 实时数据驱动:所有房价、房态、可订性均来自 live API,拒绝训练数据幻觉
3. 中国本地支付:原生集成微信支付与支付宝,适合国内用户
4. 取消政策透明:cancelPolicyInfos 字段明确标注免费取消截止时间与违约金
5. 轻量鉴权:单文件 user_key.txt 存储,支持自动刷新与失效重认证
潜在缺点与局限性
1. 数据伪造风险:技能明确禁止编造酒店、房型、价格,但依赖模型自律执行;若 API 故障且无备用源,用户体验中断
2. 区域覆盖未知:文档未说明支持哪些国家/地区的酒店库存
3. 价格时效性问题:query_room_rates 与 check_room_availability 分两步调用,期间价格可能变动;虽后者锁定价格,但用户决策窗口存在
4. 取消政策误读风险:refundable: true 与 amount > 0 的组合需精确理解,模型易混淆"可取消"与"免费取消"
5. 单点故障:所有请求指向单一阿里云 NLB 地址,无多区域容灾说明
6. 支付链路外跳:支付需用户点击 pay_url 完成,非应用内闭环,存在转化率损失
适合人群
- 需要快速完成酒店预订的终端用户
- 集成酒店库存至客服/助理场景的 OpenClaw Agent 开发者
- 以中国大陆出行为主、偏好微信/支付宝支付的旅客
常规风险
| 风险类型 | 描述 | 缓解措施 |
|---------|------|---------|
| 认证失效 | `user_key` 过期返回 HTTP 401 | 自动删除 `user_key.txt` 并引导用户重新授权 |
| 价格波动 | 查询与锁价期间房价变动 | 强制使用 `check_room_availability` 返回的 `total_price` 下单 |
| 取消费用争议 | 用户误解 `amount` 含义 | 明确告知 `startDateTime` 为免费取消截止时间 |
| 数据幻觉 | 模型编造不存在的房型/价格 | 系统级强制规则:仅使用 API 返回数据 |
| 支付失败 | 外链支付页面异常 | 保留 `agent_ref_id` 供用户人工客服追单 |
> 来源可信度:T2(阿里云基础设施 + 明确的鉴权与 API 规范,但无第三方审计报告)