---
name: hypura-harness-f9d5aafd413e
description: Operate the local Hypura Harness daemon from OpenClaw tools for VRChat OSC, VOICEVOX speech, Desktop Companion control, registry-backed vendor submodules, local Python jobs, skill generation, Shinka evolve, and LoRA workflows.
user-invocable: false
---

# Hypura Harness

Use this skill when the user asks OpenClaw to operate the local Hypura harness, VRChat actuator, VOICEVOX speech path, Desktop Companion bridge, local Python harness jobs, Shinka evolve, LoRA jobs, or sanctioned vendor submodule presets.

## First step

Call `hypura_harness_status` before using other harness tools unless the current turn already proved the daemon is healthy.

If the daemon is unavailable, tell the user the local start paths:

```powershell
.\scripts\launchers\Start-Hypura-Harness.ps1
```

```bash
cd extensions/hypura-harness/scripts && uv run harness_daemon.py
```

Default daemon URL: `http://127.0.0.1:18794`.

## Tool routing

- Use `hypura_harness_companion` for Desktop Companion control through the harness bridge.
- Use `control_companion` directly when the user only wants local avatar speech, emotion, motion, gaze, or model loading and does not need the harness bridge.
- Use `hypura_harness_speak` for VOICEVOX speech through the harness.
- Use `hypura_harness_osc` for VRChat OSC chatbox, movement, emotion, avatar parameter, and input actions.
- Use `hypura_harness_submodule` for external repository presets. Do not use raw subprocess execution for vendor repo commands.
- Use `hypura_harness_run` for local harness-managed Python generation/execution tasks.
- Use `hypura_harness_skill` only when the user asks to generate or update a skill.
- Use `hypura_harness_evolve` for Shinka-style iterative improvement tasks.
- Use `hypura_harness_lora_*` for LoRA curriculum, SFT, and GRPO jobs.

## Companion examples

```json
{ "action": "speak", "value": "Harness bridge online." }
```

```json
{ "action": "emotion", "value": "happy" }
```

```json
{ "action": "load_model", "model_path": "assets/NFD/Hakua/FBX/FBX/Hakua.fbx" }
```

## VRChat OSC examples

```json
{ "action": "chatbox", "payload": { "text": "OpenClaw online." } }
```

```json
{ "action": "emotion", "payload": { "emotion": "happy" } }
```

```json
{ "action": "jump", "payload": {} }
```

```json
{ "action": "param", "payload": { "name": "FaceEmotion", "value": 1 } }
```

## Vendor submodule examples

Use only registered repos and presets from `vendor/submodules/registry.json`.

```json
{ "repoId": "vrchat-mcp-osc", "preset": "status" }
```

```json
{ "repoId": "vrchat-mcp-osc", "preset": "test" }
```

## Safety

- Keep harness work local by default.
- Do not expose raw HTTP `exec` as a replacement for `hypura_harness_submodule` or `submodule_run`.
- Do not print secrets from `.env`, `.openclaw-desktop/.env`, or credential files.
- Confirm user asset rights before loading or activating VRM/FBX/Live2D files.
- Keep `SOUL.md` unchanged unless the user explicitly asks for a SOUL edit.


---
Source attribution: zapabob
Original project: https://github.com/zapabob/clawdbot/blob/ef458153ddced8da7b0ac8a06b58c4ad391488f5/skills/hypura-harness/SKILL.md
License: MIT
License information: https://opensource.org/license/mit
Original upstream instructions; downloaded from Dave AI.

## Upstream license notice

MIT License

Copyright (c) 2025 Peter Steinberger

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.



# Dave AI resource metadata

Creator / publisher: zapabob
Original project: https://github.com/zapabob/clawdbot/blob/ef458153ddced8da7b0ac8a06b58c4ad391488f5/skills/hypura-harness/SKILL.md
Attribution basis: Source repository record

Fields of work: Development & Engineering, Product Management
Roles: Backend Developer, ML / AI Engineer, Product Manager
Specialties: Backend
Tools: OpenAI API, Voicevox, Vrchat
Country applicability: Country not specified
Classification basis: Source catalog labels
Instruction SHA-256: 0922951801e906c8656bc59fb1d9809df0549ef925935c492981a32a254c325c