# Send Multilogin X 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": "multiloginx", "name": "Multilogin X", "source": "tencent", "type": "skill", "category": "开发工具", "sourceUrl": "https://clawhub.ai/MultiloginCom/multiloginx", "canonicalUrl": "https://clawhub.ai/MultiloginCom/multiloginx", "targetPlatform": "OpenClaw" }, "install": { "downloadUrl": "/downloads/multiloginx", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=multiloginx", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "multiloginx", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-05T21:44:11.193Z", "expiresAt": "2026-05-12T21:44:11.193Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=multiloginx", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=multiloginx", "contentDisposition": "attachment; filename=\"multiloginx-1.0.0.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "multiloginx" }, "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/multiloginx" }, "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/multiloginx", "downloadUrl": "https://openagent3.xyz/downloads/multiloginx", "agentUrl": "https://openagent3.xyz/skills/multiloginx/agent", "manifestUrl": "https://openagent3.xyz/skills/multiloginx/agent.json", "briefUrl": "https://openagent3.xyz/skills/multiloginx/agent.md" } } ``` ## Documentation ### Multilogin X Manage anti-detect browser profiles via the xcli CLI. ### CRITICAL: Launcher must run FIRST The mlx-launcher process MUST be running before ANY xcli command (except login) will work. If you skip this, you WILL get "connection refused" or "launcher not active" errors. ### Version resolution Both binaries have a /latest endpoint that returns the current version string: https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/latest → e.g. "0.0.72" https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/latest → e.g. "1.75.0" Download URLs follow the pattern: https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/{VERSION}/xcli_{PLATFORM} https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/{VERSION}/launcher-{PLATFORM} Platform suffixes: Platformxclimlx-launcherLinux x64xcli_linux_amd64launcher-linux_amd64.binmacOS x64xcli_darwin_amd64launcher-darwin_amd64.binmacOS ARMxcli_darwin_arm64launcher-darwin_arm64.binWindowsxcli_windows_amd64.exelauncher-windows_amd64.exe ### Install on Linux (VPS / Docker) # Resolve latest versions CLI_VER=$(curl -sL "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/latest") LAUNCHER_VER=$(curl -sL "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/latest") echo "Installing xcli $CLI_VER, launcher $LAUNCHER_VER" # Download binaries curl -L -o /usr/local/bin/xcli "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/${CLI_VER}/xcli_linux_amd64" curl -L -o /usr/local/bin/mlx-launcher "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/${LAUNCHER_VER}/launcher-linux_amd64.bin" # Make executable chmod +x /usr/local/bin/xcli /usr/local/bin/mlx-launcher # Verify xcli --help mlx-launcher --help ### Install on macOS # Detect architecture ARCH=$(uname -m) if [ "$ARCH" = "arm64" ]; then SUFFIX="darwin_arm64" else SUFFIX="darwin_amd64" fi # Resolve latest versions CLI_VER=$(curl -sL "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/latest") LAUNCHER_VER=$(curl -sL "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/latest") echo "Installing xcli $CLI_VER, launcher $LAUNCHER_VER" # Download binaries curl -L -o /usr/local/bin/xcli "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/${CLI_VER}/xcli_${SUFFIX}" curl -L -o /usr/local/bin/mlx-launcher "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/${LAUNCHER_VER}/launcher-${SUFFIX}.bin" # Make executable chmod +x /usr/local/bin/xcli /usr/local/bin/mlx-launcher # macOS may quarantine downloaded binaries — remove the flag xattr -d com.apple.quarantine /usr/local/bin/xcli 2>/dev/null xattr -d com.apple.quarantine /usr/local/bin/mlx-launcher 2>/dev/null # Verify xcli --help mlx-launcher --help ### Install on Windows # Resolve latest versions $CLI_VER = (Invoke-WebRequest -Uri "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/latest").Content.Trim() $LAUNCHER_VER = (Invoke-WebRequest -Uri "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/latest").Content.Trim() Write-Host "Installing xcli $CLI_VER, launcher $LAUNCHER_VER" # Download binaries Invoke-WebRequest -Uri "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/cli-mlx/${CLI_VER}/xcli_windows_amd64.exe" -OutFile "$env:USERPROFILE\\xcli.exe" Invoke-WebRequest -Uri "https://ml000x-dev-dists.s3.eu-north-1.amazonaws.com/launcher-mlx/${LAUNCHER_VER}/launcher-windows_amd64.exe" -OutFile "$env:USERPROFILE\\mlx-launcher.exe" # Add to PATH (current session) $env:PATH += ";$env:USERPROFILE" ### Environment Detection Detect your environment before running commands: # Am I in Docker? if [ -f /.dockerenv ]; then echo "DOCKER" else echo "BARE METAL" fi Both environments use the same xcli and mlx-launcher binaries — they must be in PATH. ### Headless (VPS / Docker) — Step by Step This is the primary mode. No display, no GUI. Profiles run headless. ### Step 1: Start the launcher mlx-launcher -port 45000 & sleep 5 Verify: xcli launcher-info You MUST see a version number before proceeding. If error — wait and retry. ### Step 2: Login xcli login --username 'USER@EMAIL' --password 'PASSWORD' Ask the user for credentials if not provided. Tokens last ~24h, stored in ~/.config/xcli/. ### Step 3: Launch quick profiles Quick profiles are disposable — deleted automatically when stopped. xcli profile-quick --browser-type mimic --os-type linux --automation puppeteer --headless Launch 2 quick profiles: xcli profile-quick --browser-type mimic --os-type linux --automation puppeteer --headless xcli profile-quick --browser-type mimic --os-type linux --automation puppeteer --headless Each returns a profile ID and a port for Puppeteer/Selenium automation. ### Headless constraints Always use --headless — no display server available. Always use --os-type linux — must match the host OS. Always use --browser-type mimic — stealthfox is NOT available on Linux. Do NOT use profile-create for disposable sessions — use profile-quick. Do NOT run xcli commands in background with & (only mlx-launcher). ### Desktop (macOS / Windows / Linux with GUI) When running on a machine with a display (e.g. a Mac node), profiles can open visible browser windows. ### Step 1: Start the launcher mlx-launcher -port 45000 & sleep 5 xcli launcher-info ### Step 2: Login xcli login --username 'USER@EMAIL' --password 'PASSWORD' ### Step 3: Launch profiles (with GUI) On macOS: xcli profile-quick --browser-type mimic --os-type macos --automation puppeteer xcli profile-quick --browser-type stealthfox --os-type macos --automation puppeteer On Windows: xcli profile-quick --browser-type mimic --os-type windows --automation puppeteer xcli profile-quick --browser-type stealthfox --os-type windows --automation puppeteer Note: No --headless flag — browser windows will be visible. ### Desktop constraints --os-type must match the actual OS (macos, windows, or linux). Both mimic (Chromium) and stealthfox (Firefox) are available on macOS and Windows. On Linux with GUI, only mimic is available. ### GUI via OpenClaw Node (VPS + Mac hybrid) The most elegant setup: VPS runs 24/7 headless, Mac node handles GUI tasks on demand. ### Architecture VPS (OpenClaw main agent, 24/7, headless) ↕ paired via gateway Mac (OpenClaw Node, paired device) → runs Multilogin with visible browser windows → VPS delegates GUI tasks here ### When to use the Node Use the VPS for: Headless quick profiles (automation, scraping, batch tasks) All non-GUI work Delegate to the Mac node when: User wants to SEE the browser (visual inspection, manual interaction) A task requires a real display (CAPTCHAs, visual verification) stealthfox is needed (not available on Linux) Debugging a profile visually ### How to delegate to the Node From the VPS main agent, use sessions_spawn to send a task to the Mac node: { "tool": "sessions_spawn", "agentId": "node-mac", "message": "Start the Multilogin launcher and launch 2 quick profiles with GUI. Use: mlx-launcher -port 45000 & sleep 5 && xcli login --username 'USER' --password 'PASS' && xcli profile-quick --browser-type mimic --os-type macos --automation puppeteer && xcli profile-quick --browser-type stealthfox --os-type macos --automation puppeteer" } The node will: Start the launcher locally on the Mac Login with the provided credentials Launch profiles with visible browser windows Report back the profile IDs and ports ### Setup requirements for the Node The Mac node needs: xcli and mlx-launcher binaries for macOS in PATH (see Install on macOS above) Network access to Multilogin API (signin.multilogin.com) OpenClaw Node running and paired to the VPS gateway ### General CommandDescriptionloginLog in to your accountlauncher-infoGet info about the running launcher (app or agent)helpHelp for all commands ### Folders CommandDescriptioncreate-folderCreate a folder with a given namelist-folderView all available foldersremove-folderRemove a folder by ID (or list of IDs)update-folderUpdate folder details using its ID ### Workspaces CommandDescriptionlist-workspaceDisplay available workspacesswitch-workspaceSwitch to a different workspace ### Proxies CommandDescriptionproxy-countriesList available countries in proxy serviceproxy-regionsGet regions by country codeproxy-citiesGet cities by region codeproxy-getGet a proxy URL based on parameters ### Profiles CommandDescriptionprofile-quickLaunch a disposable quick profile (v4 API)profile-createCreate a new persistent profileprofile-templateCreate a new template for a browser profileprofile-startStart a profile by IDprofile-stopStop a profile by IDprofile-listList profiles in a given folderprofile-statStatistics about currently launched profilesprofile-statusStatus of given profile(s)profile-updateUpdate an existing profileprofile-cloneDuplicate a profileprofile-moveMove profile to a different folderprofile-removeRemove profiles by IDsprofile-restoreRestore a deleted profile from trashprofile-exportExport a profile into a fileprofile-export-statusShow profile export statusprofile-importImport a profile from a fileprofile-import-statusShow profile import statusprofile-cookie-importImport cookies to a profileprofile-cookie-exportExport cookies from a profile ### Scripts CommandDescriptionscript-listList available scripts in Script Runner folderscript-startRun a script in a Multilogin profilescript-stopStop a running scriptcookie-robotStart Cookie Robot on profile(s) ### Objects (extensions, files, etc.) CommandDescriptionobject-typesList object typesobject-listList objectsobject-metaFetch object metadataobject-createCreate an object (requires running agent)object-downloadDownload object to local storageobject-deleteDelete an objectobject-restoreRestore object from trashobject-statsDisplay object usage statisticsobject-convertConvert storage type (local ↔ cloud)enable-objectEnable object for profilesdisable-objectDisable object for profilesobject-extension-createCreate an extension object from a URL ### Tags CommandDescriptioncreate-tagCreate one or more tagstag-listList tags (with optional search filter)tag-removeRemove tags by IDstag-assignAssign tags to a profiletag-unassignUnassign tags from a profile ### 2FA CommandDescriptionenable-2faEnable two-factor authenticationview-backup-codesView backup codesdisable-2fa-for-userDisable 2FA for userdisable-2fa-for-workspaceDisable 2FA for workspaceenable-2fa-for-workspaceEnable 2FA for workspace ### Billing CommandDescriptionreferral-codeGet referral codemultipointsGet multipoints balance ### Quick reference flags FlagValuesNotes--browser-typemimic, stealthfoxLinux: only mimic--os-typelinux, macos, windows, androidMust match host--automationpuppeteer, selenium--headless(no value)Required on headless servers--proxy-string"host:port:user:pass"Optional proxy--proxy-typehttp, https, socks5Required if using proxy--core-versione.g. 144.4Specific browser version ### Troubleshooting ProblemCauseFixconnection refused / launcher not activeLauncher not runningmlx-launcher -port 45000 & then sleep 5browser version not foundWrong os-type/browser-type comboUse --browser-type mimic --os-type linux on Linuxcontext deadline exceededLauncher downloading cores (first run)Wait 30-60s, retry. Cores are cached after first downloadtoken contains invalid segmentsNot logged inxcli loginUNAUTHORIZED_REQUESTToken expired (>24h)xcli login againNeed GUI but on VPSNo display serverDelegate to Mac node via sessions_spawnmacOS: "unidentified developer"Gatekeeper quarantineRun xattr -d com.apple.quarantine ## Trust - Source: tencent - Verification: Indexed source record - Publisher: MultiloginCom - 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-05T21:44:11.193Z - Expires at: 2026-05-12T21:44:11.193Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/multiloginx) - [Send to Agent page](https://openagent3.xyz/skills/multiloginx/agent) - [JSON manifest](https://openagent3.xyz/skills/multiloginx/agent.json) - [Markdown brief](https://openagent3.xyz/skills/multiloginx/agent.md) - [Download page](https://openagent3.xyz/downloads/multiloginx)