notebooklm

# NotebookLM CLI

## Commands
```bash
notebooklm list                                    # List all notebooks + IDs
notebooklm create "Name"                           # Create notebook → returns ID
notebooklm source add "<url_or_file>" -n <ID>      # Add URL/PDF/YouTube to notebook
notebooklm source add "<url>" -n <ID> --wait       # Add + wait for processing
notebooklm source list -n <ID>                     # List sources in notebook
notebooklm ask "Question" -n <ID>                  # Query AI against sources
```

## Rules
1. **No playlists.** Extract individual YouTube URLs and add one by one.
2. **Max 50 sources** per notebook.
3. **Use `--wait`** when adding sources in scripts to ensure processing completes.
4. **Auth Recovery:** If `notebooklm` fails with "Authentication expired", you MUST ask the user for explicit permission before recovering. Propose running `python {WORKSPACE_DIR}/skills/notebooklm-bypass/scripts/auto_playwright.py`. If and only if they approve, run the script. This script steals fresh cookies and automatically injects them into your Windows Environment Variables. Once complete, retry your command.

# OpenClaw NotebookLM Stealth Auth Skill

This is a custom drop-in skill for the [OpenClaw Framework](https://github.com/openclaw/openclaw) that permanently solves the "Authentication expired" login loop encountered when using the NotebookLM CLI.

## Background: The Multi-Day Auth Loop Nightmare
For days, OpenClaw users have faced a critical bug: Google frequently rotates session cookies for security. When these cookies expire, the `notebooklm` CLI tool crashes with an `Authentication expired` error. 

Normally, this breaks headless AI agents completely. The agent fails its task, drops what it's doing, and the human user is forced to intervene, open their terminal, manually run `notebooklm login`, wait for the browser, and press Enter. If you tried to bypass it using the `NOTEBOOKLM_AUTH_JSON` environment variable, the Playwright CLI tool would often drop the cookies due to a `SameSite: Lax` cross-origin security bug.

This skill fixes all of that by **giving your OpenClaw agent the ability to self-heal its own authentication.**

---

## Features
- **One-Click Consent Recovery**: When OpenClaw gets an auth error, it asks your permission before running the included script to fetch fresh cookies, ensuring no silent credential harvesting occurs.
- **Native Playwright Integration**: The script opens a visible browser window for 5 seconds to naturally bypass Google's "unsecure browser" bot detection.
- **Windows Auto-Injection**: Automatically injects the refreshed cookies natively into the `NOTEBOOKLM_AUTH_JSON` persistent environment variable, bypassing the Playwright cross-origin security drop bug.

---

## The A-Z Setup Guide


### Step 2: The One-Time Interactive Login
You must establish a persistent Chrome profile that is logged into your Google Account.
1. Open your terminal and run:
   ```bash
   notebooklm login
   ```
2. A browser window will open. Log into your Google account.
3. Once you see the NotebookLM dashboard, go back to y...