✦overview.md
Key Features
- ·国内航班搜索
- ·舱位查询
- ·机票预订下单
- ·机票改期
- ·机票退票
- ·订单详情查询
Use Cases
- →搜索从北京到上海的航班并查看价格
- →用户确认后预订机票
- →查询已预订订单的详细信息
- →为已购买的机票改期到其他日期
- →为已购买的机票办理退票
Best for
- ✓分贝通用户
- ✓国内机票预订
- ✓出差场景
Not ideal for
- !国际航班
- !无分贝通账号用户
FAQs
name
fbt-flight
description
分贝通机票助手 - 实现国内航班搜索、舱位查询、预订下单、机票改期、机票退票。适用于用户询问航班、查询机票价格、提交机票订单、改期航班、退票时使用。
version:1.0.0
metadata:{"openclaw":{"emoji":"✈️","category":"travel","tags":["分贝通","机票","航班","预订","改期","退票"],"requires":{"bins":["python3"]},"required":true}}
分贝通机票助手
当用户询问航班搜索、舱位查询、机票预订、机票改期或机票退票时，使用此 skill 调用分贝通机票服务。
运行环境要求
本 skill 通过 python3 执行 HTTP POST 请求调用分贝通机票服务。运行环境必须提供 python3。
隐私与个人信息（PII）说明
预订功能会将用户提供的个人信息（乘客姓名、手机号、证件号等）通过 HTTP POST 发送至分贝通机票服务，以完成机票预订。使用本 skill 即表示用户知晓并同意上述 PII 被发送到外部服务。请勿在日志或回复中暴露用户个人信息。
可用工具
重要：下方示例中的参数均为占位，调用时需根据用户当前需求填入实际值（城市、日期、航班号、乘机人、联系方式等），勿直接照抄示例值。
适用场景
- 按出发/到达城市、日期搜索航班列表
- 查看指定航班的舱位价格详情
- 用户确认后创建机票预订订单
- 查询已创建订单的详细信息
- 用户确认后改期或退票已创建订单的航班
鉴权流程（必须先完成）
重要：使用任何功能前，用户必须先完成鉴权流程。鉴权成功后获得的 apiKey 会自动保存在用户主目录的 ~/.fbt_auth.json 文件中，新会话会自动沿用。
鉴权步骤
- 发送验证码：用户提供手机号，系统发送验证码到手机
- 验证并获取 apiKey：用户输入验证码，验证成功后获得 apiKey
- 自动注入：后续所有 API 调用会自动携带 apiKey
鉴权命令
1. 发送验证码
python3 scripts/auth.py send <phone>
示例：
python3 scripts/auth.py send 13800138000
2. 验证并获取 apiKey
python3 scripts/auth.py verify <phone> <code>
示例：
python3 scripts/auth.py verify 13800138000 123456
3. 查看鉴权状态
python3 scripts/auth.py status
鉴权检查规则
- 在执行任何航班查询、预订、改期、退票操作前，必须先检查鉴权状态
- 如果未鉴权或 apiKey 已过期，必须引导用户完成鉴权流程
- 鉴权成功后，所有 API 调用会自动携带 apiKey，无需手动传递
1. 航班搜索 (searchFlight)
$install
1-click copynpx skills add LeoYeAI/openclaw-master-skills --skill fbt-flightSafety assessment
★
Clarity score
How clear and easy to understand the SKILL.md instructions are, rated from 1 to 5.
5/ 5
excellentVery clear and well structured, with almost no room for misunderstanding.
◎
Actionability score
How directly an agent can act on the SKILL.md instructions, rated from 1 to 5.
5/ 5
very highHighly actionable with clear, concrete steps that an agent can follow directly.