QClaw支持五种批量查询快递单号物流状态的方法：一、CSV模板+任务模板批量创建；二、剪贴板条件触发自动感知；三、IMAP/SMTP邮件通道投递；四、CLI命令行调用已注册技能；五、Webhook对接外部系统推送。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在QClaw中需一次性获取多个快递单号的实时物流状态，而非逐个手动触发查询，则可能因任务配置缺失、通道未启用或数据格式不合规导致批量追踪失败。以下是实现QClaw物流快递单号批量查询和状态跟踪的多种可行方法：
一、通过CSV模板+任务模板批量创建物流查询任务
该方式利用QClaw内置的任务模板机制，将单号列表与标准化查询逻辑绑定，自动生成并执行多个独立物流查询任务，适用于已知全部单号且需保留完整执行记录的场景。
1、进入QClaw主界面，点击左侧导航栏中的“模板管理”。
2、点击右上角“新建模板”按钮，选择任务类型为“HTTP请求”，模板名称设为“物流单号查询”。
3、在请求URL字段填入目标快递查询API地址（如快递100标准接口），并在请求体中插入变量${tracking_number}作为单号占位符。
4、保存模板后，准备CSV文件：首行为字段名“tracking_number”，后续每行一个有效单号，无空行、无多余符号。
5、进入“批量创建”页面，选择该模板，上传CSV文件，系统将为每一行单号生成对应查询任务并自动入队执行。
二、启用条件触发规则实现复制即查的自动批量感知
该方法不依赖人工导入，而是让QClaw主动监听系统剪贴板内容，一旦检测到符合快递单号正则模式的字符串组合（如圆通YT开头12位、中通ZT开头13位），立即触发预设的批量解析与查询流程，适合高频零散单号输入场景。
1、进入QClaw自动化设置页，点击“新增条件触发规则”。
2、在触发条件中选择“剪贴板内容匹配”，正则表达式填写：^(YT|ZT|SF|SF[0-9]{10}|JD[0-9]{12}|YD[0-9]{12})[A-Za-z0-9]{6,15}$。
3、动作设置为“启动物流查询流程”，并勾选“自动合并连续匹配项为批量请求”。
4、粘贴包含多个单号的文本（以换行或空格分隔），QClaw将在3秒内识别全部有效单号，并调用浏览器插件或API通道并发查询。
三、使用IMAP-SMTP-Email通道批量投递查询请求
当微信直连通道受限或需离线提交时，可将多个单号按规范格式封装进一封邮件，由QClaw监听邮箱自动拆解、并行调用各快递公司接口完成状态抓取，结果以HTML表格形式统一回传。
1、在QClaw设置中进入「邮箱通道」页，开启IMAP/SMTP开关，并填写个人邮箱账户及应用专用授权码。
2、确认QClaw分配的专属监听地址（形如qclaw-batch@qclaw.local）已在邮箱通道页显示为“已验证”状态。
3、新建邮件，收件人设为上述监听地址；主题严格按格式填写：[BATCH-LOGISTIC] YT123456789CN,ZT9876543210123（单号间用英文逗号分隔，无空格）。
4、邮件正文仅保留一行纯文本：YT123456789CN ZT9876543210123 SF123456789012345（单号间以单个空格分隔）。
5、发送后60秒内，QClaw将向发件邮箱返回一封含完整物流轨迹的HTML邮件，每个单号对应独立区块，含最新扫描时间、操作站点及承运商标识。
四、通过CLI命令行批量调用已注册的物流查询技能
该方式绕过图形界面，直接调用QClaw底层引擎执行高并发查询指令，适用于已将单号预存为任务ID或需集成至定时巡检脚本的技术用户。
1、确保已安装QClaw CLI工具，并执行qclaw-cli login --token YOUR_API_TOKEN完成认证。
2、准备纯文本文件batch_ids.txt，每行一个已成功创建的物流查询任务ID（可通过QClaw任务历史页复制获取）。
3、执行命令：qclaw-cli batch run --task-list batch_ids.txt --concurrency 8 --timeout 30s。
4、CLI将实时输出各任务的状态码与响应耗时，所有结果日志自动写入batch_run_$(date +%Y%m%d_%H%M%S).log文件。
五、对接Webhook接收外部系统推送的批量单号并自动分发
适用于订单系统、ERP或WMS等后台服务需主动向QClaw推送待查单号的场景，QClaw通过校验签名接收JSON载荷，动态生成子任务并绑定批次标签，支持后续统一状态聚合与异常监控。
1、在QClaw设置中启用“Webhook接收器”，记录下提供的回调URL与HMAC-SHA256签名密钥。
2、构造POST请求，Header中添加X-QClaw-Signature: hmac-sha256=xxx，Body为JSON格式：
{"batch_id": "SHIP20260516001", "items": [{"tracking_number": "YT123456789CN"}, {"tracking_number": "ZT9876543210123"}]}
3、QClaw接收到请求后，自动校验签名，若通过则为每个items元素生成独立物流查询任务，并打上标签batch_id:SHIP20260516001。
4、所有子任务状态可通过访问/api/v1/batch/SHIP20260516001/status端点获取，响应中包含各任务的state字段（pending/running/success/failed）及最新物流节点摘要。
