notebooklm.md规范

位置: <素材目录>/notebooklm.md,例如 20260301-如何让openclaw产出生产力目录下存放文件notebooklm.md。该文件用于声明 NotebookLM 项目的源文件清单和计划生成的 artifact 类型及参数。

如下是一个同时生成音频和视频文件的最简单例子,各参数的含义见后文。

## global

language = "zh_Hans"

## sources

- https://example.com/article

## audio

enabled = true
format = "DEEP_DIVE"
length = "DEFAULT"

## report

enabled = true
format = "BRIEFING_DOC"
append = "添加实际应用案例"

文件格式

notebooklm.md 采用 Markdown 格式,由以下部分组成:

  1. 全局配置小节 - ## global 块,设定全局参数(如语言)
  2. 源声明小节 - ## sources 块,列出要添加到 NotebookLM notebook 的源文件,包括本地文件和网页链接,需要注意的是,链接必须是无需密码和无需登录就可以访问的。
  3. 生成配置小节 - 若干 ## <artifact类型> 块,声明要生成的 artifact 及其参数

全局配置(global)

## global 小节中设置全局参数:

language = "zh_Hans"

参数说明:

  • language - 生成内容的语言代码
    • en - 英文

    • zh_Hans - 简体中文 ✓ 推荐用于中文项目

    • zh_Hant - 繁体中文

    • ja - 日文

    • ko - 韩文

    • es - 西班牙文

    • fr - 法文

    • de - 德文

源声明(sources)

声明要添加到 notebook 的源:自动扫描项目文件和/或远程 URL。

## sources

- https://example.com/article
- https://www.youtube.com/watch?v=...
- docs/architecture.md
- README.md

工作机制

自动扫描项目文件: 项目根目录下的所有文件(除了隐藏文件、outputs 目录和 notebooklm.md)会自动添加到 notebook。

远程 URL:http://https:// 开头的行被识别为 URL,支持网页文章、YouTube 视频等公开网络资源。

本地文件路径: 相对于项目根目录的本地文件路径,支持 Markdown、PDF、代码文件、音视频和图像等多种格式。

Artifact 生成配置

Audio(音频)

生成 NotebookLM 风格的 AI 主持人播客音频。

## audio 小节中声明:

enabled = true description = "请主持人深度讨论核心概念" format = "DEEP_DIVE" length = "DEFAULT"

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 生成提示,用自然语言描述期望的生成内容
format DEEP_DIVE, BRIEF, CRITIQUE, DEBATE 风格类型,这些概念对应了NotebookLM网页上列出的选项
length SHORT, DEFAULT, LONG 音频时长

Video(视频讲解)

生成动画化的视频讲解。

## video 小节中声明:

enabled = true description = "面向初学者的入门讲解" format = "EXPLAINER" style = "WHITEBOARD"

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 生成提示,用自然语言描述期望的生成内容
format EXPLAINER, BRIEF, CINEMATIC 视频格式(电影风格需高级订阅),这些概念对应了NotebookLM网页上列出的选项
style AUTO_SELECT, CLASSIC, WHITEBOARD, KAWAII, ANIME, WATERCOLOR, RETRO_PRINT, HERITAGE, PAPER_CRAFT 视觉风格,这些概念对应了NotebookLM网页上列出的选项

Cinematic Video(电影级视频)

需要 Google AI Ultra 订阅的高级视频生成。

## cinematic_video 小节中声明:

enabled = false description = "纪录片风格深度分析"

Report(报告文档)

生成结构化的文本报告。

## report 小节中声明:

enabled = true description = "" format = "BRIEFING_DOC" append = "添加代码示例和最佳实践" custom_prompt = ""

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 指导如何生成报告内容
format BRIEFING_DOC, STUDY_GUIDE, BLOG_POST, CUSTOM 报告格式
append 字符串 追加到内置模板的额外指令(仅非 CUSTOM)
custom_prompt 字符串 完全自定义的生成提示(仅 format = "CUSTOM"

Quiz(测验)

生成选择题或简答题测验。

## quiz 小节中声明:

enabled = false description = "" difficulty = "MEDIUM" quantity = "STANDARD"

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 测验主题或重点
difficulty EASY, MEDIUM, HARD 难度等级
quantity FEWER, STANDARD 题量

Flashcards(学习卡片)

生成 Anki 兼容的学习卡片。

## flashcards 小节中声明:

enabled = false description = "" difficulty = "EASY" quantity = "STANDARD"

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 学习重点或主题
difficulty EASY, MEDIUM, HARD 难度等级
quantity FEWER, STANDARD 卡片数量

Infographic(信息图)

生成视觉化的信息图表。

## infographic 小节中声明:

enabled = false description = "核心概念对比知识图" orientation = "LANDSCAPE" detail = "STANDARD" style = "PROFESSIONAL"

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 信息图主题和重点
orientation LANDSCAPE, PORTRAIT, SQUARE 方向/宽高比
detail CONCISE, STANDARD, DETAILED 信息密度
style AUTO_SELECT, SKETCH_NOTE, PROFESSIONAL, BENTO_GRID, EDITORIAL, INSTRUCTIONAL, BRICKS, CLAY, ANIME, KAWAII, SCIENTIFIC 艺术风格

Slide Deck(幻灯片)

生成可下载为 PDF 或 PPTX 的演示文稿。

## slide_deck 小节中声明:

enabled = false description = "" format = "DETAILED_DECK" length = "DEFAULT"

参数详解:

参数 可选值 说明
enabled true/false 是否生成此 artifact
description 文字描述 演讲主题和目标受众
format DETAILED_DECK, PRESENTER_SLIDES 幻灯片风格
length DEFAULT, SHORT 幻灯片数量

Data Table(数据表)

生成结构化数据表格(CSV 格式)。

## data_table 小节中声明:

enabled = false description = "对比各核心概念的异同"

参数说明:

  • enabled - 是否生成
  • description - 描述表格主题和对比维度

Mind Map(思维导图)

生成层级化思维导图(JSON 格式)。

## mind_map 小节中声明:

enabled = false

说明: Mind Map 为同步生成,无额外参数。

完整示例

最小化配置(仅音频 + 报告)

## global

language = "zh_Hans"

## sources

- https://example.com/article

## audio

enabled = true
format = "DEEP_DIVE"
length = "DEFAULT"

## report

enabled = true
format = "BRIEFING_DOC"
append = "添加实际应用案例"

完整配置(多类型生成)

## global

language = "zh_Hans"

## sources

- https://github.com/project/blob/main/README.md
- docs/architecture.md
- README.md

## audio

enabled = true
description = "技术架构和设计模式的深度讨论"
format = "DEEP_DIVE"
length = "DEFAULT"

## video

enabled = true
description = "面向新手开发者的入门教程"
format = "EXPLAINER"
style = "WHITEBOARD"

## report

enabled = true
format = "STUDY_GUIDE"
append = "包含完整代码示例和最佳实践"

## slide_deck

enabled = true
description = "技术分享演讲"
format = "PRESENTER_SLIDES"
length = "DEFAULT"

## infographic

enabled = true
description = "项目架构组件关系图"
orientation = "LANDSCAPE"
detail = "STANDARD"
style = "PROFESSIONAL"

## quiz

enabled = false
difficulty = "MEDIUM"
quantity = "STANDARD"

## flashcards

enabled = true
description = "关键概念和 API 学习卡"
difficulty = "MEDIUM"
quantity = "STANDARD"

## mind_map

enabled = true

输出文件映射

生成的 artifact 将被下载到 outputs/ 目录,命名规则如下:

Artifact 类型 文件格式 示例文件名
audio MP3 outputs/audio_abc123.mp3
video MP4 outputs/video_abc123.mp4
cinematic_video MP4 outputs/cinematic_abc123.mp4
report Markdown outputs/report_abc123.md
quiz JSON outputs/quiz_abc123.json
flashcards JSON outputs/flashcards_abc123.json
infographic PNG outputs/infographic_abc123.png
slide_deck PDF / PPTX outputs/slides_abc123.pdf
data_table CSV outputs/data_table_abc123.csv
mind_map JSON outputs/mind_map_abc123.json

注意事项

  1. language 全局性 - 语言设置影响所有 artifact,不可针对单个 artifact 独立设置

  2. enabled 标志 - 仅 enabled = true 的 artifact 会被生成;缺省值为 false

  3. 多个类型的产出物 - 可重复声明相同类型的 artifact block,配置不同参数,每个启用的 block 会独立生成,比如不同风格的多个视频文件生成

  4. source 优先级 - 默认情况下本软件会将素材目录下的所有文件(除了outputs目录和notebooklm.md文件)都上传,如果你还想要添加一些网页的链接,可以填写在这里。

  5. 高级功能 - cinematic_video 等某些功能需要 Google AI Ultra 订阅

快速参考

常用组合

学习资料生成:

  • Audio + Report + Flashcards + Quiz
  • 适合快速理解和学习

内容营销:

  • Video + Infographic + Blog Post
  • 适合自媒体和内容创作

技术文档:

  • Report (STUDY_GUIDE) + Slide Deck + Mind Map
  • 适合团队培训和知识沉淀

演讲准备:

  • Audio + Slide Deck + Infographic

  • 适合会议分享和公开演讲

故障排除

问题 原因 解决方案
某个 artifact 未生成 enabled = false 或字段被注释 确保 enabled = true
生成语言不对 全局 language 设置错误 检查 ## global 块的 language
源文件未被识别 路径错误或文件类型不支持 检查 sources 中的文件路径和类型
任务卡在处理中 网络问题或 API 超时 稍后重试,检查 NotebookLM 账户状态