--- type: other source_url: "ome-group://tips-and-tricks/7746" retrieved: 2026-07-04 title: "NotebookLM Agent Guide V2 — nb1/nb2 Bauanleitung mit korrigiertem Audio-Prompt, Skill-Sektion, 12-Schritt-Workflow" author: "Pit Weber" tags: [notebooklm, briefing, pipeline, audio, video, mp4, infographic, automation, presets, agent-skills, ffmpeg, yt-dlp, caption-contract, v2] --- # NotebookLM Agent Guide V2 — nb1/nb2 Bauanleitung (Pit Weber, OME Tips & Tricks #7746) **Quelle:** OME-Gruppe, Topic "Tips & Tricks", Post #7746 (03.07.2026) **Autor:** Pit Weber **Anlage:** `notebooklm-agent-guide-v2` (vollständige Bauanleitung, korrigierte Version) ## Was wurde korrigiert (V1 → V2) - Audio-Prompt enthält jetzt den **korrekten Quellen-Respekt-Prompt** (kein „Fakten von Behauptungen trennen"-Disclaimer mehr) - Neuer **Abschnitt 10**: Welche Skills ein Agent braucht + in welcher Reihenfolge er sie lesen muss - Alle drei Skills sind jetzt **live** (nicht mehr pending) ## Die drei Skills | Skill | Zweck | Pfad | |---|---|---| | `notebooklm-core` | CLI-Grundbefehle, Auth, Account-Binding | `skills/notebooklm-core/SKILL.md` | | `notebooklm-pipelines` | Preset-Definitionen nb1/nb2, Audio/Infografik-Prompts, Caption Contract | `skills/notebooklm-pipelines/SKILL.md` | | `notebooklm-agent-guide` | Schritt-für-Schritt-Workflow (diese Datei) | `skills/notebooklm-agent-guide/SKILL.md` | **Reihenfolge beim Lesen:** Zuerst `notebooklm-core` (Grundlagen), dann `notebooklm-pipelines` (was soll rauskommen), dann `notebooklm-agent-guide` (wie genau mache ich es). ## Für wen Diese Anleitung ist für einen **OpenClaw-Agenten** geschrieben, der das NotebookLM-Briefing-System (Presets `nb1` und `nb2`) eigenständig bedienen soll. Kein Vorwissen nötig — alles Schritt für Schritt. ## 1. Was ist das System? Ein lokaler `notebooklm` CLI-Wrapper (v0.3.4) steuert Google NotebookLM über Browser-Cookies. Der Agent: 1. Nimmt eine Quelle entgegen (YouTube-URL, PDF-Datei, X-Post, beliebige URL) 2. Erstellt ein NotebookLM-Notebook 3. Fügt die Quelle hinzu 4. Generiert ein deutsches Audio-Briefing + eine Infografik 5. Rendert beides zu einem MP4-Video 6. Sendet das fertige Briefing als Telegram-Nachricht **Zwei Presets:** | Preset | Verhalten | |---|---| | `nb1` | 1 Nachricht: MP4-Video (Infografik + Audio) + Text mit Links | | `nb2` | 2 Nachrichten: zuerst Kurz-Audio (nur Ton), dann MP4-Video + Text | --- ## 2. Voraussetzungen ### 2.1 CLI ```bash which notebooklm # muss vorhanden sein notebooklm --version # 0.3.4 ``` ### 2.2 ffmpeg ```bash which ffmpeg # für MP4-Rendering ``` ### 2.3 yt-dlp ```bash which yt-dlp # für YouTube-Metadaten (Titel, Dauer) ``` ### 2.4 NotebookLM-Konto Ein Google-Konto muss eingerichtet und via `notebooklm login` authentifiziert sein. Der Profil-Pfad wird per Umgebungsvariable `NOTEBOOKLM_HOME` gesetzt. **Auth-Check (vor JEDER Operation):** ```bash NOTEBOOKLM_HOME= notebooklm auth check --test --json ``` Erwartete Antwort: `"status": "ok"` mit `"token_fetch": true`. **Wenn Auth fehlschlägt:** Nicht selbst reparieren. Melden: „NotebookLM Auth fehlgeschlagen. Bitte führe aus: `NOTEBOOKLM_HOME= notebooklm login --storage /storage_state.json`" --- ## 3. Der nb1-Workflow (Schritt für Schritt) ### Schritt 1: Quelle identifizieren Der User schickt eine URL/Datei + `nb1`. Beispiele: ``` https://www.youtube.com/watch?v=XXXXX nb1 /pfad/zu/datei.pdf nb1 https://x.com/user/status/123 nb1 ``` **YouTube:** Mit `yt-dlp --print title --print duration ` Titel und Dauer holen (fürs spätere Posting). ### Schritt 2: Auth prüfen ```bash NOTEBOOKLM_HOME= notebooklm auth check --test --json ``` ### Schritt 3: Notebook erstellen ```bash NOTEBOOKLM_HOME= notebooklm create "Aussagekräftiger Titel" --json ``` → Merke die `notebook.id` aus der JSON-Antwort. **Titel-Format:** `Quelle/Thema — Kernaussage (Jahr)`, z.B. `DEBRIEFED ep. 94: Mario Woods — Nuclear Missile Facility Encounter 1977` ### Schritt 4: Quelle hinzufügen ```bash NOTEBOOKLM_HOME= notebooklm source add "" -n NOTEBOOK_ID --json ``` Bei lokalen Dateien: ```bash NOTEBOOKLM_HOME= notebooklm source add "/absoluter/pfad/datei.pdf" -n NOTEBOOK_ID --json ``` → Merke die `source.id`. ### Schritt 5: Auf Source-Verarbeitung warten ```bash NOTEBOOKLM_HOME= notebooklm source wait SOURCE_ID -n NOTEBOOK_ID --timeout 300 --json ``` Warten bis `"status": "ready"`. Timeout: 300 Sekunden. ### Schritt 6: Audio + Infografik parallel generieren **Audio:** ``` NOTEBOOKLM_HOME= notebooklm generate audio "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 glaubwuerfig 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." -n NOTEBOOK_ID --json ``` **Infografik:** ``` NOTEBOOKLM_HOME= notebooklm generate infographic "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." -n NOTEBOOK_ID --json ``` → Merke beide `task_id`s. ### Schritt 7: Auf Fertigstellung warten ```bash NOTEBOOKLM_HOME= notebooklm artifact wait AUDIO_TASK_ID -n NOTEBOOK_ID --timeout 900 --json NOTEBOOKLM_HOME= notebooklm artifact wait INFOGRAPHIC_TASK_ID -n NOTEBOOK_ID --timeout 900 --json ``` Beide parallel starten (als separate Shell-Prozesse). Timeout: 900 Sekunden pro Artifact. **Wichtig:** `artifact wait` kann sehr lange blockieren (10+ Min. für Audio). Nicht die Geduld verlieren. Regelmäßig mit `artifact list` prüfen, ob der Status auf `completed` oder `pending` gewechselt ist. ### Schritt 8: Artifacts herunterladen ```bash mkdir -p / NOTEBOOKLM_HOME= notebooklm download audio \ //audio.mp3 \ -n NOTEBOOK_ID -a AUDIO_ARTIFACT_ID NOTEBOOKLM_HOME= notebooklm download infographic \ //infographic.png \ -n NOTEBOOK_ID -a INFOGRAPHIC_ARTIFACT_ID ``` ### Schritt 9: Notebook öffentlich teilen ```bash NOTEBOOKLM_HOME= notebooklm share public --enable -n NOTEBOOK_ID --json ``` → Merke die `share_url`. ### Schritt 10: MP4 rendern ```bash 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 ``` ### Schritt 11: Audio-Dauer ermitteln ```bash ffprobe -v error -show_entries format=duration -of default=noprint_wrappers=1:nokey=1 \ //audio.mp3 ``` → In Minuten:Sekunden umrechnen (z.B. 1475s = 24:35). ### Schritt 12: Telegram-Briefing senden **Eine Nachricht** mit `message`-Tool, die ALLES enthält: ``` action: send target: message: media: //briefing.mp4 ``` **Niemals** Text und Media getrennt senden. **Niemals** das Posting fragmentieren. --- ## 4. Der nb2-Workflow Identisch mit nb1, aber mit **zusätzlichem Kurz-Audio** vor dem Haupt-Briefing. ### Zusätzliche Schritte: **Schritt 6b: Kurz-Audio generieren (VOR dem Standard-Audio)** ```bash NOTEBOOKLM_HOME= notebooklm generate audio "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." -n NOTEBOOK_ID --json ``` **Schritt 8b: Kurz-Audio herunterladen** ```bash NOTEBOOKLM_HOME= notebooklm download audio \ //audio-short.mp3 \ -n NOTEBOOK_ID -a SHORT_AUDIO_ARTIFACT_ID ``` **Schritt 12b: Sendereihenfolge** 1. **Zuerst** Kurz-Audio als standalone Audio-Nachricht: ``` 🎧 Kurz-Zusammenfassung: (, deutsch) ``` Media: `audio-short.mp3` (nur Audio, kein Video!) 2. **Danach** das normale nb1-Video-Briefing (identisch zu nb1 Schritt 12). --- ## 5. Telegram Caption Contract (PFLICHT) Jede nb1/nb2-Nachricht MUSS diesem Format folgen: ```text 🔴 ▶️ Audio-Briefing: , deutsch 🖼️ Infografik: im Video sichtbar integriert 📓 Notebook: [Briefings öffnen]() 📺 Originalquelle: []() () Warum es zählt: ``` **Regeln:** - Keine privaten Namen im sichtbaren Text - Keine Tool-Logs, keine Debug-Infos - YouTube-Links: Original-URL, nicht gekürzt - Sprachhinweis: `(eng.)`, `(de.)`, `(fr.)` etc. - Mehrere Quellen: je eine `📺 Originalquelle:`-Zeile - Telegram-Dokumente (PDFs): als separate Datei mitschicken, nicht als internen t.me-Link --- ## 6. Häufige Fehler (DON'T) | ❌ 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 | | Audio-Download als `.mp3` obwohl M4A | `file` Befehl prüfen, Format egal | | 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 | --- ## 7. Output-Verzeichnis-Struktur ``` /output/ ├── nb1/ │ ├── / │ │ ├── audio.mp3 │ │ ├── infographic.png │ │ └── briefing.mp4 ├── nb2/ │ ├── / │ │ ├── audio-short.mp3 │ │ ├── audio.mp3 │ │ ├── infographic.png │ │ └── briefing.mp4 ``` --- ## 8. Kommando-Referenz (Kurzfassung) ```bash # Auth NOTEBOOKLM_HOME= notebooklm auth check --test --json # Notebook NOTEBOOKLM_HOME= notebooklm create "Titel" --json NOTEBOOKLM_HOME= notebooklm list --json # Source NOTEBOOKLM_HOME= notebooklm source add "" -n ID --json NOTEBOOKLM_HOME= notebooklm source wait SRC_ID -n ID --timeout 300 --json # Generate NOTEBOOKLM_HOME= notebooklm generate audio "prompt" -n ID --json NOTEBOOKLM_HOME= notebooklm generate infographic "prompt" -n ID --json # Wait NOTEBOOKLM_HOME= notebooklm artifact wait ART_ID -n ID --timeout 900 --json NOTEBOOKLM_HOME= notebooklm artifact list -n ID --json # Download NOTEBOOKLM_HOME= notebooklm download audio ./out.mp3 -n ID -a ART_ID NOTEBOOKLM_HOME= notebooklm download infographic ./out.png -n ID -a ART_ID # Share NOTEBOOKLM_HOME= 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. Erkennung: Wann nb1, wann nb2? Der User triggert durch Schlüsselwörter: - `nb1`, `+nb1` → Preset nb1 - `nb2`, `+nb2` → Preset nb2 Die Quelle steht immer VOR dem Schlüsselwort: ``` https://youtube.com/watch?v=XXX nb1 /pfad/datei.pdf nb2 ``` Wenn nur eine Quelle ohne `nb1`/`nb2` geschickt wird → nachfragen welches Preset.