07. OpenClaw 单平台 VOC 洞察课教学手册

课程定位：面向 OpenClaw 用户，教会学员在 OpenClaw 中调用 VOC Skills，完成一次单平台 VOC 洞察报告，而不是教学员在本地写脚本或理解内部开发链路。

1. 课程一句话

用 OpenClaw 的 VOC Skills，从一个品类和 3-5 个关键词出发，完成单平台 VOC 数据采集、用户原声归纳、机会判断和报告生成。

2. 适用对象

已安装或准备安装 OpenClaw 的用户。
运营、产品、内容、电商、品牌负责人。
想用小红书、抖音、Amazon、TikTok、Instagram 等平台做轻量 VOC 洞察的人。
不要求会写代码，但需要能理解品类、关键词和业务问题。

3. 本课不讲什么

不讲本地 Node.js 脚本开发。
不讲完整企业级多平台深度报告。
不讲爬虫原理和 API 实现细节。
不把用户原声直接包装成医学、功效或全市场结论。

4. 课上最终成果

学员完成课程后应拿到以下成果：

成果	说明
单平台 VOC 数据包	平台内容样本、评论样本、关键词统计和采集审计
VOC 洞察报告	Markdown 或 OpenClaw 可展示的报告正文
VOC 证据卡	能回到平台、关键词、批次和原声 ID 的证据
机会判断	高频主题、产品/内容机会和风险边界
行动清单	P0/P1/P2 下一步动作和验证指标
可选 HTML 报告	课程展示或交付演示用 HTML v2 报告

5. 推荐课程主线

录课时建议把课程分成 7 段：

段落	标题	学员动作	讲师重点
1	今天要生成什么	看最终报告样例	明确不是学代码，而是用 OpenClaw 生成洞察
2	准备品类和关键词	输入品类、平台、关键词	关键词决定数据质量
3	调用平台采集技能	运行单平台 mini VOC skill	看样本量、失败请求和数据边界
4	生成 VOC 洞察	调用单平台报告技能	看主题、证据卡、机会点
5	读懂报告	对照原声解释结论	结论必须能回到 VOC 原声
6	导出与审计	生成 Markdown/HTML，检查质量	低样本只写阶段性信号
7	换成自己的品类	替换关键词复跑	形成个人 SOP

6. 课前准备

6.1 学员准备

学员需要准备：

OpenClaw 已安装并可打开。
已安装 VOC 相关技能包。
已完成 Token 或数据服务权限配置。
一个想分析的品类或产品方向。
3-5 个关键词。

6.2 讲师准备

讲师需要准备：

一份已跑通的课程样例报告。
一份小红书课程样例数据，防止真实 API 不稳定。
一套标准输入 JSON 或表单参数。
一份“结果怎么看”的讲解脚本。

课程样例可使用：

demo/xiaohongshu/platform-mini-report/platform-mini-report.html

7. 标准课堂输入

建议所有学员先用统一输入跑通，再换自己的品类。

{
  "project": "openclaw-voc-course-demo",
  "platform": "xiaohongshu",
  "category": "冻干益生菌",
  "businessQuestion": "用户为什么会关注冻干益生菌，当前内容和产品机会在哪里？",
  "keywords": [
    "儿童益生菌怎么选",
    "益生菌腹胀便秘",
    "冻干益生菌测评"
  ],
  "sampleMode": true,
  "outputFormat": "both"
}

8. OpenClaw 技能调用主线

8.1 课程理想链路

voc/voc-single-platform-report
  → token / 权限预检
  → xiaohongshu/xiaohongshu-mini-voc 或 douyin/douyin-mini-voc
  → VOC 数据归一化
  → 单平台 mini report 生成
  → HTML v2 报告生成
  → 报告质量审计
  → 返回报告和下一步建议

8.2 当前可用能力

当前仓库已经具备底层能力：

小红书采集编排：xiaohongshu/xiaohongshu-mini-voc
抖音采集编排：douyin/douyin-mini-voc
本地归一化脚本：scripts/tools/voc-data-normalizer.js
本地单平台报告脚本：scripts/tools/platform-mini-report-generator.js
本地章节草稿脚本：scripts/tools/chapter-insight-writer.js
本地 HTML v2 生成入口：voc-report-factory/html-v2/gen-report-template.js

8.3 当前缺口

对 OpenClaw 用户来说，课程总入口规范已新增：

voc/voc-single-platform-report

下一步需要把归一化、报告生成、HTML 渲染和审计包装成可执行层，让这个总入口真正完成无脚本用户体验。

9. 讲师逐段讲稿

第 1 段：展示最终成果

讲师打开最终 HTML 报告，告诉学员：

今天的目标不是“抓一堆数据”。
今天的目标是得到一份能辅助决策的 VOC 洞察报告。
每条关键判断都必须能回到用户原声。

推荐展示：

demo/xiaohongshu/platform-mini-report/platform-mini-report.html

第 2 段：解释最小输入

讲师说明只需要 4 类输入：

输入	例子	作用
平台	小红书	决定采集技能和报告语境
品类	冻干益生菌	决定报告主题
关键词	儿童益生菌怎么选	决定样本入口
业务问题	用户为什么关注这个品类	决定报告解释方向

第 3 段：调用平台 VOC 采集

如果使用小红书，调用：

xiaohongshu/xiaohongshu-mini-voc

如果使用抖音，调用：

douyin/douyin-mini-voc

讲师重点提醒：

样本量不足时不能做全市场判断。
搜索结果可能有平台噪声。
关键词不要只写品牌词，要包含痛点词、场景词、竞品词。

第 4 段：生成单平台 VOC 洞察

理想情况下调用：

voc/voc-single-platform-report

该技能应输出：

一句话结论
数据概况
H1-H8 覆盖速查
高频主题聚类
VOC 原声证据卡
产品/内容机会
风险与边界
行动清单

第 5 段：带学员读懂报告

讲师不要只展示漂亮页面，要逐项解释：

报告模块	教学重点
样本量	这份报告能支持多大范围的判断
高频主题	用户在反复说什么
原声证据卡	哪句话支撑哪个判断
机会点	如何从声音转成产品或内容动作
风险边界	哪些结论不能写过头
行动清单	课后第一周怎么验证

第 6 段：导出与审计

讲师提醒学员交付前检查：

是否有足够 VOC 原声。
是否有来源、关键词、批次和 ID。
是否出现空结论或占位文本。
是否把用户感受写成未经验证的医学或功效结论。
是否给出下一步验证动作。

第 7 段：换成自己的品类

学员课后复用步骤：

换成自己的品类。
写 3-5 个关键词。
先用一个平台跑小样本。
看报告中的主题和证据。
补充关键词或换平台复跑。
把行动清单改成自己的业务动作。

10. 录课脚本建议

开场 3 分钟

今天我们用 OpenClaw 完成一份单平台 VOC 洞察报告。你不需要写代码，只需要准备平台、品类、关键词和想回答的问题。OpenClaw 会帮你调用对应技能，采集用户声音，并生成一份可追溯的 VOC 报告。

方法讲解 10 分钟

VOC 洞察报告不是数据截图，它至少要回答三件事：

用户到底在说什么。
哪些声音最稳定、最值得相信。
这些声音能转成什么产品、内容或增长动作。

实操演示 50-70 分钟

按以下顺序录屏：

打开 OpenClaw。
选择或说明 voc-single-platform-report 总入口。
输入课程样例参数。
展示平台采集过程或样例数据。
展示生成的 mini report。
打开 HTML 报告。
逐项解释证据卡、主题和行动建议。

复用讲解 10 分钟

告诉学员换品类时不要直接换报告文本，而要换：

平台
关键词
业务问题
证据卡
行动清单

11. 课堂常见问题

Q1：关键词怎么选？

先用 3 类关键词：

痛点词：如腹胀、便秘、没效果。
场景词：如儿童、熬夜、送礼、孕期。
决策词：如怎么选、测评、避坑、对比。

Q2：样本少能不能写报告？

可以写阶段性观察，但不能写全市场结论。建议话术是：

基于当前样本，观察到一个初步信号……

不要写：

全市场用户都认为……

Q3：能不能直接用于客户交付？

课程版报告是初稿。客户交付前必须：

补样本。
人工复核原声。
检查合规边界。
做质量审计。

Q4：API 不稳定怎么办？

课程录制和课堂演示必须准备 sample mode。先用课程样例跑通完整链路，再说明真实采集时需要 Token 和平台 API 稳定性。

12. 与内部 6 阶段 SOP 的关系

02-standard-report-workflow.md 是内部交付和高阶训练营 SOP。

本教学手册是 OpenClaw 用户入门课。两者关系如下：

场景	使用文档
2 小时 OpenClaw 单平台实操课	`07-openclaw-single-platform-course.md`
内部报告交付 SOP	`02-standard-report-workflow.md`
高阶系统训练营	`02-standard-report-workflow.md` + `voc-report-factory/`
开发者验证脚本链路	`examples/report-factory-demo/README.md`

13. 讲师检查清单

录课前确认：

已有一份能打开的 HTML 样例报告。
已准备课程标准输入。
已说明 sample mode 和真实采集的区别。
已说明低样本边界。
已说明结论必须回到 VOC 原声。
已说明 OpenClaw 用户不需要运行本地脚本。

14. 后续产品化要求

为了让课程真正面向 OpenClaw 用户，需要将以下能力产品化为 Skill：

优先级	Skill	作用
P0	`voc/voc-single-platform-report`	单平台 VOC 报告总入口
P0	`voc/voc-platform-mini-report-generator`	从 VOC 数据生成 mini report
P0	`voc/voc-html-report-generator`	从 mini report 或 chapter insights 生成 HTML
P1	`voc/voc-data-normalizer`	多平台数据归一化
P1	`voc/voc-report-auditor`	报告交付前质量审计
P2	`voc/voc-hypothesis-generator`	H1-H8 假设辅助生成
P2	`voc/voc-collection-matrix-builder`	关键词矩阵辅助生成

07-openclaw-single-platform-course.md 10 KB Állandó hivatkozás Előzmények Nyers