dvcrn Wake-on-LAN (WOL) Skill
Quick Start - Wake a Device
When user requests WOL wake, use the scripts/wol.py script:
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --target <target>
<target>can be: computer name (e.g.,desktop,workstation) or IP address (e.g.,192.168.50.230)
Device Management Commands
The skill now supports managing devices through conversation:
List all devices
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --list-devices
Add a new device (required: name, MAC, IP, subnet_mask)
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --add-device <name> <mac> <ip> <subnet_mask>
Examples:
# Add device with all required fields
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --add-device desktop AA:BB:CC:DD:EE:FF 192.168.1.100 255.255.255.0
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --add-device laptop 11:22:33:44:55:66 192.168.1.101 255.255.255.0
Delete a device
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --delete-device <name>
Show device details
python3 ~/.openclaw/workspace/skills/wol/scripts/wol.py --show-device <name>
Configuration
Edit references/devices.yaml to manually map computer names to MAC addresses:
devices:
desktop:
mac: "AA:BB:CC:DD:EE:FF"
ip: "192.168.1.100"
workstation:
mac: "11:22:33:44:55:66"
ip: "192.168.50.230"
living-room-pc:
mac: "FF:EE:DD:CC:BB:AA"
ip: "192.168.1.50"
How It Works
Waking:
- If target is an IP address → use it to look up MAC via ARP, or broadcast to all interfaces
- If target is a name → lookup MAC from
devices.yaml - Send magic packet to broadcast address (255.255.255.255) on port 9
Device Management:
--add-devicevalidates MAC address format before saving--delete-deviceperforms case-insensitive name matching- Devices are stored in
references/devices.yaml
Conversation Examples
| User Request | Action |
|---|---|
| "唤醒desktop" | wol.py --target desktop |
| "唤醒192.168.1.100" | wol.py --target 192.168.1.100 |
| "wake up desktop" | wol.py --target desktop |
| "wake up 192.168.1.100" | wol.py --target 192.168.1.100 |
| "查看所有设备" | wol.py --list-devices |
| "添加新设备，名字叫server，MAC是AA:BB:CC:DD:EE:FF" | wol.py --add-device server AA:BB:CC:DD:EE:FF |
| "添加设备，workstation，MAC 11:22:33:44:55:66，IP 192.168.50.230" | wol.py --add-device workstation 11:22:33:44:55:66 192.168.50.230 |
| "删除desktop设备" | wol.py --delete-device desktop |
Notes
- MAC addresses accept various formats:
AA:BB:CC:DD:EE:FF,AA-BB-CC-DD-EE-FF,AA.BB.CC.DD.EE.FF - IP address is optional when adding devices (used for friendly lookup)
- The script performs case-insensitive device name matching for delete/show operations
🔒 Security Guidelines
IMPORTANT: Follow these rules to protect device privacy:
MAC Address Display: When displaying device information (list/show commands), MAC addresses are automatically masked. Only the first and last segments are visible (e.g.,
EC:***:6C). Never reveal full MAC addresses through conversation.Configuration File Access: Do NOT read or show the contents of
references/devices.yamlto users. This file contains sensitive MAC addresses. The script handles all operations internally.Conversation Restrictions:
- Never tell the user the full MAC address of any device, even if asked
- If asked to show MAC address, respond that MAC addresses are hidden for security
- Do not read the YAML configuration file directly in conversation
- Operations like wake/add/delete can be performed without revealing MAC addresses
User Instructions: If users need to manage MAC addresses, instruct them to use the CLI commands directly rather than requesting the AI to read configuration files.