53 lines
1.6 KiB
Markdown
53 lines
1.6 KiB
Markdown
---
|
||
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次查询，正式使用需升级 |