WSL Screenshot for Openclaw

A specialized bridge that allows WSL2 users to capture Windows desktop screenshots directly from the Linux terminal via PowerShell invocation.

wxuanyuan
v0.0.1
Mar 30, 2026
0
711
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install wsl-screenshot

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install wsl-screenshot using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is WSL Screenshot?

The WSL Screenshot skill is a powerful utility designed for developers and power users operating within the Windows Subsystem for Linux (WSL2). It solves the common friction point of cross-environment screen capture by providing a direct bridge to Windows PowerShell, enabling seamless desktop imaging without leaving the CLI. This utility is a perfect example of the flexibility found in Openclaw Skills, allowing agents to interact with the host OS environment efficiently.

By leveraging the native Windows capture capabilities, it ensures high-quality output while maintaining the scriptable nature of the Linux environment. This makes it an essential tool for documentation, bug reporting, and visual verification tasks within automated workflows.

WSL Screenshot Use Cases

  • Automating visual bug reports while developing in a WSL2 environment.
  • Incorporating desktop screenshots into Linux-based CI/CD or testing pipelines.
  • Seamlessly sharing Windows desktop views during remote collaboration sessions initiated from WSL.
  • Creating visual logs of UI states during the execution of cross-platform scripts.

How WSL Screenshot Works

  1. The skill triggers a shell script located within the local repository.
  2. The script invokes the Windows PowerShell executable located on the host filesystem via the /mnt/c/ mount point.
  3. PowerShell executes a .NET-based capture command to grab the primary screen buffer.
  4. The resulting image is saved directly to the Windows User Pictures directory.
  5. The path is returned to WSL, allowing Openclaw Skills to process or send the file via message tools.

WSL Screenshot Setup

Ensure you are running WSL2 on Windows 10 or 11. No complex installation is required as long as Openclaw Skills can access the script path.

# Verify PowerShell access
ls /mnt/c/Windows/System32/WindowsPowerShell/v1.0/powershell.exe

# Make the script executable
chmod +x ~/.openclaw/workspace/skills/wsl-screenshot/scripts/screenshot.sh

WSL Screenshot Data Schema & Taxonomy

The skill follows a predictable naming convention and storage structure to ensure easy retrieval by AI agents:

Attribute Description
Storage Path C:\Users\[User]\Pictures\
Mount Path /mnt/c/Users/[User]/Pictures/
File Format Portable Network Graphics (.png)
Naming Pattern wsl_screenshot_YYYYMMDD_HHMMSS.png
Metadata Timestamp-based versioning for sequential captures

WSL Screenshot Advanced Features

  • Direct integration with the Openclaw Skills message tool for instant media sharing.
  • Automatic timestamping to prevent file name collisions during rapid-fire captures.
  • Support for shell piping, allowing users to find the latest screenshot using ls -t and immediately process it.
  • Lightweight footprint utilizing native Windows binaries rather than heavy third-party dependencies.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*