{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/virtual-remote-desktop",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=virtual-remote-desktop",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/action_click.sh",
      "scripts/action_cursor_position.sh",
      "scripts/action_key.sh",
      "scripts/action_mouse_move.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/virtual-remote-desktop",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "What this skill is for",
        "body": "Use this when the workflow is:\n\nAI runs browser automation most of the time\nCaptcha / risk-control / MFA appears\nUser takes over remotely for 1-3 minutes\nAI continues automatically\n\nThis version replaces x11vnc+noVNC with KasmVNC and keeps computer-use style action scripts for AI control."
      },
      {
        "title": "0) Install KasmVNC (one-time)",
        "body": "bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/install_kasmvnc.sh\n\nThis installer also prepares required runtime tools:\n\nfluxbox (lightweight desktop)\nxdotool + scrot (computer-use actions)\nxauth"
      },
      {
        "title": "1) Requirement-driven start (recommended)",
        "body": "Before starting, always confirm these user requirements:\n\ntakeover device: 手机 or 电脑\nwebsite render mode: 手机网页 or 桌面网页\naccess mode: 本地隧道 (127.0.0.1) or 临时公网 (0.0.0.0)\nnetwork quality: 弱网 / 普通 / 良好\n\nUse guided script (interactive Q&A):\n\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd_guided.sh\n\nPreview config without starting:\n\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd_guided.sh --dry-run"
      },
      {
        "title": "1.1) Direct start (manual env)",
        "body": "bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\nImportant env vars:\n\nAUTO_LAUNCH_URL (optional): open target page automatically\nKASM_BIND (default 127.0.0.1, safer)\nAUTO_STOP_IDLE_SECS (default 900)\nBROWSER_MOBILE_MODE=1 (launch browser with mobile emulation)\nBROWSER_DEVICE=iphone14pro|pixel7|ipad\n\nExample:\n\nAUTO_LAUNCH_URL=\"https://example.com/login\" \\\nAUTO_STOP_IDLE_SECS=1200 \\\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\nMobile-friendly VNC stream example (better phone takeover UX):\n\nMOBILE_MODE=1 MOBILE_PRESET=phone \\\nAUTO_STOP_IDLE_SECS=900 \\\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\nMobile stream options:\n\nMOBILE_MODE=1 enables mobile defaults\nMOBILE_PRESET=phone|tablet sets default resolution (960x540 / 1280x720)\nKASM_MAX_FPS can be lowered further (e.g. 18) on weak networks\n\nBrowser mobile emulation (website renders as mobile page):\n\nAUTO_LAUNCH_URL=\"https://example.com\" \\\nBROWSER_MOBILE_MODE=1 BROWSER_DEVICE=iphone14pro \\\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\nNotes:\n\nBrowser mobile emulation changes UA + viewport + touch behavior.\nIt is different from MOBILE_MODE (which optimizes VNC stream size)."
      },
      {
        "title": "2) Check status / health",
        "body": "bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/status_vrd.sh\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/health_vrd.sh"
      },
      {
        "title": "3) Stop desktop",
        "body": "bash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/stop_vrd.sh"
      },
      {
        "title": "AI automation actions (computer-use style)",
        "body": "All actions run on the active virtual display from pids.env.\n\n# screenshot (base64)\nbash scripts/action_screenshot.sh\n\n# click / type / key / scroll\nbash scripts/action_click.sh 500 420 left\nbash scripts/action_type.sh \"hello\"\nbash scripts/action_key.sh \"ctrl+l\"\nbash scripts/action_scroll.sh down 4\n\n# helpers\nbash scripts/action_mouse_move.sh 800 300\nbash scripts/action_cursor_position.sh\nbash scripts/action_wait.sh 2\n\nRecommended loop:\n\naction_screenshot.sh\nanalyze\naction_click/type/key/...\nscreenshot verify\nrepeat"
      },
      {
        "title": "Best handoff pattern (AI ↔ User)",
        "body": "When captcha/risk-control appears:\n\nAI sends user the KasmVNC URL + username/password\nUser manually solves challenge\nUser replies “done”\nAI runs screenshot + validation step\nAI resumes automation\n\nThis avoids full manual operation while keeping recovery fast."
      },
      {
        "title": "Preset A: safe local tunnel (recommended)",
        "body": "KASM_BIND=127.0.0.1\nuser connects via SSH tunnel\nbest for security"
      },
      {
        "title": "Preset B: temporary public takeover",
        "body": "KASM_BIND=0.0.0.0\nshort AUTO_STOP_IDLE_SECS (e.g. 300)\nuse only for urgent remote intervention"
      },
      {
        "title": "Notes",
        "body": "KasmVNC uses HTTPS + per-user auth (username/password).\nThis skill stores runtime files in ~/.openclaw/vrd-data by default.\nBrowser profile persistence is controlled by CHROME_PROFILE_DIR.\nIf captcha frequency is high, keep one long-lived profile to reduce repeated challenges."
      }
    ],
    "body": "Virtual Remote Desktop (KasmVNC edition)\nWhat this skill is for\n\nUse this when the workflow is:\n\nAI runs browser automation most of the time\nCaptcha / risk-control / MFA appears\nUser takes over remotely for 1-3 minutes\nAI continues automatically\n\nThis version replaces x11vnc+noVNC with KasmVNC and keeps computer-use style action scripts for AI control.\n\nCore commands\n0) Install KasmVNC (one-time)\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/install_kasmvnc.sh\n\n\nThis installer also prepares required runtime tools:\n\nfluxbox (lightweight desktop)\nxdotool + scrot (computer-use actions)\nxauth\n1) Requirement-driven start (recommended)\n\nBefore starting, always confirm these user requirements:\n\ntakeover device: 手机 or 电脑\nwebsite render mode: 手机网页 or 桌面网页\naccess mode: 本地隧道 (127.0.0.1) or 临时公网 (0.0.0.0)\nnetwork quality: 弱网 / 普通 / 良好\n\nUse guided script (interactive Q&A):\n\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd_guided.sh\n\n\nPreview config without starting:\n\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd_guided.sh --dry-run\n\n1.1) Direct start (manual env)\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\n\nImportant env vars:\n\nAUTO_LAUNCH_URL (optional): open target page automatically\nKASM_BIND (default 127.0.0.1, safer)\nAUTO_STOP_IDLE_SECS (default 900)\nBROWSER_MOBILE_MODE=1 (launch browser with mobile emulation)\nBROWSER_DEVICE=iphone14pro|pixel7|ipad\n\nExample:\n\nAUTO_LAUNCH_URL=\"https://example.com/login\" \\\nAUTO_STOP_IDLE_SECS=1200 \\\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\n\nMobile-friendly VNC stream example (better phone takeover UX):\n\nMOBILE_MODE=1 MOBILE_PRESET=phone \\\nAUTO_STOP_IDLE_SECS=900 \\\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\n\nMobile stream options:\n\nMOBILE_MODE=1 enables mobile defaults\nMOBILE_PRESET=phone|tablet sets default resolution (960x540 / 1280x720)\nKASM_MAX_FPS can be lowered further (e.g. 18) on weak networks\n\nBrowser mobile emulation (website renders as mobile page):\n\nAUTO_LAUNCH_URL=\"https://example.com\" \\\nBROWSER_MOBILE_MODE=1 BROWSER_DEVICE=iphone14pro \\\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/start_vrd.sh\n\n\nNotes:\n\nBrowser mobile emulation changes UA + viewport + touch behavior.\nIt is different from MOBILE_MODE (which optimizes VNC stream size).\n2) Check status / health\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/status_vrd.sh\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/health_vrd.sh\n\n3) Stop desktop\nbash /home/ubuntu/.openclaw/workspace/skills/virtual-remote-desktop/scripts/stop_vrd.sh\n\nAI automation actions (computer-use style)\n\nAll actions run on the active virtual display from pids.env.\n\n# screenshot (base64)\nbash scripts/action_screenshot.sh\n\n# click / type / key / scroll\nbash scripts/action_click.sh 500 420 left\nbash scripts/action_type.sh \"hello\"\nbash scripts/action_key.sh \"ctrl+l\"\nbash scripts/action_scroll.sh down 4\n\n# helpers\nbash scripts/action_mouse_move.sh 800 300\nbash scripts/action_cursor_position.sh\nbash scripts/action_wait.sh 2\n\n\nRecommended loop:\n\naction_screenshot.sh\nanalyze\naction_click/type/key/...\nscreenshot verify\nrepeat\nBest handoff pattern (AI ↔ User)\n\nWhen captcha/risk-control appears:\n\nAI sends user the KasmVNC URL + username/password\nUser manually solves challenge\nUser replies “done”\nAI runs screenshot + validation step\nAI resumes automation\n\nThis avoids full manual operation while keeping recovery fast.\n\nUX presets\nPreset A: safe local tunnel (recommended)\nKASM_BIND=127.0.0.1\nuser connects via SSH tunnel\nbest for security\nPreset B: temporary public takeover\nKASM_BIND=0.0.0.0\nshort AUTO_STOP_IDLE_SECS (e.g. 300)\nuse only for urgent remote intervention\nNotes\nKasmVNC uses HTTPS + per-user auth (username/password).\nThis skill stores runtime files in ~/.openclaw/vrd-data by default.\nBrowser profile persistence is controlled by CHROME_PROFILE_DIR.\nIf captcha frequency is high, keep one long-lived profile to reduce repeated challenges."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/zhangxin15435/virtual-remote-desktop",
    "publisherUrl": "https://clawhub.ai/zhangxin15435/virtual-remote-desktop",
    "owner": "zhangxin15435",
    "version": "1.0.3",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}