ClawHub

mt-travel-ai

Security

基于美团酒旅供给，处理旅游出行需求，包括提供酒店、机火、门票、度假等商品的查询交易能力，以及定制化旅行攻略能力，打通从“灵感启发”到“一键下单”的全链路。

Install

openclaw skills install mt-travel-ai

美团旅行助手 Skill

为用户提供完整的旅行服务，包括目的地推荐、行程规划、酒店推荐预订、机票/火车票查询、景点门票、度假跟团等。

适用场景边界

✅ 使用此 skill：

  • "想去踏青赏花，推荐几个必去的城市"
  • "周末两天适合去哪里玩"
  • "带小孩去哪里旅游比较好"
  • "春天适合去的国内景点"
  • "从北京出发去哪玩"
  • "明天去武汉的火车票"
  • "去南方的特价机票"
  • "北京到清远的交通方案"
  • "两大一小怎么买上海迪士尼门票"
  • "帮我订这周末开封的情侣酒店，预算500内离万岁山1公里内"

❌ 不使用此 skill：

  • 出国签证申请、护照办理流程
  • 非旅行相关的外卖、打车、跑腿等美团其他业务

核心执行流程

  1. 提取参数 — 识别用户的「当前定位城市」（获取不到默认北京）和「查询需求」。若用户明确指定了出发地，以用户指定为准。
  2. 鉴权准备（Token 检查） — 调用 CLI 前，必须先执行下方的【Token 管理流程】。
  3. 安抚等待 — 该 API 执行耗时较长（约 1-2 分钟），请务必先向用户发送：

    🔍 正在连接美团酒旅数据接口为您规划，耗时约 1-2 分钟，请稍候...

  4. 执行 CLI — 使用 mttravel 调用 API，传入参数。
  5. 解析与渲染输出 — 严格按照下方的【输出规范】向用户展示最终结果。

Token 管理流程

Step 1：检查本地配置

检查 ~/.config/meituan-travel/config.json 是否存在且包含 key 字段。

  • ✅ 如果存在且非空 → 读取 token，直接进入 Step 4
  • ❌ 如果不存在或为空 → 进入 Step 2

Step 2：引导用户创建

向用户发送以下原话（务必原样输出）：

🔑 需要配置 API Token 请前往美团开发者中心入驻个人开发者并创建 Token： 点击此处前往创建 Token 创建完成后，请将 Token 字符串发给我，我会帮您保存并继续查询。

(等待用户回复 Token)

Step 3：保存 Token

收到 Token 后，执行以下命令将其保存至 config.json：

mkdir -p ~/.config/meituan-travel
cat > ~/.config/meituan-travel/config.json << 'EOF'
{
  "key": "<用户提供的token>"
}
EOF

保存成功后告知用户：「✅ Token 已保存，正在为您查询…」，然后继续执行。

Step 4 — 执行 CLI

CLI 会自动从 ~/.config/meituan-travel/config.json 读取 Token，直接执行： mttravel [城市] ""

Token 失效处理（CLI 返回鉴权错误时）

当 CLI 执行返回错误信息包含以下关键词时，触发此流程：

  • "鉴权失败"
  • "无效的访问令牌"
  • "Token"
  • "未设置"
  • "access token"
  • "key"

必须立即执行以下步骤：

情况 A：config.json 存在但 Token 失效

向用户发送：

⚠️ Token 已失效，需要更新

请前往开发者中心重新创建 Token

⚠️ Token 为极高敏感凭证，禁止在对话中打印 Token 明文

创建完成后，请将新 Token 发送给我，我会更新并重新查询。

收到新 Token 后，执行：

cat > ~/.config/meituan-travel/config.json << 'EOF'
{
  "key": "<新token>"
}
EOF

然后重新执行 CLI 查询。

情况 B：config.json 不存在或为空

重新执行 Step 2 和 Step 3。

CLI 调用方式

前置要求

npm i -g @meituan-travel/travel-cli

执行命令

mttravel [城市] ""

CLI 会自动从 ~/.config/meituan-travel/config.json 读取 Token。

⚠️ 严格输出规范

为保证数据真实性和信息完整性，在将工具结果返回给用户时，必须绝对遵守以下原则。无论用户使用的是微信、飞书还是任何其他客户端，你都必须无视渠道差异，严格执行以下标准 Markdown 输出，绝对禁止自作主张进行“格式降级”：

  1. 零压缩/零删减原则
  • 必须将 CLI 工具输出的全部文字内容原样呈现，绝不允许合并段落、删减字数。不得省略酒店名、商品名、价格、评分、标签、描述、图片、链接等转化关键信息。
  • 可做轻量排版整理，但不得删减事实信息，不得把完整描述压缩成只有几个要点。
  1. 渠道展示总原则
  • 渲染工作由最终客户端负责，大模型的职责仅限于输出完整的 Markdown 文本，绝不允许出现“吞掉图片”、“去除超链接只保留文字”的行为。
  • 接口返回的内容中若包含 Markdown 格式的图片（![alt](url)）和超链接（[text](url)），必须 100% 原样透传输出。
  • 严禁猜测或假设当前聊天渠道（如微信/飞书）不支持 Markdown 而擅自将图片和链接剥离。
  • 【微信渠道特供】：如果检测到当前用户处于 微信 渠道，你必须优先调用 message 工具，将包含完整 Markdown（图片、链接等）的内容作为参数传递给该工具发送。严禁在微信渠道直接将内容作为普通文本回复，否则会导致排版失效。
  1. 图片强制内嵌展示
  • CLI 输出中包含的图片格式（如 ![图片描述](图片URL)），必须原封不动输出。
  • 若 CLI 输出的是裸露的图片 URL（以 http 开头，包含 .jpg .png 等后缀），必须强制包裹为 Markdown 内嵌图片格式渲染：![](图片URL)。
  • 红线规定：禁止仅展示图片链接文字而不渲染图片；禁止以“查看图片”超链接替代内嵌展示；图片必须紧跟对应商品内容之后，禁止移至末尾。
  1. 超链接强制保留：
  • 接口返回的跳转链接（如 [**隐山酒店**](http://...)），必须完整保留中括号和小括号的结构。
  • 若工具输出中有裸露的 URL 链接，必须转换为 Markdown 超链接格式，如：[点击查看详情](https://...)。
  1. 真实数据合规强制标注
  • 凡涉及评分字段（如用户评分/口碑），必须强制修改为加粗的特定格式，例：4.8分（美团真实评分）。
  • 凡涉及星级字段（如酒店星级），必须强制修改为，例：美团5星级。
  • 距离等实时数据，在首次出现时需在句末或括号内补充标注 (美团实时数据)。
  • 除上述明确规定的「格式包装」,绝对禁止对工具返回的任何数值进行主观篡改、四舍五入或伪造。
  1. 价格原样输出
  • CLI 返回的价格字符串必须原样展示，禁止做任何解读、转换或补充说明。
  • 例如后端返回 ￥4XX起/晚，必须原样输出 ￥4XX起/晚，禁止转换为 ￥400+起/晚、￥400起/晚 等任何变体形式。
  • 价格中的占位符（如 X、XX、XXX）是后端的脱敏处理，不得自行还原或猜测实际数值。

🆘错误处理预案

遇到异常情况你的应对策略
网络超时（>120s）安抚用户：“请求超时啦，当前查询人数较多，请换个问法或稍后再试。”
查询失败展示错误信息，建议用户换个问法重试
城市无法识别停止猜测，主动询问用户确认具体的出发城市或目的地名称。
返回内容为空告知用户暂无相关结果，建议调整查询关键词

注意事项

  1. 响应时间约 1-2 分钟，调用前必须告知用户耐心等待
  2. query 越具体推荐越精准，引导用户提供：出发城市、时间、人数、预算、旅行风格
  3. Token 为极高敏感凭证，禁止在对话中打印 Token 明文
  4. 不适用于：出国签证相关问题、海外目的地咨询
More in Security