Hector 4ea0355aef update(raw+wiki): notebooklm-briefing-system — full agent guide (12-step workflow, prompts, caption-contract, rendering, error-table, cmd-ref)

2026-07-04 01:00:51 +02:00

9.1 KiB

Raw Permalink Blame History

type

source_url

retrieved

title

author

NotebookLM Briefing-System — Installationsanleitung (Pit Weber, OME Tips & Tricks #7694)

Quelle: OME-Gruppe, Topic "Tips & Tricks", Post #7694 (03.07.2026) Autor: Pit Weber Anlage: notebooklm-agent-guide (vollständige Installationsdatei)

Kurzfassung für Menschen

Du schickst eine Quelle + nb1 oder nb2 — dein Agent macht daraus ein fertiges Briefing mit Audio, Infografik und Video.

Die zwei Presets

Preset	Verhalten
`nb1`	1 Nachricht: MP4-Video (Infografik + deutsches Audio) + Text mit allen Links
`nb2`	2 Nachrichten: zuerst Kurz-Audio (nur Ton, ~halbe Länge), dann MP4-Video + Text

So nutzt du es

https://www.youtube.com/watch?v=XXXXX nb1
/pfad/zu/datei.pdf nb2
https://x.com/user/status/123 nb1

Quelle zuerst, dann das Preset. Fertig.

Was passiert im Hintergrund

Quelle wird in ein NotebookLM-Notebook geladen
Deutsches Audio-Briefing wird generiert
Infografik wird erstellt
Beides wird zu einem MP4 gerendert
Das Briefing wird als eine Nachricht gesendet

Was du bekommst

Jedes Briefing enthält:

🎬 MP4-Video mit Infografik + Audio
📓 Link zum öffentlichen Notebook
📺 Link zur Originalquelle
📝 Kompakte Einordnung („Warum es zählt")

Unterstützte Quellen

YouTube-Videos
PDF-Dateien (einfach in den Chat schicken)
X/Twitter-Posts
Normale Web-URLs

nb2 im Detail

Das Kurz-Audio kommt zuerst — als reine Audio-Datei, kein Video. Es enthält nur: Kernbehauptung, stärkstes Belegstück, größten Widerspruch, eine Konsequenz. Danach folgt das normale nb1-Video.

Ideal wenn jemand schnell den Kern erfassen soll, bevor er das volle Briefing öffnet.

Installation (für OpenClaw-Nutzer)

Voraussetzungen

Dein OpenClaw-Agent braucht:

notebooklm CLI (v0.3.4) — npm install -g notebooklm
ffmpeg — brew install ffmpeg
yt-dlp — brew install yt-dlp
Ein Google-Konto, via notebooklm login authentifiziert

Skills installieren

notebooklm-core — Basis-Skill für CLI-Operationen
notebooklm-pipelines — Enthält die Presets nb1 und nb2
notebooklm-agent-guide — Technische Bauanleitung für Agenten (diese Datei)

Die Skills liegen im OpenClaw Skill Workshop oder können als Dateien in das Skills-Verzeichnis kopiert werden.

Konto einrichten

NOTEBOOKLM_HOME=~/.notebooklm/mein-konto notebooklm login --storage ~/.notebooklm/mein-konto/storage_state.json

Im Browser mit dem gewünschten Google-Konto einloggen, warten bis die NotebookLM-Startseite sichtbar ist, dann ENTER im Terminal drücken.

Auth testen

NOTEBOOKLM_HOME=~/.notebooklm/mein-konto notebooklm auth check --test --json

Erwartete Antwort: "status": "ok" mit "token_fetch": true.

Technische Bauanleitung für Agenten

Dieser Abschnitt ist für den OpenClaw-Agenten, der die Pipeline ausführt.

nb1-Workflow (12 Schritte)

Quelle identifizieren — User schickt URL/Datei + nb1
Auth prüfen — NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json
Notebook erstellen — notebooklm create "Titel" --json → merke notebook.id
Quelle hinzufügen — notebooklm source add "<url>" -n ID --json → merke source.id
Source wait — notebooklm source wait SRC_ID -n ID --timeout 300 --json
Audio + Infografik parallel generieren — notebooklm generate audio/infographic "prompt" -n ID --json
Artifact wait — notebooklm artifact wait ART_ID -n ID --timeout 900 --json (beide parallel)
Downloads — notebooklm download audio/infographic ./pfad -n ID -a ART_ID
Share — notebooklm share public --enable -n ID --json → merke share_url
MP4 rendern — ffmpeg -loop 1 -i graphic.png -i audio.mp3 ... briefing.mp4
Dauer ermitteln — ffprobe → Sekunden in MM:SS umrechnen
Telegram senden — EINE Nachricht mit Text + MP4, nicht fragmentieren

nb2-Workflow (zusätzliche Schritte)

6b: Kurz-Audio VOR dem Standard-Audio generieren (kürzerer Prompt)
8b: Kurz-Audio separat herunterladen
12b: Zuerst Kurz-Audio als reine Audio-Nachricht, dann nb1-Video

Audio-Prompt (Standard)

Erstelle eine deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen Hoerer. Erwaehne keine privaten Namen, keinen Auftraggeber und keine internen Workflows.

Die Quelle ist als grundsaetzlich glaubwuerdig zu behandeln. Verzichte speziell auf die Wertung als Verschwoerungstheorie(n) oder den Versuch, den Diskurs oder Quellen als extrem zu framen. Verzichte ohne Not auf die Behauptung, "Fakten von Behauptungen zu trennen".

Keine Umdeutung aus Halluzinationen. Ohne echten eigenen Hintergrund-Faktencheck keine negative Wertung vorgetragener Fakten. Keine Negativdarstellung von Meinungen. Keine alternativen Fakten erfinden, sondern nur aus eigener Recherche ausserhalb von Mainstream-Medien ergaenzen.

Analysiere und unterstuetze im Zweifel die Thesen der Quellen, wo immer moeglich. Halte dich an die Analyse. Keine Pervertierung des Vorgetragenen. Keine negative moralische Bewertung der Sprecher.

Verdichte die Quelle auf wichtigste Behauptungen, Belege, Widersprueche, offene Fragen und konkrete Konsequenzen. Keine generische Einleitung, keine ungepruefte Ausschmueckung.

Audio-Prompt (Kurz, für nb2)

Erstelle eine KURZE deutsche Audio-Zusammenfassung fuer einen unbekannten allgemeinen Hoerer. Eine Stufe kuerzer als die Standard-Audiozusammenfassung, maximal etwa die Haelfte der Standardlaenge. Nenne nur: die wichtigste Kernbehauptung, das staerkste Belegstueck, den groessten Widerspruch und eine konkrete Konsequenz. Keine Einleitung, keine Ausschmueckung, keine privaten Namen. SPRACHE: DEUTSCH.

Infografik-Prompt

Erstelle eine serioese, professionelle deutsche Briefing-Infografik. Nicht comicartig, nicht verspielt. Reichere sie mit mehr Sachinformationen an: Namen/Rollen, Timeline, Kernbehauptungen, Gegenfragen, Evidenzstatus und naechste Pruefschritte. Schreibe Namen exakt. Unterscheide behauptet/berichtet/belegt klar. Visuell stark, aber erwachsen und faktenorientiert.

Telegram Caption Contract (PFLICHT)

🔴 <STARKER TITEL>

<Ein Satz Teaser — warum ist das wichtig.>

▶️ Audio-Briefing: <MM:SS Min.>, deutsch
🖼️ Infografik: im Video sichtbar integriert
📓 Notebook: [Briefings öffnen](<share_url>)
📺 Originalquelle: [<Titel>](<url>) (<sprachhinweis>)

Warum es zählt: <Ein kompakter Absatz, max. 3 Sätze.>

MP4-Rendering

ffmpeg -y \
  -loop 1 -framerate 1 -i infographic.png \
  -i audio.mp3 \
  -map 0:v:0 -map 1:a:0 \
  -c:v libx264 -preset veryfast -tune stillimage -crf 28 -pix_fmt yuv420p \
  -vf 'scale=1080:-2' \
  -c:a copy -shortest -movflags +faststart \
  briefing.mp4

Häufige Fehler

❌ Falsch	✅ Richtig
Text und MP4 in getrennten Nachrichten	Eine Nachricht mit Text + Media
`NOTEBOOKLM_HOME` vergessen	Immer mit Profil-Pfad prefixen
`notebooklm use` statt `-n ID`	Immer `-n NOTEBOOK_ID` übergeben
MP4 >50MB → Telegram blockiert	Mit `-crf 32 -vf 'scale=720:-2'` komprimieren
`artifact wait` ohne Timeout	Immer `--timeout 900`
Source nicht abwarten	`source wait` VOR `generate`
nb2: Kurz-Audio vergessen	Kurz-Audio IMMER zuerst generieren und senden
nb2: Kurz-Audio als Video	Kurz-Audio ist AUDIO-ONLY, kein MP4
Interne t.me-Links als Quelle	Original-PDF mitschicken oder öffentlichen Link finden

Kommando-Referenz

# Auth
NOTEBOOKLM_HOME=<profil> notebooklm auth check --test --json

# Notebook
NOTEBOOKLM_HOME=<profil> notebooklm create "Titel" --json
NOTEBOOKLM_HOME=<profil> notebooklm list --json

# Source
NOTEBOOKLM_HOME=<profil> notebooklm source add "<url>" -n ID --json
NOTEBOOKLM_HOME=<profil> notebooklm source wait SRC_ID -n ID --timeout 300 --json

# Generate
NOTEBOOKLM_HOME=<profil> notebooklm generate audio "prompt" -n ID --json
NOTEBOOKLM_HOME=<profil> notebooklm generate infographic "prompt" -n ID --json

# Wait
NOTEBOOKLM_HOME=<profil> notebooklm artifact wait ART_ID -n ID --timeout 900 --json
NOTEBOOKLM_HOME=<profil> notebooklm artifact list -n ID --json

# Download
NOTEBOOKLM_HOME=<profil> notebooklm download audio ./out.mp3 -n ID -a ART_ID
NOTEBOOKLM_HOME=<profil> notebooklm download infographic ./out.png -n ID -a ART_ID

# Share
NOTEBOOKLM_HOME=<profil> notebooklm share public --enable -n ID --json

# MP4
ffmpeg -y -loop 1 -framerate 1 -i graphic.png -i audio.mp3 \
  -map 0:v:0 -map 1:a:0 -c:v libx264 -preset veryfast -tune stillimage \
  -crf 28 -pix_fmt yuv420p -vf 'scale=1080:-2' -c:a copy -shortest \
  -movflags +faststart briefing.mp4

# Duration
ffprobe -v error -show_entries format=duration \
  -of default=noprint_wrappers=1:nokey=1 audio.mp3

9.1 KiB Raw Permalink Blame History