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

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

然后重启：

openclaw gateway restart

聊天指令

AI 工具

dg_shock

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

dg_pulse_list

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

dg_qr_generate

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

内置波形

自定义波形（波形库）

将 .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 回复中的关键词：

架构

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)

安全机制

协议参考

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

许可证

MIT © FengYing