openclaw

winremote — Windows Remote Control

Control a Windows machine remotely via MCP protocol. 40 tools for desktop automation, system management, file operations, and more.

Prerequisites

• winremote-mcp running on the target Windows machine
• Network access from OpenClaw host to the Windows machine

Quick Setup

On Windows:

pip install winremote-mcp
python -m winremote
# Server starts on http://127.0.0.1:8090/mcp (local only)

# For remote access:
python -m winremote --host 0.0.0.0

With authentication (recommended):

python -m winremote --auth-key "your-secret-key"

Auto-start on boot:

python -m winremote install

OpenClaw Config

Add to ~/.openclaw/openclaw.json:

{
  "mcp": {
    "servers": {
      "winremote": {
        "type": "streamable-http",
        "url": "http://<windows-ip>:8090/mcp"
      }
    }
  }
}

With auth:

{
  "mcp": {
    "servers": {
      "winremote": {
        "type": "streamable-http",
        "url": "http://<windows-ip>:8090/mcp",
        "headers": {
          "Authorization": "Bearer your-secret-key"
        }
      }
    }
  }
}

Available Tools (40)

Desktop Control

• Snapshot — Screenshot + window list (JPEG compressed, multi-monitor support)
• AnnotatedSnapshot — Screenshot with numbered labels on clickable elements
• OCR — Extract text from screen (pytesseract or Windows built-in)
• ScreenRecord — Record screen as GIF (2-10 seconds)
• Click — Mouse click at coordinates (left/right/middle, single/double)
• Type — Type text at coordinates
• Scroll — Scroll at position
• Move — Move mouse or drag
• Shortcut — Keyboard shortcuts (e.g. "ctrl+c", "alt+tab")
• FocusWindow — Bring window to front (fuzzy title match)
• MinimizeAll — Show desktop (Win+D)
• App — Launch, switch, or resize applications

System Management

• Shell — Execute PowerShell commands (with working directory support)
• GetSystemInfo — CPU, memory, disk, network, uptime
• ListProcesses — Process list with CPU/memory usage
• KillProcess — Kill process by PID or name
• ServiceList / ServiceStart / ServiceStop — Windows service management
• TaskList / TaskCreate / TaskDelete — Scheduled task management
• EventLog — Windows event log viewer with level filtering