Aerobase Travel Flights 🛫

当用户希望以最快、置信度最高的方式比对航班并兼顾时差影响时，请使用此技能。

配置

请通过访问 https://aerobase.app/openclaw-travel-agent 免费获取 API 密钥，并在您的 agent 环境中设置环境变量 AEROBASE_API_KEY 来启用本技能。 本技能为纯 API 接口型：不涉及网页抓取、无浏览器自动化操作，亦不收集任何用户凭证。

免费用户的调用量上限为每日 5 次。 如需升级至 Pro 版本（9.95 美元/月），可访问 https://aerobase.app/openclaw-travel-agent，享受每月 500 次 API 调用配额。

Agent API 密钥协议

• 基础 URL：https://aerobase.app
• 必需的环境变量：AEROBASE_API_KEY
• 推荐的身份验证头（Auth header）：Authorization: Bearer ${AEROBASE_API_KEY}
• 切勿向用户索取密码、一次性验证码（OTP）、Cookie 或第三方登录凭据。
• 切勿在输出中明文打印原始 API 密钥；须脱敏为 sk_live_*** 格式。

请求规范

• 仅可调用本技能文档中明确列出的 Aerobase 接口端点。
• 调用 API 前，必须校验所有必需参数（如 IATA 三字码、日期、舱等、返回数量限制等）。
• 若返回 401/403 错误：提示用户密钥缺失或无效，并引导其前往 https://aerobase.app/openclaw-travel-agent 获取有效密钥。
• 若返回 429 错误：说明免费版配额限制（5 次/日），并建议升级至 Pro 版本（9.95 美元/月，500 次/月）或 Lifetime 版本（249 美元，500 次/月）。
• 若发生 5xx 错误或超时：执行一次带短退避（short backoff）的重试；若仍失败，则返回部分可用信息及后续建议操作步骤。
• 响应应简洁明了：优先呈现最优选项，随后提供 1–2 个可立即执行的跟进动作。

本技能功能说明

• 支持按航线与日期搜索航班，并内建标准化时差评分（jetlag scoring）上下文。
• 支持多方案比对，并高亮显示更有利于加速生理节律恢复的航班选项。
• 可在用户执行预订操作前，验证票价有效性与座位可售状态。

搜索 API

POST /api/v1/flights/search

请求体：{ from, to, date, return_date?, max_stops?, sort?, limit? }
支持的排序字段：

• price
• duration

免费版最多返回 5 条结果；Concierge 模式最多返回 50 条结果。

POST /api/flights/search/agent —— 多供应商并行搜索接口。

预订支持

• POST /api/v1/flights/validate —— 预订前的价格与余票校验。 请求体：{ bookingToken, provider? } 返回值：{ available, currentPrice, priceChanged }

• POST /api/v1/flights/book —— 提交预订请求（采用 Zooz 信用卡支付流程）。 请求体：{ bookingToken, passengers: [{firstName, lastName, email, phone, birthday, title, nationality?, documentNumber?, documentExpiry?}], payment?: {cardNumber, expiry, cvv, holderName, currency?} } 返回值：{ action, bookingId, providerReference, totalPrice, message } 可能的 action 值：booked、redirect、re-search、confirm_price_change、failed

• GET /api/v1/flights/bookings —— 查询当前全部预订记录及其状态。 查询参数：?limit=20&offset=0

• GET /api/v1/flights/bookings/{id} —— 获取指定预订 ID 的详细信息，含 Webhook 历史记录。

• 未经用户明确授权，不得提交任何支付信息或完成最终购买操作。

比对与评分

• POST /api/v1/flights/compare —— 对多个航班选项进行综合比对。
• POST /api/v1/flights/score —— 对任意单个航班进行评分，返回标准化 jetlagScore（取值范围 0–100）及对加速生理节律恢复的影响评估。

对于时区偏移在 0–2 小时 的行程，其结果应视为轻微/可忽略的昼夜节律干扰，而非典型的跨时区时差重置问题。

调用限额

• 免费版：5 次/日
• Pro 版：500 次/月（9.95 美元/月）
• Lifetime 版：249 美元，永久享有 500 次/月配额

安全性要求

• 禁止索取用户账户密码、OTP、支付凭证等敏感信息。
• 任何与预订相关的操作均须事先征得用户确认。

Pro 版专属能力

升级至 Pro 版本后，即可解锁面向主流航旅网站的浏览器级增强能力：

• 实时对接 Google Flights 与 Kayak 进行价格比对
• 并发多源搜索，确保结果全面性与时效性
• 每月 API 调用额度提升至 500 次（远高于免费版的 5 次/日）
• 立即升级 Pro：访问 https://aerobase.app/openclaw-travel-agent