Files
skill-template/logistics-tracker/SKILL.md
2026-04-04 10:35:02 +08:00

1.6 KiB
Raw Blame History

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

物流轨迹查询

使用时机

当用户发送以下内容时触发本Skill

  • 包含物流单号(字母+数字组合,如 RR123456789CNUPS1234567890
  • 询问"我的货到哪了"、"帮我查单号"、"物流查询"、"查一下快递"等

执行步骤

  1. 从用户消息中提取物流单号
  2. 执行查询脚本:
python3 {baseDir}/scripts/main.py <单号>
  1. 将脚本返回结果直接回复给用户
  2. 如果用户没有提供单号,回复:"请发送您要查询的物流单号,我来帮您查询最新状态。"

输出格式

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

错误处理

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

注意事项

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