# Wake On Lan

> Wake-on-LAN functionality for macOS - wake devices remotely by MAC address or name

- Skill: `dvcrn/wake-on-lan` (Agent Skill, multi-file: 3 files)
- Install (CLI): `npx skillmds@latest add dvcrn/wake-on-lan`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/wake-on-lan/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-08
- Page: https://skillmd.com/skills/dvcrn/wake-on-lan

---


# Wake-on-LAN Skill

Wake devices on your local network using Wake-on-LAN (WOL) magic packets.

## Installation

```bash
# Install wakeonlan tool
brew install wakeonlan

# The skill will automatically create config at:
# ~/.config/openclaw/wol-devices.json
```

## Commands

### Wake by MAC Address
Wake any device on your network using its MAC address:
```
wake <MAC address> [broadcast IP]
```
Example: `wake 00:11:22:33:44:55`

### Wake by Name
Wake a device you've saved in the config:
```
wake-name <device name>
```
Example: `wake-name desktop`

### List Devices
Show all saved devices:
```
list
```

### Add Device
Save a new device for easy access:
```
add <name> <MAC address> [broadcast IP]
```
Example: `add desktop 00:11:22:33:44:55 192.168.1.255`

### Remove Device
Remove a device from the config:
```
remove <device name>
```
Example: `remove desktop`

### Query Status
Check if a device is online (requires IP in config):
```
status <device name>
```
Example: `status desktop`

### Broadcast
Wake all saved devices at once:
```
broadcast
```

## Configuration

Devices are stored in `~/.config/openclaw/wol-devices.json`:
```json
[
  {
    "name": "desktop",
    "mac": "00:11:22:33:44:55",
    "broadcast": "192.168.1.255"
  },
  {
    "name": "server",
    "mac": "AA:BB:CC:DD:EE:FF",
    "broadcast": "192.168.1.255"
  }
]
```

## Requirements

- `wakeonlan` command (install via Homebrew)
- Network access to the broadcast address
- Target devices must support Wake-on-LAN (enabled in BIOS/UEFI and OS)