---
name: 物流轨迹查询
description: 物流轨迹查询。当用户发送物流单号、询问包裹状态、问"货到哪了"、"帮我查单号"等时使用。调用17Track API查询最新轨迹并用中文回复。支持全球200+承运商。
version: 1.0.0
author: 深圳匠厂科技有限公司
metadata:
  openclaw:
    slug: logistics-tracker
    emoji: "📦"
    category: "通用"
    requires:
      env:
        - TRACK17_API_KEY
      bins:
        - python3
allowed-tools:
  - bash
---

# 物流轨迹查询

## 使用时机

当用户发送以下内容时触发本Skill：
- 包含物流单号（字母+数字组合，如 `RR123456789CN`、`UPS1234567890`）
- 询问"我的货到哪了"、"帮我查单号"、"物流查询"、"查一下快递"等

## 执行步骤

1. 从用户消息中提取物流单号
2. 执行查询脚本：
```bash
python3 {baseDir}/scripts/main.py <单号>
```

3. 将脚本返回结果直接回复给用户
4. 如果用户没有提供单号，回复："请发送您要查询的物流单号，我来帮您查询最新状态。"

## 输出格式

脚本会返回格式化好的中文结果，直接发送给用户即可，无需二次处理。

## 错误处理

- 查询失败：告知用户"该单号暂时查询不到，可能未入网，请稍后再试"
- 网络超时：告知用户"网络连接超时，请稍后重试"
- 无效单号：告知用户"单号格式不正确，请检查后重新发送"

## 注意事项

- 每次只处理一个单号
- API Key 通过环境变量 `TRACK17_API_KEY` 读取，不要硬编码在脚本里
- 免费套餐每月100次查询，正式使用需升级