AliasMode
Download free

OpenClaw integration

Give OpenClaw your persistent AliasMode browser profiles.

AliasMode registers as a local stdio MCP server in OpenClaw. The assistant gets profile lifecycle, browser control, and 31 Playwright page actions on the Windows machine that holds the profiles.

Download AliasMode for WindowsRead the MCP reference

Local MCP (stdio) — Windows — Tested 2026-09-01

Direct answer

Run aliasmode-mcp setup --yes --client openclaw in the AliasMode install directory, restart the OpenClaw gateway, and confirm the aliasmode tool list (40 tools on the beta.47 installer).

stdioLocal transport
40Tools on beta.47
LoopbackEverything stays on-device

Set up OpenClaw

  1. Install AliasMode on Windows

    Download the installer, install CloakBrowser, and create at least one profile. Keep the desktop app available; the MCP helper starts it in the background when needed.

  2. Locate the MCP helper

    The Windows installer places aliasmode-mcp.exe next to AliasMode.exe, by default in %LOCALAPPDATA%\AliasMode.

  3. Register the server automatically

    Run the setup from the install directory. It detects OpenClaw, removes any older aliasmode registration, and writes the new one.

    cd "%LOCALAPPDATA%\AliasMode"
aliasmode-mcp setup --yes --client openclaw

  4. Or register manually

    The manual command matches what the setup writes:

    openclaw mcp add aliasmode --command "%LOCALAPPDATA%\AliasMode\aliasmode-mcp.exe" --arg serve

  5. Restart the gateway

    Restart the OpenClaw gateway (or its equivalent runtime) so the new MCP server loads, then confirm the aliasmode tools appear in the tool list.

  6. Run a browser test

    Give the assistant a small end-to-end task:

    List my AliasMode profiles.
Open the profile named Research headless and take a snapshot of the page.
Close the browser.

Verify the connection

  • The OpenClaw tool list shows the aliasmode server with its tools loaded.
  • The tool list includes aliasmode_profiles_list plus 31 Playwright actions — 40 tools on the beta.47 installer.
  • A headless browser opens from a named profile and browser_snapshot returns real page content.
  • GET /api/v1/status on 127.0.0.1:50400 responds on the same machine while the desktop app is open.

Troubleshooting

SymptomFix
OpenClaw does not show the aliasmode toolsRerun aliasmode-mcp setup --yes --client openclaw, then restart the gateway so the MCP server reloads. Confirm the helper path points inside the AliasMode install directory.
Tool calls fail with a runtime readiness errorThe helper starts AliasMode in the background and waits briefly. Open the desktop app manually, wait for the dashboard to load, then retry.
Playwright tools return a selection errorOpen a profile with aliasmode_browser_open or select an open browser with aliasmode_browser_select before page actions.
The browser opens on the wrong machineThe stdio server controls the machine it runs on. Run the OpenClaw gateway on the same Windows machine as AliasMode, or use Remote MCP from other devices.

What OpenClaw gets

  • Profile lifecycle: list, create, and delete profiles through the assistant
  • Browser control: open headful or headless, select an open browser, check status, close safely
  • Page actions: 31 Playwright tools for navigation, forms, screenshots, and verification
  • On-device privacy: profiles, cookies, and proxies stay on the Windows machine

Generic JSON alternative

If you manage OpenClaw MCP servers through a configuration file, the standard stdio shape below is equivalent to what the setup command writes.

{
  "mcpServers": {
    "aliasmode": {
      "command": "C:\\Users\\<you>\\AppData\\Local\\AliasMode\\aliasmode-mcp.exe",
      "args": [
        "serve"
      ]
    }
  }
}
Review the full MCP tool surface

Sources and verification

  • OpenClaw · OpenClaw documentation — MCP server configuration (checked September 2026)
  • AliasMode repository · agent/setup.ts — generated OpenClaw registration command (checked September 2026)
  • AliasMode · Generated MCP tool catalog for the released 0.1.0-beta.47 installer (checked September 2026)

Public product details can change after the check date. Facts are re-checked on a monthly cycle.