# Send Linux Desktop Control to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "linux-desktop",
    "name": "Linux Desktop Control",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/ouyangAbel/linux-desktop",
    "canonicalUrl": "https://clawhub.ai/ouyangAbel/linux-desktop",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/linux-desktop",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=linux-desktop",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/linux-desktop.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "linux-desktop",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T00:39:44.497Z",
      "expiresAt": "2026-05-12T00:39:44.497Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=linux-desktop",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=linux-desktop",
        "contentDisposition": "attachment; filename=\"linux-desktop-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "linux-desktop"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/linux-desktop"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/linux-desktop",
    "downloadUrl": "https://openagent3.xyz/downloads/linux-desktop",
    "agentUrl": "https://openagent3.xyz/skills/linux-desktop/agent",
    "manifestUrl": "https://openagent3.xyz/skills/linux-desktop/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/linux-desktop/agent.md"
  }
}
```
## Documentation

### Linux Desktop Control

Automate and control your Linux desktop using command-line tools. Capture screenshots, control mouse/keyboard, and manage windows.

### When to Use

Take screenshots of screen or specific windows
Automate mouse movements and clicks
Simulate keyboard input
Manage and interact with windows
Build desktop automation workflows

### Prerequisites

Install required tools:

sudo apt-get install scrot xdotool xclip x11-utils x11-apps

### Take Screenshot

python3 scripts/linux-desktop.py screenshot
# Output: ~/screenshot_20240224_203901.png

### List Windows

python3 scripts/linux-desktop.py list

### Move Mouse and Click

python3 scripts/linux-desktop.py move 500 300
python3 scripts/linux-desktop.py click

### Type Text

python3 scripts/linux-desktop.py type "Hello World"

### screenshot [path]

Capture a screenshot of the entire screen.

Examples:

# Save to default location (/tmp/screenshot_YYYYMMDD_HHMMSS.png)
python3 scripts/linux-desktop.py screenshot

# Save to custom path
python3 scripts/linux-desktop.py screenshot ~/desktop.png

### window [window_id] [path]

Capture a screenshot of a specific window.

Examples:

# Screenshot active window
python3 scripts/linux-desktop.py window

# Screenshot specific window
python3 scripts/linux-desktop.py window 0x12345678 ~/window.png

### active

Get information about the currently active window.

python3 scripts/linux-desktop.py active
# Output: 🖥️ Active Window
#         ID: 0x12345678
#         Title: Terminal

### list

List all visible windows.

python3 scripts/linux-desktop.py list
# Output: 🪟 Found 5 windows:
#         1. 0x12345678 - Terminal
#         2. 0x87654321 - Chrome

### move <x> <y>

Move mouse cursor to specified coordinates.

Examples:

python3 scripts/linux-desktop.py move 100 200
# Moves mouse to (100, 200)

python3 scripts/linux-desktop.py move 500 300
# Moves mouse to center of 1000x600 area

### click [button]

Click mouse button at current cursor position.

Button values:

1 - Left button (default)
2 - Middle button
3 - Right button

Examples:

python3 scripts/linux-desktop.py click
# Left click

python3 scripts/linux-desktop.py click 3
# Right click

### type <text>

Type text at current cursor position (must be in focused window).

Examples:

python3 scripts/linux-desktop.py type "Hello World"

python3 scripts/linux-desktop.py type "ls -la"

python3 scripts/linux-desktop.py type "sudo apt update"

### key <keyspec>

Press keyboard keys.

Common keys:

Return - Enter key
Escape - Escape key
Tab - Tab key
BackSpace - Backspace
Delete - Delete
Up, Down, Left, Right - Arrow keys
Home, End, Page_Up, Page_Down
F1 through F12
Ctrl+c, Ctrl+v, Ctrl+a, Ctrl+z - Key combinations

Examples:

python3 scripts/linux-desktop.py key Return

python3 scripts/linux-desktop.py key Escape

python3 scripts/linux-desktop.py key Ctrl+a

python3 scripts/linux-desktop.py key F5

### screen

Get screen information.

python3 scripts/linux-desktop.py screen
# Output: 🖥️ Screen Info
#         Resolution: 1920x1080

### Basic Automation

# Move mouse, click, type, and press enter
python3 scripts/linux-desktop.py move 100 100
python3 scripts/linux-desktop.py click
python3 scripts/linux-desktop.py type "ls -la"
python3 scripts/linux-desktop.py key Return

### Web Search Automation

# Open browser, navigate to Google, search
python3 scripts/linux-desktop.py move 100 50
python3 scripts/linux-desktop.py click
python3 scripts/linux-desktop.py type "https://www.google.com"
python3 scripts/linux-desktop.py key Return
sleep 2
python3 scripts/linux-desktop.py type "how to make money online"
python3 scripts/linux-desktop.py key Return

### Screenshot Workflow

# Take screenshot before and after action
python3 scripts/linux-desktop.py screenshot /tmp/before.png
python3 scripts/linux-desktop.py key F5  # Refresh
sleep 1
python3 scripts/linux-desktop.py screenshot /tmp/after.png

### Tips

Always check the active window before typing
Use sleep commands between actions for reliability
Take screenshots to verify state changes
Test commands one by one before building complex workflows
Use window list to find specific window IDs for targeting

### Troubleshooting

"Command not found" errors:

sudo apt-get install scrot xdotool xclip x11-utils x11-apps

Permission denied:

Ensure you're running in a graphical session (X11 or Wayland)
Some actions require focus on the target window

Mouse doesn't move:

Check if another application is grabbing the mouse
Try moving the mouse manually to see if it's responsive

### Security Notes

This skill can control your desktop - use with caution
Don't automate sensitive actions without verification
Always review automation scripts before running
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: ouyangAbel
- Version: 1.0.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T00:39:44.497Z
- Expires at: 2026-05-12T00:39:44.497Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/linux-desktop)
- [Send to Agent page](https://openagent3.xyz/skills/linux-desktop/agent)
- [JSON manifest](https://openagent3.xyz/skills/linux-desktop/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/linux-desktop/agent.md)
- [Download page](https://openagent3.xyz/downloads/linux-desktop)