← Back to Skills Marketplace
Claw Mouse
by
Rylen Anil
· GitHub ↗
· v0.1.0
735
Downloads
2
Stars
3
Active Installs
1
Versions
Install in OpenClaw
/install claw-mouse
Description
Control a Linux X11 desktop by taking screenshots and moving/clicking/typing via xdotool + scrot.
README (SKILL.md)
claw-mouse
This skill provides a small, scriptable desktop GUI control helper for Linux X11.
It’s intended for “vision loop” automation:
- take a screenshot
- decide where to click
- move/click/type
- repeat
Under the hood it wraps:
scrotfor screenshotsxdotoolfor mouse/keyboard/window control
Files
desktopctl.py— the CLI script
Requirements
- Linux running X11 (not Wayland-only)
python3xdotoolscrot
Ubuntu/Debian:
sudo apt-get update
sudo apt-get install -y xdotool scrot
Usage
From this skill directory:
python3 desktopctl.py screenshot
python3 desktopctl.py click 500 300
python3 desktopctl.py type "hello"
python3 desktopctl.py key ctrl+l
python3 desktopctl.py windows
python3 desktopctl.py activate "Chromium"
DISPLAY / XAUTHORITY
If you’re running from a daemon/headless shell where DISPLAY isn’t set:
DISPLAY=:0 XAUTHORITY=$HOME/.Xauthority python3 desktopctl.py screenshot
Or use flags:
python3 desktopctl.py --display :0 --xauthority $HOME/.Xauthority screenshot
Safety notes
This can click/type into your real desktop session. Use carefully.
Changelog
- 0.1.0: Initial published skill.
Usage Guidance
This skill appears to do what it claims: control an X11 desktop via scrot/xdotool. However, running it (or granting an agent access to it) allows automated mouse movement, clicks, typing, window activation, and opening URLs in your real desktop session. Before installing/using: (1) review the desktopctl.py source (it's short and readable); (2) do not supply your main session's XAUTHORITY cookie to untrusted agents — prefer running in a disposable X session or VM; (3) avoid running as root or exposing sensitive windows while testing; (4) ensure xdotool/scrot are installed from your distro package repository; and (5) require explicit user confirmation for any autonomous runs that will control your real desktop.
Capability Analysis
Type: OpenClaw Skill
Name: claw-mouse
Version: 0.1.0
The 'claw-mouse' skill is classified as suspicious due to its inherent high-risk capabilities, even though they align with its stated purpose of desktop GUI control. The `desktopctl.py` script grants full control over the X11 desktop (mouse, keyboard, screenshots, window management) via `xdotool` and `scrot`. Specifically, the `cmd_open` function allows opening arbitrary URLs via `xdg-open`, `gio`, or `chromium-browser`, which could be abused to navigate to malicious websites or trigger client-side vulnerabilities. Additionally, the `cmd_activate` function passes user-controlled regex to `xdotool search --name`, posing a potential denial-of-service vulnerability against the `xdotool` process. While the `SKILL.md` is transparent about the skill's functionality and includes safety notes, the presence of these powerful and potentially abusable capabilities, without clear constraints, warrants a 'suspicious' classification based on the provided guidelines.
Capability Assessment
Purpose & Capability
Name/description match the implementation: the CLI wraps scrot for screenshots, xdotool for mouse/keyboard/window control, and xdg-open/gio as a URL opener. Required binaries (python3, xdotool, scrot) are exactly what the skill needs.
Instruction Scope
SKILL.md instructs use of DISPLAY and XAUTHORITY (and shows flag/ENV usage) which is necessary to access an X11 session. The instructions explicitly warn that the skill can click/type into a real desktop. There are no steps that read or transmit unrelated files or network endpoints beyond opening URLs via a local opener.
Install Mechanism
No install spec; instruction-only skill with one included Python script. Nothing is downloaded from external URLs or written to unexpected system locations.
Credentials
No credentials are declared or required. The tool uses DISPLAY and an XAUTHORITY cookie path (defaults to $HOME/.Xauthority) to interact with X11 — this is appropriate for desktop control but the XAUTHORITY cookie is sensitive because possession grants session access. The skill does not exfiltrate that file, but it does rely on it to operate.
Persistence & Privilege
always is false and there is no installation that modifies other skills or system-wide settings. The skill can be invoked autonomously by the agent (platform default); combined with desktop-control capability this increases risk in practice but is expected for such skills.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install claw-mouse - After installation, invoke the skill by name or use
/claw-mouse - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.0
Initial published skill
Metadata
Frequently Asked Questions
What is Claw Mouse?
Control a Linux X11 desktop by taking screenshots and moving/clicking/typing via xdotool + scrot. It is an AI Agent Skill for Claude Code / OpenClaw, with 735 downloads so far.
How do I install Claw Mouse?
Run "/install claw-mouse" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Claw Mouse free?
Yes, Claw Mouse is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Claw Mouse support?
Claw Mouse is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Claw Mouse?
It is built and maintained by Rylen Anil (@rylena); the current version is v0.1.0.
More Skills