概述

openclaw-plugin-dg-lab

![npm version](https://www.npmjs.com/package/openclaw-plugin-dg-lab)

!License

!Visitor Count

中文 | 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
        }
      }
    }
  }
}

| 配置项 | 类型 | 默认值 | 说明 |

|--------|------|--------|------|

注意：请在防火墙中放行 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 | 删除波形 |

AI 工具

`dg_shock`

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

| 参数 | 类型 | 必填 | 说明 |

|------|------|------|------|

`dg_pulse_list`

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

`dg_qr_generate`

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

内置波形

| 名称 | 频率 | 强度 | 描述 |

|------|------|------|------|

自定义波形（波形库）

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

支持的格式：

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

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

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

纯 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

插件在配置端口启动 WebSocket 服务器
/dg_qr 生成二维码：https://www.dungeon-lab.com/app-download.php#DGLAB-SOCKET#ws://IP:PORT/CONTROL_ID
DG-Lab App 扫码后通过 WebSocket 连接
插件发送强度指令 (strength-CH+MODE+VALUE) 和波形指令 (pulse-CH:[hex...])
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

版本历史

共 1 个版本

v1.0.3 当前

2026-05-07 15:22 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)