openclaw-voc-skill/docs/5.30/task/case-guides/case-07-live-error-fix.md

案例 7：live 采集常见错误修复

这个案例解决什么问题

当真实采集失败时，知道怎么判断下一步，而不是停在错误提示里。

你需要准备什么

• 已安装 VOC 技能包
• 一个测试采集任务
• 如需 live，准备可用 VOC_TOKEN

常见状态

状态	含义	处理方式
needs_token	没检测到 token	配置 .env.local
needs_valid_token	token 无效	重新配置有效 token
needs_recharge	确实需要开通或充值	打开充值链接
needs_keyword_fix	关键词或搜索入参问题	换短关键词重试
no_live_samples	没采到有效样本	换关键词或扩大范围

抖音关键词修复示例

原关键词	修复后
茶饮18元22元	茶饮 18元 22元
茶饮价格性价比新客套餐点单避坑评论区问题很多	茶饮 性价比 新客
奶茶第一次来不知道怎么点怕踩雷	奶茶 点单 避坑

换行业怎么填

这篇默认修复茶饮关键词。换成其它行业时，保留“短关键词、加空格、小规模重试”的方法，把关键词换成 品类 + 问题词。
例如把“茶饮 券后价”换成“宠物医院 绝育 价格”，把“茶饮 会不会踩雷”换成“轻医美 避坑”。

操作步骤

截图保存到 docs/5.30/task/case-guides/screenshots/case-07-live-error-fix/

第 1 步：截取错误状态输出

先保留工具返回的状态、提示语和平台，不要急着重跑。

截图说明：

第 2 步：判断状态类型

根据状态判断是 token、余额、关键词、无样本还是平台返回异常。

截图说明：

第 3 步：修改关键词或入参

如果是 needs_keyword_fix，优先把长关键词拆短，并在数字、品类、问题词之间加空格。

这次抖音 live 采集返回 needs_keyword_fix，或疑似把关键词/入参错误误判成余额不足。
请不要直接当成充值问题处理。

业务目标：提升茶饮新客转化。
价格带：18-22 元。
当前想补采的问题：
1. 券后价 / 首单优惠 / 团购 / 套餐 / 划算吗；
2. 口味稳不稳 / 甜度 / 茶底 / 配料表；
3. 点单 / 怎么点 / 会不会踩雷 / 外卖到手体验。

请先帮我把原本过长或没有空格的关键词，改成适合抖音搜索接口的短关键词。
要求：
1. 每个关键词控制在 2-4 个词；
2. 数字、品类、问题词之间加空格；
3. 先给 6 个关键词；
4. 再用修复后的关键词重新做小规模 live 采集；
5. 如果仍失败，请判断是 token、余额、关键词、无样本还是平台接口异常。

截图说明：

第 4 步：重新小规模采集

用修复后的关键词重新采集，先跑小样本，确认接口能正常返回。

截图说明：

第 5 步：确认修复后成功输出

看到样本数、评论数、证据样本后，再继续进入问题池或报告流程。

截图说明：

完成标准

• 能区分 token、余额、关键词、无样本。
• needs_keyword_fix 不走充值。
• 修复后能继续采集或给出可执行下一步。