ToyBridge — Universal BLE Toy Control
Control any BLE toy through OpenClaw, as long as you have the ToyBridge server running.
This skill is for devices that are not supported by Buttplug.io/Intiface — devices with proprietary or unknown protocols that you've reverse-engineered yourself using the ToyBridge toolkit.
If your device IS supported by Buttplug.io, use the intiface-control skill instead — it's easier.
Prerequisites
- 1. You've reverse-engineered your device's BLE protocol using ToyBridge
- You've configured
4-bridge/ble_worker.py for your device - The ToyBridge server is running: INLINECODE2
See the full setup guide for step-by-step instructions.
Commands the agent will use
Vibrate at intensity
CODEBLOCK0
INLINECODE3 : 0–100 (0 = stop)
Stop immediately
CODEBLOCK1
Check status
CODEBLOCK2
If OpenClaw runs natively (not in Docker), replace host.docker.internal with localhost.
Intensity guide
Medium |
| 60–80 | Strong |
| 90–100 | Maximum |
Preset patterns
| Pattern | What it does |
|---|
| INLINECODE6 | Bursts of 80%, 5 times |
| INLINECODE7 |
Ramp up 20→100%, then back down, x2 |
|
tease | 30% → 70% → 100%, escalating, then stop |
To run a pattern:
CODEBLOCK3
Agent rules
- - Always stop (intensity 0) after a timed session unless user says to keep going
- Do not use the
notify tool — use bash with INLINECODE11 - Replace
host.docker.internal with localhost if OpenClaw is not in Docker
Troubleshooting
| Problem | Fix |
|---|
| INLINECODE14 | Make sure uv run 4-bridge/server.py is running |
| Device doesn't respond |
Check your device config in
ble_worker.py |
| Wrong intensity | Values are clamped to 0–100 |
ToyBridge — 通用蓝牙玩具控制
通过OpenClaw控制任何蓝牙玩具，前提是你已运行ToyBridge服务器。
本技能适用于Buttplug.io/Intiface不支持的设备——即那些使用专有或未知协议、且你已通过ToyBridge工具包自行逆向工程的设备。
如果你的设备受Buttplug.io支持，请改用intiface-control技能——操作更简单。
前置条件
- 1. 你已使用ToyBridge逆向工程了设备的蓝牙协议
- 你已为设备配置了4-bridge/bleworker.py
- ToyBridge服务器正在运行：uv run 4-bridge/server.py
详细步骤请参阅完整设置指南。
代理将使用的命令
按强度振动
bash
curl -s -X POST http://host.docker.internal:8888/vibrate \
-H Content-Type: application/json \
-d {intensity: 60}
intensity：0–100（0 = 停止）
立即停止
bash
curl -s -X POST http://host.docker.internal:8888/stop
检查状态
bash
curl -s http://host.docker.internal:8888/status
如果OpenClaw原生运行（不在Docker中），请将host.docker.internal替换为localhost。
强度指南
中等 |
| 60–80 | 强烈 |
| 90–100 | 最大 |
预设模式
| 模式 | 效果描述 |
|---|
| pulse | 80%强度爆发，重复5次 |
| wave |
从20%逐渐升至100%，再回落，重复2次 |
| tease | 30% → 70% → 100%，逐步升级，然后停止 |
运行模式：
bash
curl -s -X POST http://host.docker.internal:8888/vibrate \
-H Content-Type: application/json \
-d {pattern: wave}
代理规则
- - 定时会话结束后始终停止（强度设为0），除非用户要求继续
- 不要使用notify工具——请使用带curl的bash
- 如果OpenClaw不在Docker中，请将host.docker.internal替换为localhost
故障排除
| 问题 | 解决方法 |
|---|
| connection refused | 确保uv run 4-bridge/server.py正在运行 |
| 设备无响应 |
检查ble_worker.py中的设备配置 |
| 强度不正确 | 数值会被限制在0–100范围内 |
