Clawdbot铁路查询返回空结果等问题，需依次检查API连通性、清除并刷新本地缓存、更新凭证与请求头配置、最后启用静态快照模式作为兜底方案。
如果您配置了Clawdbot用于实时查询铁路车次信息，但发现其返回空结果、过期数据或提示“无可用班次”，则可能是由于数据源接口失效、认证凭证过期或本地缓存未更新所致。以下是解决此问题的步骤：
一、验证车次数据源API连通性
Clawdbot依赖外部铁路数据接口（如12306官方开放平台或第三方聚合服务）拉取实时车次状态，若该接口不可达或返回非预期格式，将导致数据获取失败。
1、执行诊断命令检查数据源健康状态：
clawdbot datasource status --name train
2、手动测试底层API端点（以常见12306代理为例）：
curl -s "https://api.traindata.example/v1/schedules?from=BJP&to=SHH&date=20260130" -H "Authorization: Bearer ${TRAIN_API_KEY}" | jq '.code'
3、确认响应码是否为200且.data字段非空；若返回401、403或空数组，则说明凭证失效或权限不足。
二、重置并刷新本地车次缓存
Clawdbot默认对车次查询结果进行本地缓存以降低请求频率，但缓存策略可能因时间戳校验异常或磁盘写入失败而滞留陈旧数据，需强制清空并触发重新拉取。
1、定位缓存目录：
ls -d ~/.clawdbot/cache/train/* 2>/dev/null || echo 未找到车次缓存目录
2、删除全部车次相关缓存文件：
rm -rf ~/.clawdbot/cache/train/
3、触发一次即时刷新任务：
clawdbot datasource refresh --name train --force
4、观察日志输出是否出现“fetched N schedules”字样，确认新数据已载入。
三、更新车次数据源配置凭证与参数
部分车次API要求定期轮换Token或绑定IP白名单，若Clawdbot配置中使用的密钥已过期、调用频次超限或请求头缺失必要字段，将导致持续性数据获取失败。
1、查看当前配置中的凭证有效期字段：
cat ~/.clawdbot/clawdbot.json | jq '.datasources.train.auth.tokenExpiry'
2、若字段不存在或值早于 2026-01-30，需重新生成有效凭证。
3、编辑配置文件，确保包含必需请求头：
vi ~/.clawdbot/clawdbot.json
4、在train数据源节内补全headers对象：
"headers": {"User-Agent": "Clawdbot/2.8.3", "X-Request-ID": "auto"}
5、保存后重启数据网关：
clawdbot gateway restart
四、切换备用数据源或降级为静态快照模式
当主数据源长期不可用时，Clawdbot支持启用离线车次快照作为兜底方案，该模式使用每日凌晨自动下载的压缩版时刻表，虽不包含实时晚点/停运信息，但可保障基础查询功能可用。
1、启用静态快照模式：
clawdbot datasource config set train.mode snapshot
2、指定快照文件路径（若已手动下载）：
clawdbot datasource config set train.snapshotPath "/var/data/train-snapshot-20260130.json.gz"
3、强制加载快照数据：
clawdbot datasource load --name train --snapshot
4、验证快照加载结果：
clawdbot datasource info --name train | grep -i "loaded\|records"
