openclaw-plugin-dg-lab

中文 | English

一个 OpenClaw 插件，用于通过 WebSocket 连接并控制 郊狼 (DG-Lab) V3 电刺激设备。

⚠️ 安全声明

本插件控制电刺激设备，不当使用可能造成身体伤害。

• 严禁在胸部、心脏、头部、颈部附近使用。 请遵守 DG-Lab 官方安全指南。
• 务必从最低强度开始，逐步增加。
• 如果您有心脏起搏器、心脏病、癫痫或正在怀孕，请勿使用。
• 请将设备远离儿童。 这是成人用品。
• 您对使用本插件的方式承担全部责任。 作者不对任何伤害、损坏或不当使用承担责任。
• AI 情感引擎可以自动触发电刺激。 在启用 /dg_emotion on 之前请充分了解这一点。
• 软件强度限制是便利功能，不是安全保障。 请务必在 DG-Lab App 中设置安全的硬件上限。

使用本插件即表示您知晓这些风险并同意负责任地使用。

功能特性

• 原生集成 — 与 OpenClaw Gateway 共享进程，无需额外服务
• 二维码配对 — /dg_qr 生成二维码，DG-Lab App 扫码即连
• AI 工具调用 — dg_shock 和 dg_pulse_list 让 AI 直接控制电刺激
• 情感引擎 — /dg_emotion on 开启后，AI 根据回复关键词自动触发刺激
• 强度限制 — /dg_limit 设置软上限；同时尊重 App 端设置的硬件上限
• 安全计时 — 连续使用 1 小时自动断电，强制休息 10 分钟
• 设备反馈同步 — 实时追踪 App 上报的设备强度和上限
• WebSocket 心跳 — 保持连接存活
• 波形连续发送 — 超过 7 秒的波形自动分段无缝发送
• 自定义波形库 — 导入 .pulses / .json5 / .json 文件，兼容 Coyote-Game-Hub 格式
• V3 协议合规 — 使用官方频率压缩算法和消息长度限制

环境要求

• OpenClaw (2026.1+)
• 郊狼 Coyote V3 设备 + 官方 App
• 有公网 IP 的服务器（或端口转发）

安装

一键安装（推荐）：

bash -c "$(curl -fsSL https://raw.githubusercontent.com/FengYing1314/openclaw-plugin-dg-lab/main/install.sh)"

通过 NPM 安装：

openclaw plugins install openclaw-plugin-dg-lab

或者：

npm install -g openclaw-plugin-dg-lab

开发者/源码安装方式:

cd ~/.openclaw/workspace/plugins
git clone https://github.com/FengYing1314/openclaw-plugin-dg-lab.git
cd openclaw-plugin-dg-lab
npm install
npm run build

# 链接安装插件
cd ~/.openclaw/workspace
openclaw plugins install -l ./plugins/openclaw-plugin-dg-lab

配置

在 ~/.openclaw/openclaw.json 中添加：

{
  "plugins": {
    "entries": {
      "openclaw-plugin-dg-lab": {
        "enabled": true,
        "config": {
          "serverIp": "你的公网IP",
          "port": 18888,
          "limitIntensity": 40
        }
      }
    }
  }
}

| 配置项 | 类型 | 默认值 | 说明 | |--------|------|--------|------| | serverIp | string | 127.0.0.1 | 公网 IP 或域名，用于生成二维码 | | port | number | 18888 | WebSocket 服务器端口 | | limitIntensity | number | 40 | 默认强度软上限 (0-200) |

注意：请在防火墙中放行 TCP 18888 端口！

然后重启：

openclaw gateway restart

聊天指令

| 指令 | 说明 | |------|------| | /dg_qr | 生成连接二维码，用 App 扫码连接 | | /dg_emotion on/off | 开启/关闭情感联动模式 | | /dg_limit <0-200> | 设置强度软上限 | | /dg_test +5 | 手动测试强度调整 | | /dg_status | 查看当前插件状态（连接数、强度、设备上限、队列） | | /dg_pulse list | 列出所有已加载的波形 | | /dg_pulse load <文件> | 导入 .pulses / .json5 / .json 波形文件 | | /dg_pulse play <名称> | 在 A 通道播放自定义波形 | | /dg_pulse delete <id> | 删除波形 |

AI 工具

dg_shock

向连接的设备发送电刺激。

| 参数 | 类型 | 必填 | 说明 | |------|------|------|------| | strength | number | ✓ | 强度增量 (正=增加, 负=减少, 0=归零) | | duration | number | | 波形持续时间 ms (默认: 1000) | | waveform | string | | punish / tease / test 或自定义波形名称 (默认: punish) | | channel | string | | A / B (默认: A) |

dg_pulse_list

列出所有可用波形（内置 + 自定义）。

dg_qr_generate

生成配对二维码并返回文件路径。

内置波形

| 名称 | 频率 | 强度 | 描述 | |------|------|------|------| | punish | ~66Hz (15ms) | 100% 持续 | 高频持续刺激 | | tease | ~5Hz (200ms) | 20-80% 正弦 | 低频呼吸式 | | test | ~10Hz (100ms) | 50→90→50% | 中频短促测试 |

自定义波形（波形库）

将 .pulses、.json5 或 .json 文件放入插件的 data/ 目录，启动时自动加载。

支持的格式：

1. Coyote-Game-Hub 格式（波形数组）：

[
  { id: 'abc123', name: '呼吸', pulseData: ['0A0A0A0A00000000', ...] }
]

2. 单个波形: { name: "我的波形", pulseData: [...] }

3. 纯 hex 数组: ["0A0A0A0A64646464", ...]

每个 hex 字符串 16 字符（8 字节）：4 字节频率（压缩值, 10-240）+ 4 字节强度（0-100）。每条代表 100ms（4 × 25ms 窗口）。

情感引擎

通过 /dg_emotion on 启用后，插件分析 AI 回复中的关键词：

| 类型 | 关键词（示例） | 增量 | 波形 | |------|---------------|------|------| | 惩罚 | 罚、教训、电击、punish、maximum | +15 | punish (3s) | | 生气 | 生气、哼、不听话、angry、warning | +8 | punish (2s) | | 安抚 | 乖、奖励、摸摸、good girl、reward | -3 | tease (5s) |

架构

DG-Lab App ←── WebSocket ──→ 插件 WS 服务器 ←── OpenClaw Gateway
                                    ↑
                           AI 调用 dg_shock
                          或情感引擎 Hook

1. 插件在配置端口启动 WebSocket 服务器
2. /dg_qr 生成二维码：https://www.dungeon-lab.com/app-download.php#DGLAB-SOCKET#ws://IP:PORT/CONTROL_ID
3. DG-Lab App 扫码后通过 WebSocket 连接
4. 插件发送强度指令 (strength-CH+MODE+VALUE) 和波形指令 (pulse-CH:[hex...])
5. App 实时上报设备强度和上限 (strength-A+B+limitA+limitB)

安全机制

| 机制 | 说明 | |------|------| | 软件强度限制 | 所有强度变化钳制到 min(插件上限, 设备上限) | | 设备上限同步 | 尊重 DG-Lab App 中设置的硬件上限 | | 1小时自动休息 | 情感模式运行 60 分钟后强制冷却 10 分钟 | | 优雅关闭 | 插件停止时所有通道归零 | | 消息长度检查 | 超过 1950 字符（协议限制）的指令被丢弃 | | 最大 7 秒/段 | 波形自动拆分为 ≤70 帧/次发送 | | 心跳包 | 20 秒 WebSocket 保活 | | 断连清理 | 设备断开时重置强度追踪 |

协议参考

本插件实现了 DG-Lab V3 Socket 控制协议，并使用了 V3 频率压缩算法。

许可证

MIT © FengYing