Windows Automation

# Windows Automation Skill

> Automate Windows desktop interactions using PyAutoGUI

## Overview

This skill provides comprehensive Windows desktop automation capabilities. Use it when you need to:
- Simulate mouse clicks and keyboard input
- Automate GUI interactions in non-web applications
- Capture screenshots
- Manage clipboard content
- Launch applications
- Run system commands

## Setup

The required packages are already installed:
- `pyautogui` - Core automation engine
- `pywin32` - Windows API access
- `pyperclip` - Clipboard operations

If needed, install manually:
```bash
pip install pyautogui pywin32 pyperclip
```

---

## Tools

### 🖱️ Mouse Control

#### `windows_click`
Click at specified screen coordinates.

```python
windows_click(x=100, y=200, button="left", clicks=1)
```

**Parameters:**
| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `x` | float | required | X coordinate |
| `y` | float | required | Y coordinate |
| `button` | str | "left" | "left", "right", "middle" |
| `clicks` | int | 1 | Number of clicks |

---

#### `windows_double_click`
Double click at position.

```python
windows_double_click(x=500, y=300)
```

---

#### `windows_right_click`
Right click at position.

```python
windows_right_click(x=100, y=200)
```

---

#### `windows_move`
Move mouse to position.

```python
windows_move(x=800, y=600, duration=0.5)
```

**Parameters:**
| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `x` | float | required | X coordinate |
| `y` | float | required | Y coordinate |
| `duration` | float | 0.2 | Movement duration in seconds |

---

### ⌨️ Keyboard Control

#### `windows_type`
Type text using keyboard.

```python
windows_type(text="Hello World!", interval=0.05)
```

**Parameters:**
| Param | Type | Default | Description |
|-------|------|---------|-------------|
| `text` | str | required | Text to type |
| `interval` | float | 0.05 | Delay between keystrokes |

---

#### `wi...

# windows-automation

Windows desktop automation skill for OpenClaw.

## Features

 using PyAutoGUI- 🖱️ **Mouse Control**: Click, double-click, right-click, move, drag
- ⌨️ **Keyboard Control**: Type text, press keys, hotkeys
- 📸 **Screen Operations**: Screenshot capture
- 📋 **Clipboard**: Read and write clipboard content
- 🪟 **App Launch**: Launch Windows applications
- 💻 **Command Execution**: Run PowerShell/CMD commands
- ℹ️ **System Info**: Get cursor position, screen size, system details

## Installation

```bash
pip install pyautogui pywin32 pyperclip
```

## Usage Examples

```
# Click at position
windows_click x=500 y=300

# Open calculator
windows_launch_app name="calc"

# Copy selected text
windows_hotkey ctrl c

# Take a screenshot
windows_screenshot

# Get cursor position
windows_cursor_position

# Run ipconfig
windows_command ipconfig
```

## Tools

| Tool | Description |
|------|-------------|
| `windows_click` | Click at coordinates |
| `windows_double_click` | Double click |
| `windows_right_click` | Right click |
| `windows_move` | Move mouse |
| `windows_type` | Type text |
| `windows_press` | Press a key |
| `windows_hotkey` | Keyboard shortcut |
| `windows_scroll` | Scroll wheel |
| `windows_screenshot` | Take screenshot |
| `windows_cursor_position` | Get cursor position |
| `windows_screen_size` | Get screen resolution |
| `windows_launch_app` | Launch app |
| `windows_command` | Run command |
| `windows_clipboard_read` | Read clipboard |
| `windows_clipboard_write` | Write clipboard |
| `windows_system_info` | System information |

## License

MIT