wol-wakeup（月唤醒）

WoL Wakeup - 局域网唤醒技能

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

触发规则（关键词匹配）

工作流模式（推荐）

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

单行命令模式（传统）

一次性输入所有信息。

配置

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

使用示例

查看设备列表

用户：帮我开机
助手：📋 已保存的 WoL 设备：
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 处理

组件

• 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 实现非侵入式集成：

{
  "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

ipconfig /all
# 查找"物理地址"

macOS

networksetup -listallhardwareports
# 或：ifconfig | grep ether

Linux

ip link show
# 或：ifconfig -a

集成到 OpenClaw

快速开始

1. 启动 Hook 服务:

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

1. 配置 OpenClaw:

python3 update_openclaw_config.py
openclaw gateway restart

1. 测试:

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

详细文档

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

运维命令

# 查看活跃会话
python3 wol_workflow.py list-sessions

# 清理超时会话
python3 wol_workflow.py check-timeouts

# 健康检查
curl http://127.0.0.1:8765/health