WoL Wakeup - 局域网唤醒技能

通过关键词匹配触发 Wake-on-LAN 唤醒设备，无需大模型推理。

触发规则（关键词匹配）

工作流模式（推荐）

支持多轮对话，逐步引导用户输入信息。

关键词	动作
帮我开机 / 电脑开机 / 开电脑 / 开机	列出可唤醒设备
开机 - + 设备名/编号

唤醒指定设备 | | 添加网络唤醒 / 添加设备 | 启动添加设备工作流（多轮对话） | | 删除设备 / 移除设备 | 启动删除设备工作流 | | 列表 / 设备列表 | 显示已保存设备 |

单行命令模式（传统）

一次性输入所有信息。

命令格式	示例
添加网络唤醒\	MAC\	备注	添加网络唤醒\	00:11:22:33:44:55\	书房电脑
删除 - 设备名

删除 - 旧电脑 |

配置

设备信息保存在 ~/.openclaw/wol/devices.json

使用示例

查看设备列表

用户：帮我开机
助手：📋 已保存的 WoL 设备：

1. 1. 我的电脑

MAC: 00:11:22:33:44:55
备注：书房台式机

唤醒设备

用户：开机 - 我的电脑
助手：✅ 已发送唤醒信号到：我的电脑 (00:11:22:33:44:55)
请等待设备启动（通常 30-60 秒）

或按编号：

用户：开机 -1
助手：✅ 已发送唤醒信号到：我的电脑 (00:11:22:33:44:55)

添加设备（工作流模式 - 推荐）

用户：添加网络唤醒
助手：📝 第一步：请输入设备名称（如：书房电脑）

用户：书房电脑
助手：📝 第二步：请输入 MAC 地址
格式：00:11:22:33:44:55

用户：00:11:22:33:44:55
助手：📝 第三步：请输入备注信息（可选）
直接回车可跳过

用户：我的台式机
助手：✅ 设备添加成功！
名称：书房电脑
MAC: 00:11:22:33:44:55
备注：我的台式机

添加设备（单行命令模式）

用户：添加网络唤醒|00:11:22:33:44:55|书房台式机
助手：已添加设备：书房台式机 (00:11:22:33:44:55)

删除设备

用户：删除 - 我的电脑
助手：已删除设备：我的电脑

技术实现

架构

• - 工作流引擎: 支持多轮对话、状态保持、流程锁定、超时处理
• Hook 服务: HTTP 服务监听 OpenClaw Internal Hooks，优先匹配工作流
• 消息处理: 工作流未匹配的消息自动放行给 AI 处理

组件

• - workflowengine.py - 工作流引擎核心
• statemanager.py - 会话状态管理
• messagehandler.py - 消息处理器
• openclawhook.py - OpenClaw Hook 服务

数据持久化

• - 设备配置：~/.openclaw/wol/devices.json
• 会话状态：~/.openclaw/wol/workflows/sessions.json

集成方式

通过 OpenClaw Internal Hooks 实现非侵入式集成： json { hooks: { enabled: true, token: <安全 token>, internal: { enabled: true, endpoint: http://127.0.0.1:8765/hook } } }

详见 INTEGRATION_GUIDE.md

注意事项

1. 1. 目标设备必须支持并启用 WoL 功能
2. 设备需在同一局域网或通过路由器转发
3. 首次使用需先添加设备的 MAC 地址
4. MAC 地址格式：XX:XX:XX:XX:XX:XX（12 位十六进制）

获取 MAC 地址

Windows

cmd ipconfig /all

查找物理地址

macOS

bash networksetup -listallhardwareports

或：ifconfig | grep ether

Linux

bash ip link show

或：ifconfig -a

集成到 OpenClaw

快速开始

1. 1. 启动 Hook 服务:

bash cd /root/.openclaw/workspace-zhongshu/skills/wol-wakeup/scripts python3 openclaw_hook.py --port 8765 --token

1. 2. 配置 OpenClaw:

bash python3 updateopenclawconfig.py openclaw gateway restart

1. 3. 测试:

发送微信消息 帮我开机 或 添加网络唤醒

详细文档

• - INTEGRATIONGUIDE.md - 完整集成指南
• INTEGRATIONPLAN.md - 技术方案设计
• scripts/test_integration.py - 自动化测试

运维命令

bash

查看活跃会话

python3 wol_workflow.py list-sessions

清理超时会话

python3 wol_workflow.py check-timeouts

健康检查

curl http://127.0.0.1:8765/health