# Send virtual-remote-desktop 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": "virtual-remote-desktop",
    "name": "virtual-remote-desktop",
    "source": "tencent",
    "type": "skill",
    "category": "通讯协作",
    "sourceUrl": "https://clawhub.ai/zhangxin15435/virtual-remote-desktop",
    "canonicalUrl": "https://clawhub.ai/zhangxin15435/virtual-remote-desktop",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/virtual-remote-desktop",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=virtual-remote-desktop",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/action_click.sh",
      "scripts/action_cursor_position.sh",
      "scripts/action_key.sh",
      "scripts/action_mouse_move.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "virtual-remote-desktop",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-02T04:38:33.678Z",
      "expiresAt": "2026-05-09T04:38:33.678Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=virtual-remote-desktop",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=virtual-remote-desktop",
        "contentDisposition": "attachment; filename=\"virtual-remote-desktop-1.0.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "virtual-remote-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/virtual-remote-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/virtual-remote-desktop",
    "downloadUrl": "https://openagent3.xyz/downloads/virtual-remote-desktop",
    "agentUrl": "https://openagent3.xyz/skills/virtual-remote-desktop/agent",
    "manifestUrl": "https://openagent3.xyz/skills/virtual-remote-desktop/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/virtual-remote-desktop/agent.md"
  }
}
```
## Documentation

### What this skill is for

Use this when the workflow is:

AI runs browser automation most of the time
Captcha / risk-control / MFA appears
User takes over remotely for 1-3 minutes
AI continues automatically

This version replaces x11vnc+noVNC with KasmVNC and keeps computer-use style action scripts for AI control.

### 0) Install KasmVNC (one-time)

bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/install_kasmvnc.sh

This installer also prepares required runtime tools:

fluxbox (lightweight desktop)
xdotool + scrot (computer-use actions)
xauth

### 1) Requirement-driven start (recommended)

Before starting, always confirm these user requirements:

takeover device: 手机 or 电脑
website render mode: 手机网页 or 桌面网页
access mode: 本地隧道 (127.0.0.1) or 临时公网 (0.0.0.0)
network quality: 弱网 / 普通 / 良好

Use guided script (interactive Q&A):

bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd_guided.sh

Preview config without starting:

bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd_guided.sh --dry-run

### 1.1) Direct start (manual env)

bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh

Important env vars:

AUTO_LAUNCH_URL (optional): open target page automatically
KASM_BIND (default 127.0.0.1, safer)
AUTO_STOP_IDLE_SECS (default 900)
BROWSER_MOBILE_MODE=1 (launch browser with mobile emulation)
BROWSER_DEVICE=iphone14pro|pixel7|ipad

Example:

AUTO_LAUNCH_URL="https://example.com/login" \\
AUTO_STOP_IDLE_SECS=1200 \\
bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh

Mobile-friendly VNC stream example (better phone takeover UX):

MOBILE_MODE=1 MOBILE_PRESET=phone \\
AUTO_STOP_IDLE_SECS=900 \\
bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh

Mobile stream options:

MOBILE_MODE=1 enables mobile defaults
MOBILE_PRESET=phone|tablet sets default resolution (960x540 / 1280x720)
KASM_MAX_FPS can be lowered further (e.g. 18) on weak networks

Browser mobile emulation (website renders as mobile page):

AUTO_LAUNCH_URL="https://example.com" \\
BROWSER_MOBILE_MODE=1 BROWSER_DEVICE=iphone14pro \\
bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh

Notes:

Browser mobile emulation changes UA + viewport + touch behavior.
It is different from MOBILE_MODE (which optimizes VNC stream size).

### 2) Check status / health

bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/status_vrd.sh
bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/health_vrd.sh

### 3) Stop desktop

bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/stop_vrd.sh

### AI automation actions (computer-use style)

All actions run on the active virtual display from pids.env.

# screenshot (base64)
bash scripts/action_screenshot.sh

# click / type / key / scroll
bash scripts/action_click.sh 500 420 left
bash scripts/action_type.sh "hello"
bash scripts/action_key.sh "ctrl+l"
bash scripts/action_scroll.sh down 4

# helpers
bash scripts/action_mouse_move.sh 800 300
bash scripts/action_cursor_position.sh
bash scripts/action_wait.sh 2

Recommended loop:

action_screenshot.sh
analyze
action_click/type/key/...
screenshot verify
repeat

### Best handoff pattern (AI ↔ User)

When captcha/risk-control appears:

AI sends user the KasmVNC URL + username/password
User manually solves challenge
User replies “done”
AI runs screenshot + validation step
AI resumes automation

This avoids full manual operation while keeping recovery fast.

### Preset A: safe local tunnel (recommended)

KASM_BIND=127.0.0.1
user connects via SSH tunnel
best for security

### Preset B: temporary public takeover

KASM_BIND=0.0.0.0
short AUTO_STOP_IDLE_SECS (e.g. 300)
use only for urgent remote intervention

### Notes

KasmVNC uses HTTPS + per-user auth (username/password).
This skill stores runtime files in ~/.openclaw/vrd-data by default.
Browser profile persistence is controlled by CHROME_PROFILE_DIR.
If captcha frequency is high, keep one long-lived profile to reduce repeated challenges.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: zhangxin15435
- Version: 1.0.3
## 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-02T04:38:33.678Z
- Expires at: 2026-05-09T04:38:33.678Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/virtual-remote-desktop)
- [Send to Agent page](https://openagent3.xyz/skills/virtual-remote-desktop/agent)
- [JSON manifest](https://openagent3.xyz/skills/virtual-remote-desktop/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/virtual-remote-desktop/agent.md)
- [Download page](https://openagent3.xyz/downloads/virtual-remote-desktop)