需启用“查快递”Skill并配置快递100 API权限,再通过微信自然语言发送单号触发查询;若失败可补发格式化指令;也可用邮箱中转或直连QTrack等专用接口。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜

如果您在使用QClaw过程中希望实时获取快递物流状态,但发现无法直接通过微信对话触发查询结果,则可能是由于QClaw尚未默认启用快递查询类技能或未正确关联第三方物流接口。以下是实现该功能的具体操作路径:
一、启用“查快递”Skill并配置API权限
QClaw本身不内置快递物流数据库,需通过Skills生态调用外部服务,“查快递”Skill是ClawHub官方认证的物流聚合插件,支持对接快递100、17TRACK等平台,启用后可在微信中以自然语言发起查询请求。
1、打开QClaw主界面,点击左下角「Skills管理」按钮。
2、在搜索框中输入“查快递”,找到对应Skill卡片并点击「启用」。
3、进入该Skill设置页,选择「快递100 API」作为默认数据源,若无账号则点击「立即注册」跳转至快递100开发者平台完成免费申请。
4、将获取到的API Key粘贴至QClaw Skill配置栏,点击「保存并验证」,系统将自动测试连通性。
二、通过微信对话触发物流查询
启用Skill后,QClaw可通过语义识别解析用户发送的快递单号,并自动调用对应接口返回结构化物流信息,无需额外指令前缀,适配日常聊天场景。
1、在已绑定QClaw的微信对话窗口中,直接发送包含有效单号的消息,例如:“我的圆通单号是YT123456789CN”。
2、等待约2–5秒,QClaw将回复一条含时间轴、节点状态与承运商图标的卡片式消息。
3、如遇识别失败,可补发格式化指令:“查单号YT123456789CN”,强制触发解析流程。
三、使用IMAP-SMTP-Email通道手动投递查询请求
当微信直连通道因网络策略受限或Skill未响应时,可切换至邮箱中转机制:将单号信息以特定格式邮件发送至QClaw监听邮箱,系统将自动解析并回传物流详情至发件人邮箱。
1、在QClaw设置中进入「邮箱通道」页,开启IMAP/SMTP开关,并填写个人邮箱账户及授权码。
2、新建一封邮件,收件人设为QClaw分配的专属监听地址(形如qclaw-xxxx@qclaw.local)。
3、邮件主题必须为:[LOGISTIC] YT123456789CN,正文仅保留单号,无其他字符。
4、发送后30秒内,QClaw将向该邮箱返回HTML格式物流追踪页,含最新扫描记录与预计送达时间。
四、调用QTrack或17TRACK专用接口直连查询
针对QTrack、速貓、DHL等特定承运商包裹,QClaw支持通过预置URL模板直接构造请求,绕过通用Skill层,提升响应精度与字段完整性。
1、进入QClaw高级设置中的「自定义API路由」模块。
2、新增一条规则,匹配关键词“QTrack”,目标URL填写:https://api.qtrack.dev/v1/track?number={tracking_id}。
3、在微信中发送消息:“查QTrack单号QT987654321”,QClaw将自动提取QT开头单号并拼接请求。
4、返回结果将优先展示QTrack原生节点描述,包括清关状态、航班号、仓库操作代码等专业字段。










