← Back to Skills Marketplace
Capture Windows Screen
by
Hansheng-Li
· GitHub ↗
· v0.1.0
· MIT-0
117
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install capture-windows-screen
Description
Capture the current Windows desktop from this WSL/OpenClaw environment and return the PNG path for inspection or delivery. Use when the user asks to screensh...
README (SKILL.md)
Capture Windows Screen
Use the bundled script for screenshot requests in this environment. It calls the Windows PowerShell helper, copies the PNG into a chosen staging folder, and prints the staged path.
Use two staging modes:
- Analysis / inspection: keep the default workspace
tmp-media/staging. - Messaging-surface delivery: prefer
~/.openclaw/media/outbound/so the file is already in OpenClaw's managed outbound media store.
Quick workflow
- For analysis or inspection, run
bash scripts/capture-windows-screen.shfrom this skill directory. - For delivery back to a chat app, run
STAGE_DIR=/home/lhs/.openclaw/media/outbound bash scripts/capture-windows-screen.sh. - Treat the printed path as the staged screenshot to use next.
- If the user wants the image in chat, prefer the managed outbound path from step 2 and send it with a bare
MEDIA:line when possible. - If the user wants analysis, inspect the staged image after capture.
Commands
Analysis / inspection path:
bash scripts/capture-windows-screen.sh
Delivery-safe path for chat apps:
STAGE_DIR=/home/lhs/.openclaw/media/outbound bash scripts/capture-windows-screen.sh
Expected output:
/home/lhs/.openclaw/workspace/tmp-media/latest-screen-YYYYMMDD-HHMMSS.png
or, for delivery-safe staging:
/home/lhs/.openclaw/media/outbound/latest-screen-YYYYMMDD-HHMMSS.png
Environment assumptions
This skill assumes these host-side paths exist:
- PowerShell:
/mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe - Capture helper:
C:\OpenClaw\capture-screen.ps1 - Screenshot output:
C:\OpenClaw\latest-screen.png - WSL mirror path:
/mnt/c/OpenClaw/latest-screen.png - Workspace staging directory for inspection copies:
/home/lhs/.openclaw/workspace/tmp-media - Managed outbound media store for delivery retries / chat attachments:
/home/lhs/.openclaw/media/outbound
Failure handling
- If PowerShell or the helper script is missing, check local machine-specific notes before changing paths.
- If the command succeeds but the PNG is missing, rerun once, then verify the helper still writes to
C:\OpenClaw\latest-screen.png. - If the browser shows the image but Telegram or another chat app does not receive it, assume the file stayed at local-preview level. Restage it into
/home/lhs/.openclaw/media/outboundand retry using only the managed outbound path. - Do not assume a workspace
tmp-media/path is delivery-safe just because the web UI can preview it. - Do not invent alternate screenshot commands unless the configured path is clearly broken.
Usage Guidance
This skill appears to do what it says: call a Windows PowerShell helper to create a PNG and copy it into a staging folder. Before installing/using it, verify that C:\OpenClaw\capture-screen.ps1 exists and is trusted (it will be run under PowerShell with -ExecutionPolicy Bypass and could execute any PowerShell commands). Also confirm the hard-coded paths (/home/lhs/.openclaw/... and /mnt/c/OpenClaw/...) match your environment or override them by setting WIN_PS, OUT_WSL, or STAGE_DIR. If you cannot inspect the Windows helper or do not trust the machine environment, do not run the skill.
Capability Analysis
Type: OpenClaw Skill
Name: capture-windows-screen
Version: 0.1.0
The skill facilitates host-side screen capture by executing a PowerShell script on the Windows host from WSL using '-ExecutionPolicy Bypass'. It relies on an external, unverified dependency (C:\OpenClaw\capture-screen.ps1) and contains hardcoded absolute paths for a specific user (/home/lhs/) in both SKILL.md and scripts/capture-windows-screen.sh. While the behavior aligns with the stated purpose, the reliance on pre-placed host-side artifacts and the high-privilege nature of crossing the WSL-to-Host boundary make it a security risk.
Capability Assessment
Purpose & Capability
The skill's name/description match what it does: the included shell script invokes PowerShell to run a Windows-side helper and copies the produced PNG into a staging directory. The Windows helper path (C:\OpenClaw\capture-screen.ps1), the mirrored path (/mnt/c/OpenClaw/latest-screen.png), and a user-specific workspace (/home/lhs/...) are assumed rather than declared; this is coherent for the stated task but brittle and user-specific.
Instruction Scope
SKILL.md and the script stay within screenshot capture and staging. The script runs PowerShell with -ExecutionPolicy Bypass to execute the external helper script — expected for invoking a Windows helper but means the Windows-side script can run arbitrary PowerShell. The instructions do not read unrelated environment variables or exfiltrate data to external endpoints.
Install Mechanism
No install step or external downloads. This is an instruction-only skill with a small packaged shell script — low install risk.
Credentials
The skill requests no credentials or env vars by metadata, and the script lets users override WIN_PS, OUT_WSL, and STAGE_DIR. However it assumes access to the Windows filesystem via /mnt/c and uses hard-coded paths (C:\OpenClaw, /home/lhs). These are reasonable for capturing a desktop image but require that the helper script and those paths exist and are trusted.
Persistence & Privilege
always is false and the skill is user-invocable. It does not modify other skills or system-wide settings and does not request permanent presence or elevated platform privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install capture-windows-screen - After installation, invoke the skill by name or use
/capture-windows-screen - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
First public release of the Capture Windows Screen skill.
Designed for OpenClaw running inside WSL2 on Windows. This skill captures the Windows host desktop through a PowerShell helper, stages the image for analysis or delivery, and avoids common path-related media delivery issues.
Metadata
Frequently Asked Questions
What is Capture Windows Screen?
Capture the current Windows desktop from this WSL/OpenClaw environment and return the PNG path for inspection or delivery. Use when the user asks to screensh... It is an AI Agent Skill for Claude Code / OpenClaw, with 117 downloads so far.
How do I install Capture Windows Screen?
Run "/install capture-windows-screen" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Capture Windows Screen free?
Yes, Capture Windows Screen is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Capture Windows Screen support?
Capture Windows Screen is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Capture Windows Screen?
It is built and maintained by Hansheng-Li (@hansheng-li); the current version is v0.1.0.
More Skills