什么是 飞常准航空？

飞常准航空技能提供了一个强大的接口，可直接通过您的 AI 智能体访问全球航空情报。通过利用飞常准 MCP 服务器，此技能可以无缝检索航班状态、舒适度评估和详细的飞机注册数据。对于构建旅游助手或物流监控器的开发者来说，它是 Openclaw Skills 生态系统中不可或缺的补充。

该技能采用资源高效的按需架构设计，仅在执行命令时启动 MCP 服务器，并在返回数据后立即关闭。这确保了您的环境在保持高性能的同时，能够访问包括 IATA 机场代码和实时飞机跟踪坐标在内的高精度航空数据。

下载入口:https://github.com/openclaw/skills/tree/main/skills/lancenas/variflight-aviation

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

飞常准航空 应用场景

• 使用 HU7601 等航班号跟踪实时航班进度和延误情况。
• 使用 PEK 到 SHA 等 IATA 代码搜索特定机场之间的可用航线。
• 获取为期 3 天的机场天气预报，以便为潜在的行程中断做准备。
• 评估航班舒适度指数，包括机型评分和历史准点率。
• 使用注册号全球范围内监控特定飞机的动态。

1. 用户或 AI 智能体通过 Openclaw Skills 框架发起命令。
2. 使用提供的 API 凭据自动启动底层的 MCP 服务器。
3. 该技能向飞常准 API 发送请求以获取实时航空或气象数据。
4. 原始数据被解析成结构化格式，供智能体解释。
5. 查询完成后，MCP 服务器进程自动终止以释放系统资源。

飞常准航空 配置指南

要在 Openclaw Skills 库中使用此技能，您必须首先从飞常准 MCP 门户获取 API 密钥。使用以下方法之一配置您的环境：

方法 1：环境变量

export X_VARIFLIGHT_KEY="您的_api_key"

方法 2：本地配置 在项目根目录中创建一个 config.local.json 文件：

{
  "apiKey": "您的_api_key"
}

确保您已安装 Node.js >= 18.0.0 以正确运行 MCP 服务器。

飞常准航空 数据架构与分类体系

该技能使用标准行业分类法组织航空数据，以确保不同 Openclaw Skills 实现之间的兼容性：

航班搜索的示例 JSON 响应包括航班状态、准点率、航站楼信息和估计距离。

name: variflight-aviation
description: 飞常准航班信息查询 - 实时航班动态、航线搜索、舒适度评估、机场天气、飞机追踪
version: 1.0.0
author: lixiao
license: MIT

metadata:
  openclaw:
    emoji: "??"
    category: "travel"
    tags: ["flight", "aviation", "travel", "weather", "transport", "mcp", "variflight"]

    env:
      - X_VARIFLIGHT_KEY
      - VARIFLIGHT_API_KEY

    install:
      npm: "@variflight-ai/variflight-mcp"

    os:
      - darwin
      - linux
      - win32

    permissions:
      - network
      - env-read
      - file-read

    requirements: |
      系统要求：Node.js >= 18.0.0，npm >= 9.0.0

      配置要求：
      1. 注册 https://mcp.variflight.com/
      2. 创建 API Key
      3. 设置环境变量 X_VARIFLIGHT_KEY

      技术说明：使用 stdio 模式与 MCP 服务器通信

功能概述

本 Skill 通过飞常准 MCP 服务器提供全球航班信息查询服务，采用按需启动架构：

1. 每次调用命令时自动启动 MCP 服务器
2. 执行查询操作
3. 完成后自动关闭 MCP 服务器，释放资源

配置说明

方法 1：环境变量（推荐）

注意：Variflight 官方使用 X_VARIFLIGHT_KEY

export X_VARIFLIGHT_KEY="your_api_key_here"

或使用兼容变量名：

export VARIFLIGHT_API_KEY="your_api_key_here"

方法 2：本地配置文件

创建 config.local.json（已加入 .gitignore）：

{
  "apiKey": "your_api_key_here"
}

?? 注意：请勿将包含真实 API Key 的 config.local.json 提交到 Git！

可用命令

1. search - 航线搜索

@variflight-aviation search   

按出发地、目的地、日期搜索航班。

参数：

• dep: 出发机场 IATA 代码（如 PEK）
• arr: 到达机场 IATA 代码（如 SHA）
• date: 日期，格式 YYYY-MM-DD

示例：

@variflight-aviation search PEK SHA 2026-02-20

2. info - 航班号查询

@variflight-aviation info  

按航班号查询详细信息。

参数：

• fnum: 航班号（如 MU2157）
• date: 日期，格式 YYYY-MM-DD

示例：

@variflight-aviation info HU7601 2026-02-20

3. comfort - 舒适度指数

@variflight-aviation comfort  

获取航班舒适度评估，包括准点率、机型评分等。

示例：

@variflight-aviation comfort CA1501 2026-02-20

4. weather - 机场天气

@variflight-aviation weather 

查询机场未来3天天气预报。

参数：

• airport: 机场 IATA 代码（如 PEK）

示例：

@variflight-aviation weather PEK

5. transfer - 中转方案

@variflight-aviation transfer   

查询最优中转方案。

参数：

• depcity: 出发城市代码（如 BJS）
• arrcity: 到达城市代码（如 SHA）
• date: 日期，格式 YYYY-MM-DD

示例：

@variflight-aviation transfer BJS SHA 2026-02-20

6. track - 飞机追踪

@variflight-aviation track 

实时追踪飞机位置。

参数：

• anum: 飞机注册号（如 B-308M）

示例：

@variflight-aviation track B-308M

数据格式说明

机场代码（IATA）

• PEK: 北京首都
• PKX: 北京大兴
• SHA: 上海虹桥
• PVG: 上海浦东
• CAN: 广州白云
• SZX: 深圳宝安
• CTU: 成都天府
• HGH: 杭州萧山
• XIY: 西安咸阳
• CKG: 重庆江北

城市代码

• BJS: 北京（含 PEK/PKX）
• SHA: 上海（含 SHA/PVG）
• CAN: 广州
• SZX: 深圳

日期格式

• 标准格式：YYYY-MM-DD
• 示例：2026-02-20

返回数据示例

航班搜索返回

{
  "code": 200,
  "message": "Success",
  "data": [
    {
      "FlightNo": "HU7601",
      "FlightCompany": "海南航空股份有限公司",
      "FlightDepcode": "PEK",
      "FlightArrcode": "SHA",
      "FlightDeptimePlanDate": "2026-02-20 07:25:00",
      "FlightArrtimePlanDate": "2026-02-20 09:35:00",
      "FlightState": "计划",
      "OntimeRate": "93.33%",
      "ftype": "78A",
      "FlightHTerminal": "T2",
      "FlightTerminal": "T2",
      "CheckinTable": "F,G",
      "distance": "1178"
    }
  ]
}

隐私与安全声明

1. API Key 本地存储：仅存储在用户本地环境变量或配置文件中
2. 不上传云端：敏感信息不会上传到 ClawHub 或任何远程服务器
3. 日志脱敏：日志中 API Key 等敏感信息已脱敏处理
4. Git 保护：config.local.json 已加入 .gitignore，防止意外提交

故障排除

错误：API Key not configured / 401 Unauthorized

原因：未配置 API Key 或 Key 无效
解决：

• 确认已设置 X_VARIFLIGHT_KEY 环境变量
• 确认 API Key 已激活（验证邮箱）
• 确认 Key 未过期

错误：MCP server start timeout

原因：MCP 服务器启动超时
解决：

• 检查网络连接
• 确认 API Key 有效
• 检查 Node.js 版本 >= 18.0.0

错误：No flights found / 未找到航班

原因：未找到航班数据
解决：

• 确认日期格式正确（YYYY-MM-DD）
• 确认机场/城市代码正确
• 确认该航线在指定日期有航班

错误：Command not found

原因：命令拼写错误
解决：使用上述列出的标准命令名称

相关链接

• 飞常准 MCP 官方文档
• Model Context Protocol 规范
• OpenClaw 文档
• GitHub 仓库

许可证

MIT License ? 2026 lixiao