openclaw-parallels-smoke

Runs and interprets OpenClaw Parallels VM install, update, and gateway smoke tests.

1|Updated Jun 9, 2026
One-click install
npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill openclaw-parallels-smoke-jerome-prakash-l
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-parallels-smoke
Source: https://github.com/JEROME-PRAKASH-L/openclaw/tree/main/.agents/skills/openclaw-parallels-smoke
Command: npx skills add https://github.com/JEROME-PRAKASH-L/openclaw --skill openclaw-parallels-smoke-jerome-prakash-l

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Validating OpenClaw installs, upgrades, and gateway behavior across macOS, Windows, and Linux Parallels guest VMs is slow and error-prone, with many transport, snapshot, and updater pitfalls that are hard to diagnose without deep runbook knowledge. ## Core Features & Use Cases - Cross-platform smoke orchestration: Drives fresh-install and same-guest update lanes on macOS, Windows, and Linux guests via pnpm test:parallels:* entrypoints with hard timeouts and per-phase logs. - Update-flow verification: Exercises the guest's own openclaw update command against published tags or host-served tgz packages, then verifies version, gateway RPC, and an agent turn. - Failure triage guidance: Encodes known signatures for prlctl exec transport drops, snapshot-switch hangs, npm install stalls, and gateway token mismatches so failures are diagnosed from the right phase log. - Use Case: Before publishing a beta release, run the aggregate npm-update wrapper with --beta-validation to confirm latest-to-beta upgrades and fresh installs pass on all three guest operating systems. ## Quick Start Run the Parallels npm-update smoke matrix for the current beta and summarize any failing lanes from the per-phase logs.

Frequently Asked Questions about openclaw-parallels-smoke

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I run OpenClaw smoke tests in Parallels VMs?

Use the pnpm entrypoints: `pnpm test:parallels:macos`, `pnpm test:parallels:windows`, or `pnpm test:parallels:linux`, each wrapped in a host `timeout --foreground` cap. For full install-plus-update coverage, run `pnpm test:parallels:npm-update` with `--json` for machine-readable summaries.

How do I validate an OpenClaw beta release upgrade?

Run `pnpm test:parallels:npm-update -- --beta-validation beta4 --json` to resolve the latest beta version, run latest-to-beta same-guest updates, and then fresh install smokes on the selected OS matrix. Narrow reruns with `--platform macos|windows|linux`.

Why does prlctl exec fail with an authentication error on macOS guests?

The `Unable to authenticate the user` error indicates a Parallels current-user transport failure, not an npm or OpenClaw problem. Retry through plain root `prlctl exec` plus `sudo -u <desktop-user>` with an explicit HOME and PATH environment.

Can I run multiple Parallels smoke lanes in parallel?

Independent guest-family lanes (macOS, Windows, Linux) can run in parallel, but never two lanes against the same guest family, and never the aggregate npm-update wrapper alongside individual lanes. Also avoid concurrent host builds that mutate `dist` during packaging.

Why does a Windows install phase look stuck during npm install?

Windows global npm installs can stay quiet for over a minute while healthy. Check the streamed guest npm debug log (`npm-cache/_logs/*-debug-0.log`) in the phase log before treating the lane as stalled or blaming the harness.