# 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 或表单参数。
- 一份“结果怎么看”的讲解脚本。

课程样例可使用：

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

## 7. 标准课堂输入

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

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

## 8. OpenClaw 技能调用主线

### 8.1 课程理想链路

```text
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 用户来说，课程总入口规范已新增：

```text
voc/voc-single-platform-report
```

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

## 9. 讲师逐段讲稿

### 第 1 段：展示最终成果

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

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

推荐展示：

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

### 第 2 段：解释最小输入

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

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

### 第 3 段：调用平台 VOC 采集

如果使用小红书，调用：

```text
xiaohongshu/xiaohongshu-mini-voc
```

如果使用抖音，调用：

```text
douyin/douyin-mini-voc
```

讲师重点提醒：

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

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

理想情况下调用：

```text
voc/voc-single-platform-report
```

该技能应输出：

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

### 第 5 段：带学员读懂报告

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

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

### 第 6 段：导出与审计

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

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

### 第 7 段：换成自己的品类

学员课后复用步骤：

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

## 10. 录课脚本建议

### 开场 3 分钟

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

### 方法讲解 10 分钟

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

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

### 实操演示 50-70 分钟

按以下顺序录屏：

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

### 复用讲解 10 分钟

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

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

## 11. 课堂常见问题

### Q1：关键词怎么选？

先用 3 类关键词：

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

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

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

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

不要写：

```text
全市场用户都认为……
```

### 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` | 关键词矩阵辅助生成 |