# Send Computer Use 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": "computer-use",
    "name": "Computer Use",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/Ram-Raghav-S/computer-use",
    "canonicalUrl": "https://clawhub.ai/Ram-Raghav-S/computer-use",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/computer-use",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=computer-use",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "scripts/click.sh",
      "scripts/cursor_position.sh",
      "scripts/drag.sh",
      "scripts/hold_key.sh",
      "scripts/key.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "computer-use",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T02:21:57.129Z",
      "expiresAt": "2026-05-09T02:21:57.129Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=computer-use",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=computer-use",
        "contentDisposition": "attachment; filename=\"computer-use-1.2.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "computer-use"
      },
      "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/computer-use"
    },
    "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/computer-use",
    "downloadUrl": "https://openagent3.xyz/downloads/computer-use",
    "agentUrl": "https://openagent3.xyz/skills/computer-use/agent",
    "manifestUrl": "https://openagent3.xyz/skills/computer-use/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/computer-use/agent.md"
  }
}
```
## Documentation

### Computer Use Skill

Full desktop GUI control for headless Linux servers. Creates a virtual display (Xvfb + XFCE) so you can run and control desktop applications on VPS/cloud instances without a physical monitor.

### Environment

Display: :99
Resolution: 1024x768 (XGA, Anthropic recommended)
Desktop: XFCE4 (minimal — xfwm4 + panel only)

### Quick Setup

Run the setup script to install everything (systemd services, flicker-free VNC):

./scripts/setup-vnc.sh

This installs:

Xvfb virtual display on :99
Minimal XFCE desktop (xfwm4 + panel, no xfdesktop)
x11vnc with stability flags
noVNC for browser access

All services auto-start on boot and auto-restart on crash.

### Actions Reference

ActionScriptArgumentsDescriptionscreenshotscreenshot.sh—Capture screen → base64 PNGcursor_positioncursor_position.sh—Get current mouse X,Ymouse_movemouse_move.shx yMove mouse to coordinatesleft_clickclick.shx y leftLeft click at coordinatesright_clickclick.shx y rightRight clickmiddle_clickclick.shx y middleMiddle clickdouble_clickclick.shx y doubleDouble clicktriple_clickclick.shx y tripleTriple click (select line)left_click_dragdrag.shx1 y1 x2 y2Drag from start to endleft_mouse_downmouse_down.sh—Press mouse buttonleft_mouse_upmouse_up.sh—Release mouse buttontypetype_text.sh"text"Type text (50 char chunks, 12ms delay)keykey.sh"combo"Press key (Return, ctrl+c, alt+F4)hold_keyhold_key.sh"key" secsHold key for durationscrollscroll.shdir amt [x y]Scroll up/down/left/rightwaitwait.shsecondsWait then screenshotzoomzoom.shx1 y1 x2 y2Cropped region screenshot

### Usage Examples

export DISPLAY=:99

# Take screenshot
./scripts/screenshot.sh

# Click at coordinates
./scripts/click.sh 512 384 left

# Type text
./scripts/type_text.sh "Hello world"

# Press key combo
./scripts/key.sh "ctrl+s"

# Scroll down
./scripts/scroll.sh down 5

### Workflow Pattern

Screenshot — Always start by seeing the screen
Analyze — Identify UI elements and coordinates
Act — Click, type, scroll
Screenshot — Verify result
Repeat

### Tips

Screen is 1024x768, origin (0,0) at top-left
Click to focus before typing in text fields
Use ctrl+End to jump to page bottom in browsers
Most actions auto-screenshot after 2 sec delay
Long text is chunked (50 chars) with 12ms keystroke delay

### Live Desktop Viewing (VNC)

Watch the desktop in real-time via browser or VNC client.

### Connect via Browser

# SSH tunnel (run on your local machine)
ssh -L 6080:localhost:6080 your-server

# Open in browser
http://localhost:6080/vnc.html

### Connect via VNC Client

# SSH tunnel
ssh -L 5900:localhost:5900 your-server

# Connect VNC client to localhost:5900

### SSH Config (recommended)

Add to ~/.ssh/config for automatic tunneling:

Host your-server
  HostName your.server.ip
  User your-user
  LocalForward 6080 127.0.0.1:6080
  LocalForward 5900 127.0.0.1:5900

Then just ssh your-server and VNC is available.

### System Services

# Check status
systemctl status xvfb xfce-minimal x11vnc novnc

# Restart if needed
sudo systemctl restart xvfb xfce-minimal x11vnc novnc

### Service Chain

xvfb → xfce-minimal → x11vnc → novnc

xvfb: Virtual display :99 (1024x768x24)
xfce-minimal: Watchdog that runs xfwm4+panel, kills xfdesktop
x11vnc: VNC server with -noxdamage for stability
novnc: WebSocket proxy with heartbeat for connection stability

### Opening Applications

export DISPLAY=:99

# Chrome — only use --no-sandbox if the kernel lacks user namespace support.
# Check: cat /proc/sys/kernel/unprivileged_userns_clone
#   1 = sandbox works, do NOT use --no-sandbox
#   0 = sandbox fails, --no-sandbox required as fallback
# Using --no-sandbox when unnecessary causes instability and crashes.
if [ "$(cat /proc/sys/kernel/unprivileged_userns_clone 2>/dev/null)" = "0" ]; then
    google-chrome --no-sandbox &
else
    google-chrome &
fi

xfce4-terminal &                # Terminal
thunar &                        # File manager

Note: Snap browsers (Firefox, Chromium) have sandbox issues on headless servers. Use Chrome .deb instead:

wget https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb
sudo dpkg -i google-chrome-stable_current_amd64.deb
sudo apt-get install -f

### Manual Setup

If you prefer manual setup instead of setup-vnc.sh:

# Install packages
sudo apt install -y xvfb xfce4 xfce4-terminal xdotool scrot imagemagick dbus-x11 x11vnc novnc websockify

# Run the setup script (generates systemd services, masks xfdesktop, starts everything)
./scripts/setup-vnc.sh

If you prefer fully manual setup, the setup-vnc.sh script generates all systemd service files inline -- read it for the exact service definitions.

### VNC shows black screen

Check if xfwm4 is running: pgrep xfwm4
Restart desktop: sudo systemctl restart xfce-minimal

### VNC flickering/flashing

Ensure xfdesktop is masked (check /usr/bin/xfdesktop)
xfdesktop causes flicker due to clear→draw cycles on Xvfb

### VNC disconnects frequently

Check noVNC has --heartbeat 30 flag
Check x11vnc has -noxdamage flag

### x11vnc crashes (SIGSEGV)

Add -noxdamage -noxfixes flags
The DAMAGE extension causes crashes on Xvfb

### Requirements

Installed by setup-vnc.sh:

xvfb xfce4 xfce4-terminal xdotool scrot imagemagick dbus-x11 x11vnc novnc websockify
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: Ram-Raghav-S
- Version: 1.2.1
## 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-02T02:21:57.129Z
- Expires at: 2026-05-09T02:21:57.129Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/computer-use)
- [Send to Agent page](https://openagent3.xyz/skills/computer-use/agent)
- [JSON manifest](https://openagent3.xyz/skills/computer-use/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/computer-use/agent.md)
- [Download page](https://openagent3.xyz/downloads/computer-use)