WoL Wakeup - 局域网唤醒技能#

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

触发规则（关键词匹配）#

工作流模式（推荐）#

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

关键词动作帮我开机 / 电脑开机 / 开电脑 / 开机列出可唤醒设备开机 - + 设备名/编号唤醒指定设备添加网络唤醒 / 添加设备启动添加设备工作流（多轮对话）删除设备 / 移除设备启动删除设备工作流列表 / 设备列表显示已保存设备

单行命令模式（传统）#

一次性输入所有信息。

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

配置#

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

使用示例#

查看设备列表#

text

用户：帮我开机
助手：📋 已保存的 WoL 设备：
1. 我的电脑
   MAC: 00:11:22:33:44:55
   备注：书房台式机

唤醒设备#

text

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

或按编号：

text

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

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

text

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

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

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

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

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

text

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

删除设备#

text

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

技术实现#

架构#

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

组件#

• workflow_engine.py - 工作流引擎核心
• state_manager.py - 会话状态管理
• message_handler.py - 消息处理器
• openclaw_hook.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. 目标设备必须支持并启用 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. 启动 Hook 服务:

bash

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

1. 配置 OpenClaw:

bash

python3 update_openclaw_config.py
openclaw gateway restart

1. 测试: 发送微信消息 帮我开机 或 添加网络唤醒

详细文档#

• INTEGRATION_GUIDE.md - 完整集成指南
• INTEGRATION_PLAN.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