videodb-monitoring-skill
starsforks
How to install videodb-monitoring-skill?
video-db/openclaw-monitoring/videodb-monitoring-skill
$npx -y skills add video-db/openclaw-monitoring --skill videodb-monitoring-skillScreen recording capabilities. Generate stream URLs, search recordings, get transcripts.
SKILL.md
| 1 | # VideoDB Screen Recording Skill |
| 2 | |
| 3 | Screen recording capabilities powered by VideoDB. Use this when the user asks for screen recordings, wants to search past activity, or needs transcripts. |
| 4 | |
| 5 | Run commands from `{baseDir}` using `npx tsx videodb.ts`. |
| 6 | |
| 7 | ## Prerequisites |
| 8 | |
| 9 | ### 1. Check API Key |
| 10 | |
| 11 | Before using any commands, verify the API key is configured: |
| 12 | |
| 13 | ```bash |
| 14 | openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_API_KEY |
| 15 | ``` |
| 16 | |
| 17 | If **not set** or empty: |
| 18 | - Ask the user for their VideoDB API key |
| 19 | - If they provide it, set it for them: |
| 20 | ```bash |
| 21 | openclaw config set skills.entries.videodb-monitoring.env.VIDEODB_API_KEY 'sk-xxx' |
| 22 | ``` |
| 23 | - If they don't have one, direct them to: https://console.videodb.io |
| 24 | |
| 25 | ### 2. Check Monitor is Running |
| 26 | |
| 27 | ```bash |
| 28 | openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_IS_RUNNING |
| 29 | ``` |
| 30 | |
| 31 | If **not `true`**, start the monitor: |
| 32 | |
| 33 | ```bash |
| 34 | cd {baseDir} && nohup npx tsx monitor.ts > ~/.videodb/logs/monitor.log 2>&1 & disown && sleep 3 |
| 35 | ``` |
| 36 | |
| 37 | Verify it started: |
| 38 | ```bash |
| 39 | openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_CAPTURE_SESSION_ID |
| 40 | ``` |
| 41 | |
| 42 | If you get a session ID (e.g., `cap-xxxxxxxx-...`), the monitor is ready. |
| 43 | |
| 44 | ## Commands |
| 45 | |
| 46 | ### Get Current Timestamp |
| 47 | |
| 48 | ```bash |
| 49 | cd {baseDir} && npx tsx videodb.ts now |
| 50 | ``` |
| 51 | |
| 52 | Returns current Unix timestamp (seconds since epoch). |
| 53 | |
| 54 | ### Generate Stream URL |
| 55 | |
| 56 | ```bash |
| 57 | cd {baseDir} && npx tsx videodb.ts stream <start_timestamp> <end_timestamp> |
| 58 | cd {baseDir} && npx tsx videodb.ts stream <start_timestamp> <end_timestamp> --title "Checkout flow" --description "OpenClaw browser run" |
| 59 | ``` |
| 60 | |
| 61 | Creates a playable recording URL for the time range. |
| 62 | If `--title` or `--description` is provided, the generated player share page uses that metadata. |
| 63 | |
| 64 | ### Start Indexing |
| 65 | |
| 66 | Start indexing only when the user asks for search, summaries, or transcripts: |
| 67 | |
| 68 | ```bash |
| 69 | cd {baseDir} && npx tsx videodb.ts start-indexing |
| 70 | ``` |
| 71 | |
| 72 | This starts: |
| 73 | - transcript capture for system audio |
| 74 | - audio indexing |
| 75 | - visual indexing |
| 76 | |
| 77 | You can also control them individually: |
| 78 | |
| 79 | ```bash |
| 80 | cd {baseDir} && npx tsx videodb.ts start-visual-index |
| 81 | cd {baseDir} && npx tsx videodb.ts start-transcript |
| 82 | cd {baseDir} && npx tsx videodb.ts start-audio-index |
| 83 | ``` |
| 84 | |
| 85 | ### Stop Indexing |
| 86 | |
| 87 | Stop indexing as soon as it is no longer needed to save cost: |
| 88 | |
| 89 | ```bash |
| 90 | cd {baseDir} && npx tsx videodb.ts stop-indexing |
| 91 | ``` |
| 92 | |
| 93 | Individual stop commands: |
| 94 | |
| 95 | ```bash |
| 96 | cd {baseDir} && npx tsx videodb.ts stop-visual-index |
| 97 | cd {baseDir} && npx tsx videodb.ts stop-transcript |
| 98 | cd {baseDir} && npx tsx videodb.ts stop-audio-index |
| 99 | ``` |
| 100 | |
| 101 | ### Search Recordings |
| 102 | |
| 103 | ```bash |
| 104 | cd {baseDir} && npx tsx videodb.ts search "user opened Amazon" |
| 105 | ``` |
| 106 | |
| 107 | Searches indexed screen activity for matching events. If no visual index exists yet, start indexing first. |
| 108 | |
| 109 | ### Activity Summary |
| 110 | |
| 111 | ```bash |
| 112 | cd {baseDir} && npx tsx videodb.ts summary # last 30 minutes |
| 113 | cd {baseDir} && npx tsx videodb.ts summary --hours 2 # last 2 hours |
| 114 | ``` |
| 115 | |
| 116 | ### Audio Transcripts |
| 117 | |
| 118 | ```bash |
| 119 | cd {baseDir} && npx tsx videodb.ts transcript # last 30 minutes |
| 120 | cd {baseDir} && npx tsx videodb.ts transcript --hours 1 # last hour |
| 121 | ``` |
| 122 | |
| 123 | ## Recording Workflow |
| 124 | |
| 125 | When user requests screen recording of a task: |
| 126 | |
| 127 | 1. **Capture start time**: |
| 128 | ```bash |
| 129 | cd {baseDir} && npx tsx videodb.ts now |
| 130 | ``` |
| 131 | Store this as `start_time`. |
| 132 | |
| 133 | 2. **Do the work** (browser actions, file editing, etc.) |
| 134 | |
| 135 | 3. **Capture end time**: |
| 136 | ```bash |
| 137 | cd {baseDir} && npx tsx videodb.ts now |
| 138 | ``` |
| 139 | |
| 140 | 4. **Generate stream URL**: |
| 141 | ```bash |
| 142 | cd {baseDir} && npx tsx videodb.ts stream <start_time> <end_time> |
| 143 | ``` |
| 144 | |
| 145 | Optional player metadata: |
| 146 | ```bash |
| 147 | cd {baseDir} && npx tsx videodb.ts stream <start_time> <end_time> --title "Task recording" --description "Captured during OpenClaw task execution" |
| 148 | ``` |
| 149 | |
| 150 | 5. **Include URL in response**: |
| 151 | ``` |
| 152 | Screen recording: https://rt.stream.videodb.io/... |
| 153 | ``` |
| 154 | |
| 155 | If the command prints a player page URL, prefer sharing that URL with the user. |
| 156 | |
| 157 | Indexing is not started automatically by the monitor. If the user also wants search, summaries, or transcripts, start indexing explicitly before those commands and stop it afterwards. |
| 158 | |
| 159 | ## Example |
| 160 | |
| 161 | User: "Open example.com and send me the recording" |
| 162 | |
| 163 | ```bash |
| 164 | # Check prerequisites |
| 165 | openclaw config get skills.entries.videodb-monitoring.env.VIDEODB_IS_RUNNING |
| 166 | # true |
| 167 | |
| 168 | # Start time |
| 169 | cd {baseDir} && npx tsx videodb.ts now |
| 170 | # 1709740800 |
| 171 | |
| 172 | # Do the work (open browser, navigate) |
| 173 | # ... |
| 174 | |
| 175 | # End time |
| 176 | cd {baseDir} && npx tsx videodb.ts now |
| 177 | # 1709740830 |
| 178 | |
| 179 | # Generate URL |
| 180 | cd {baseDir} && npx tsx videodb.ts stream 1709740800 1709740830 --title "example.com walkthrough" --description "OpenClaw browser automation" |
| 181 | # 📹 Screen recording (30s): https://rt.stream.videodb.io/abc123 |
| 182 | # Player page: https://player.videodb.io/watch?v=example-slug |
| 183 | ``` |
People who liked this also viewed
6 picksType
- azure-diagnosticsDebug Azure production issues on Azure using AppLens, Azure Monitor, resource health, and safe triage. WHEN: debug production issues, troubleshoot app service, app service high CPU, app service deploySkillsJul 2026
- systematic-debuggingUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesSkillsJul 2026
- safe-debugRigor Debug / Rigor Audit skill for deep learning research work. Use when the user pastes a traceback, terminal error, CUDA OOM, checkpoint load failure, shape mismatch, NaN loss symptom, or training SkillsMay 2026
- explore-runRigor Improve / Rigor Explore run leaf skill for bounded exploratory evidence in deep learning research repositories. Use when the researcher explicitly authorizes exploratory runs such as small-subseSkillsMay 2026
- minimal-run-and-auditRigor Run skill for README-first deep learning repo reproduction. Use when the task is specifically to capture or normalize evidence from the selected smoke test or documented inference or evaluation SkillsMay 2026
- insforge-debugUse when diagnosing problems in an InsForge project — reactive failures (SDK error object, HTTP 4xx/5xx, gateway timeout 502/503/504, edge function failure or timeout, login/OAuth/auth errors, RLS denSkillsJul 2026
