@bohuyeshan/openagent-labforge-core 3.11.1 → 3.11.3

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/README.md

@@ -1,127 +0,0 @@
-# 🎙️ VoiceClaw — Local Voice I/O for OpenClaw Agents
-
-**ClawHub:** [clawhub.ai/Asif2BD/voiceclaw](https://clawhub.ai/Asif2BD/voiceclaw) · **GitHub:** [github.com/Asif2BD/VoiceClaw](https://github.com/Asif2BD/VoiceClaw)
-
-> Created by **[M Asif Rahman](https://github.com/Asif2BD)** — Founder of [MissionDeck.ai](https://missiondeck.ai) · [xCloud](https://xcloud.host) · [WPDevelopers](https://github.com/WPDevelopers)
-
-A local-only voice skill for [OpenClaw](https://openclaw.ai) agents. Transcribe inbound voice messages with **Whisper** and reply with synthesized speech via **Piper TTS** — no cloud, no API keys, no paid services.
-
----
-
-## Install
-
-**Option 1 — Via ClawHub** *(if ClawHub is installed)*
-```bash
-clawhub install voiceclaw
-```
-
-**Option 2 — Via Git** *(no ClawHub needed)*
-```bash
-git clone https://github.com/Asif2BD/VoiceClaw.git ~/.openclaw/custom-skills/voiceclaw
-```
-
-**Option 3 — Download release** *(manual, no tools needed)*
-```bash
-curl -L https://github.com/Asif2BD/VoiceClaw/releases/latest/download/voiceclaw.skill -o voiceclaw.skill
-unzip voiceclaw.skill -d ~/.openclaw/custom-skills/voiceclaw
-```
-
-> After any install method, restart OpenClaw for the skill to be detected.
-
----
-
-## Requirements
-
-- `whisper` — whisper.cpp binary ([install guide](https://github.com/ggerganov/whisper.cpp))
-- Whisper model: `ggml-base.en.bin` — auto-downloaded on first use, or manually:
-  ```bash
-  # One-time setup only — not run by the skill scripts
-  mkdir -p ~/.cache/whisper
-  curl -L -o ~/.cache/whisper/ggml-base.en.bin \
-    https://huggingface.co/ggerganov/whisper.cpp/resolve/main/ggml-base.en.bin
-  ```
-  > Set `WHISPER_MODEL=/path/to/ggml-base.en.bin` if your model is stored elsewhere.
-- `piper` — TTS binary + `.onnx` voice models ([install guide](https://github.com/rhasspy/piper)). Set `VOICECLAW_VOICES_DIR=/path/to/voices/` to point to your voice models (default: `~/.local/share/piper/voices/`)
-- `ffmpeg` — for audio format conversion
-
----
-
-## What it does
-
-- **Speech-to-Text**: Inbound voice/audio (OGG, MP3, WAV, M4A) → transcript text via Whisper.cpp
-- **Text-to-Speech**: Agent text replies → voice audio via Piper TTS (7 English voices)
-- **Agent behavior**: When a voice message arrives, the agent automatically responds with both voice + text
-- **100% local**: No data sent anywhere — all inference runs on your server
-
----
-
-## How it works
-
-```
-Inbound voice message (OGG/MP3/WAV)
-        ↓
-  ffmpeg → 16kHz mono WAV
-        ↓
-  whisper.cpp → transcript text
-        ↓
-  Agent reads transcript, composes reply
-        ↓
-  Piper TTS → WAV → OGG Opus
-        ↓
-  Voice reply + text transcript sent together
-```
-
----
-
-## Usage
-
-```bash
-# Transcribe a voice message
-bash scripts/transcribe.sh /path/to/voice.ogg
-
-# Generate a voice reply (returns path to WAV)
-bash scripts/speak.sh "Your task is complete." /tmp/reply.wav
-
-# Convert WAV → OGG Opus for Telegram
-ffmpeg -i /tmp/reply.wav -c:a libopus -b:a 32k /tmp/reply.ogg -y
-```
-
----
-
-## Available Voices
-
-| Voice ID | Style |
-|---|---|
-| `en_US-lessac-medium` | Neutral American (default) |
-| `en_US-amy-medium` | Warm American female |
-| `en_US-joe-medium` | American male |
-| `en_US-kusal-medium` | Expressive American male |
-| `en_US-danny-low` | Deep American male (fast) |
-| `en_GB-alba-medium` | British female |
-| `en_GB-northern_english_male-medium` | Northern British male |
-
-Voice models live at `/opt/piper/voices/`. See `SKILL.md` for full agent integration instructions.
-
----
-
-## Security
-
-- **All processing is local** — no audio or text is sent to any cloud service or external API
-- **Temp files are cleaned up** — audio is converted in `/tmp` and deleted immediately after transcription (bash `trap` on EXIT)
-- **Voice names are sanitized** — input stripped to `[a-zA-Z0-9_-]` only, preventing path traversal
-- **No network calls** — neither script makes any network request
-
----
-
-## Author
-
-**[M Asif Rahman](https://github.com/Asif2BD)**
-- 🌐 [asif.im](https://asif.im)
-- 🐙 [github.com/Asif2BD](https://github.com/Asif2BD)
-- 🔑 [clawhub.ai/Asif2BD](https://clawhub.ai/Asif2BD)
-
----
-
-## License
-
-MIT © 2026 [M Asif Rahman](https://github.com/Asif2BD)

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/SECURITY.md

@@ -1,68 +0,0 @@
-# Security Policy
-
-## Overview
-
-VoiceClaw is a **local-only** voice I/O skill. The operational scripts (`transcribe.sh`, `speak.sh`) make **zero network requests** and send **no data to any external service**.
-
-> The only network activity in this project is a **one-time optional setup step** (downloading the Whisper model from HuggingFace). This is not performed by the skill scripts — it is a manual prerequisite documented in SKILL.md.
-
----
-
-## Design Principles
-
-| Property | Detail |
-|---|---|
-| **Local-only inference** | All STT (Whisper) and TTS (Piper) runs on-device using pre-installed binaries |
-| **Zero network calls during operation** | `transcribe.sh` and `speak.sh` make no HTTP requests whatsoever |
-| **No cloud APIs** | No API keys, no external endpoints, no telemetry |
-| **No credential handling** | Scripts accept no passwords, tokens, or secrets |
-| **No eval/exec of untrusted input** | Text is piped to Piper via stdin, never shell-evaluated |
-| **Input sanitization** | Voice name parameter sanitized to `[a-zA-Z0-9_-]` — prevents path traversal |
-| **Temporary file cleanup** | WAV files written to `/tmp` are deleted via bash `trap` on script exit |
-| **File existence checks** | All input files and model files verified before use |
-| **Configurable paths** | No hardcoded system paths — all paths use env vars with safe defaults |
-
----
-
-## Binary Requirements (Declared)
-
-| Binary | Source | Network during operation |
-|---|---|---|
-| `whisper` (whisper.cpp) | Pre-installed local binary | ❌ None |
-| `piper` | Pre-installed local binary (`pip install piper-tts`) | ❌ None |
-| `ffmpeg` | System package (`apt install ffmpeg`) | ❌ None |
-
-### Model Files
-
-| File | Source | Network during operation |
-|---|---|---|
-| `ggml-base.en.bin` | Downloaded once at setup (HuggingFace) | ❌ None — static read-only file |
-| `*.onnx` voice models | Pre-installed at `$VOICECLAW_VOICES_DIR` | ❌ None — static read-only files |
-
-**Path configuration:**
-- Whisper model: `$WHISPER_MODEL` (defaults to `$HOME/.cache/whisper/ggml-base.en.bin`)
-- Piper voices: `$VOICECLAW_VOICES_DIR` (defaults to `$HOME/.local/share/piper/voices/`)
-- No paths are hardcoded to any specific user or system directory.
-
----
-
-## Threat Model
-
-### Protected against
-
-- **Path traversal** — voice name input is stripped to `[a-zA-Z0-9_-]`; any `../` or absolute path attempt results in an empty string, which fails the model existence check and exits cleanly
-- **Temp file leakage** — `/tmp` WAV files deleted on script EXIT via `trap cleanup EXIT`, even on error
-- **Shell injection** — TTS text is passed via stdin to Piper, not interpolated into a shell command
-
-### Out of scope
-
-- Adversarial audio content (e.g., prompt injection via voice) — model-level concern, not script-level
-- Host system security (firewall, user permissions) — OpenClaw deployment concern
-
----
-
-## Reporting a Vulnerability
-
-Open an issue on [GitHub](https://github.com/Asif2BD/VoiceClaw/issues) or contact **M Asif Rahman** directly at [asif.im](https://asif.im).
-
-Please do not disclose security vulnerabilities publicly before they are addressed.

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/SKILL.md

@@ -1,141 +0,0 @@
----
-name: "skills-main/voiceclaw"
-description: "Local voice I/O for OpenClaw agents. Transcribe inbound audio/voice messages using local Whisper (whisper.cpp) and generate voice replies using local Piper TTS. Requires whisper, piper, and ffmpeg pre-installed on the system. All inference runs on-device — no network calls, no cloud APIs, no API keys. Use when an agent receives a voice/audio message and should respond in both voice and text, or when any text response should be synthesized and sent as audio. Triggers on: voice messages, audio attachments, respond in voice, send as audio, speak this, voiceclaw."
-metadata:
-  openclaw: {"requires":{"bins":["whisper","piper","ffmpeg"]},"network":"none","env":[{"name":"WHISPER_BIN","description":"Path to whisper binary (default: auto-detected via which)"},{"name":"WHISPER_MODEL","description":"Path to ggml-base.en.bin model file (default: ~/.cache/whisper/ggml-base.en.bin)"},{"name":"PIPER_BIN","description":"Path to piper binary (default: auto-detected via which)"},{"name":"VOICECLAW_VOICES_DIR","description":"Path to directory containing .onnx voice model files (default: ~/.local/share/piper/voices)"}]}
-  category: "productivity/voice-and-accessibility"
----
-# VoiceClaw
-
-Local-only voice I/O for OpenClaw agents.
-
-- **STT:** `transcribe.sh` — converts audio to text via local Whisper binary
-- **TTS:** `speak.sh` — converts text to speech via local Piper binary
-- **Network calls: none** — both scripts run fully offline
-- **No cloud APIs, no API keys required**
-
----
-
-## Prerequisites
-
-The following must be installed on the system before using this skill:
-
-| Requirement | Purpose |
-|---|---|
-| `whisper` binary | Speech-to-text inference |
-| `ggml-base.en.bin` model file | Whisper STT model |
-| `piper` binary | Text-to-speech synthesis |
-| `*.onnx` voice model files | Piper TTS voices |
-| `ffmpeg` | Audio format conversion |
-
-See **README.md** for installation and setup instructions.
-
----
-
-## Environment Variables
-
-| Variable | Default | Purpose |
-|---|---|---|
-| `WHISPER_BIN` | auto-detected via `which` | Path to whisper binary |
-| `WHISPER_MODEL` | `~/.cache/whisper/ggml-base.en.bin` | Path to Whisper model file |
-| `PIPER_BIN` | auto-detected via `which` | Path to piper binary |
-| `VOICECLAW_VOICES_DIR` | `~/.local/share/piper/voices` | Directory containing `.onnx` voice model files |
-
----
-
-## Verify Setup
-
-```bash
-which whisper && echo "STT binary: OK"
-which piper   && echo "TTS binary: OK"
-which ffmpeg  && echo "ffmpeg: OK"
-ls "${WHISPER_MODEL:-$HOME/.cache/whisper/ggml-base.en.bin}" && echo "STT model: OK"
-ls "${VOICECLAW_VOICES_DIR:-$HOME/.local/share/piper/voices}"/*.onnx 2>/dev/null | head -1 && echo "TTS voices: OK"
-```
-
----
-
-## Inbound Voice: Transcribe
-
-```bash
-# Transcribe audio → text (supports ogg, mp3, m4a, wav, flac)
-TRANSCRIPT=$(bash scripts/transcribe.sh /path/to/audio.ogg)
-```
-
-Override model path:
-```bash
-WHISPER_MODEL=/path/to/ggml-base.en.bin bash scripts/transcribe.sh audio.ogg
-```
-
----
-
-## Outbound Voice: Speak
-
-```bash
-# Step 1: Generate WAV (local Piper — no network)
-WAV=$(bash scripts/speak.sh "Your response here." /tmp/reply.wav en_US-lessac-medium)
-
-# Step 2: Convert to OGG Opus (Telegram voice requirement)
-ffmpeg -i "$WAV" -c:a libopus -b:a 32k /tmp/reply.ogg -y -loglevel error
-
-# Step 3: Send via message tool (filePath=/tmp/reply.ogg)
-```
-
-Override voice directory:
-```bash
-VOICECLAW_VOICES_DIR=/path/to/voices bash scripts/speak.sh "Hello." /tmp/reply.wav
-```
-
----
-
-## Available Voices
-
-| Voice | Style |
-|---|---|
-| `en_US-lessac-medium` | Neutral American (default) |
-| `en_US-amy-medium` | Warm American female |
-| `en_US-joe-medium` | American male |
-| `en_US-kusal-medium` | Expressive American male |
-| `en_US-danny-low` | Deep American male (fast) |
-| `en_GB-alba-medium` | British female |
-| `en_GB-northern_english_male-medium` | Northern British male |
-
----
-
-## Agent Behavior Rules
-
-1. **Voice in → Voice + Text out.** Always respond with both a voice reply and a text reply when a voice message is received.
-2. **Include the transcript.** Show *"🎙️ I heard: [transcript]"* at the top of every text reply to a voice message.
-3. **Keep voice responses concise.** Piper TTS works best under ~200 words — summarize for audio, include full detail in text.
-4. **Local only.** Never use a cloud TTS/STT API. Only the local `whisper` and `piper` binaries.
-5. **Send voice before text.** Send the audio file first, then follow with the text reply.
-
----
-
-## Full Example
-
-```bash
-# 1. Transcribe inbound voice message
-TRANSCRIPT=$(bash path/to/voiceclaw/scripts/transcribe.sh /path/to/voice.ogg)
-
-# 2. Compose reply and generate audio
-RESPONSE="Deployment complete. All checks passed."
-WAV=$(bash path/to/voiceclaw/scripts/speak.sh "$RESPONSE" /tmp/reply_$$.wav)
-ffmpeg -i "$WAV" -c:a libopus -b:a 32k /tmp/reply_$$.ogg -y -loglevel error
-
-# 3. Send voice + text
-# message(action=send, filePath=/tmp/reply_$$.ogg, ...)
-# reply: "🎙️ I heard: $TRANSCRIPT\n\n$RESPONSE"
-```
-
----
-
-## Troubleshooting
-
-| Issue | Fix |
-|---|---|
-| `whisper: command not found` | Ensure whisper binary is installed and in PATH |
-| Whisper model not found | Set `WHISPER_MODEL=/path/to/ggml-base.en.bin` |
-| `piper: command not found` | Ensure piper binary is installed and in PATH |
-| Voice model missing | Set `VOICECLAW_VOICES_DIR=/path/to/voices/` |
-| OGG won't play on Telegram | Ensure `-c:a libopus` flag in ffmpeg command |

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/_meta.json

@@ -1,11 +0,0 @@
-{
-  "owner": "asif2bd",
-  "slug": "voiceclaw",
-  "displayName": "VoiceClaw",
-  "latest": {
-    "version": "1.0.6",
-    "publishedAt": 1772203550157,
-    "commit": "https://github.com/openclaw/skills/commit/d9fd3726c478264910b49beed20658e6ba57e263"
-  },
-  "history": []
-}

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/scripts/speak.sh

@@ -1,52 +0,0 @@
-#!/usr/bin/env bash
-# speak.sh — Convert text to speech using local Piper TTS
-# Usage: speak.sh "text to speak" [output_file.wav] [voice]
-# Output: writes WAV to output_file, prints output path to stdout
-# Available voices: en_US-amy-medium, en_US-joe-medium, en_US-lessac-medium,
-#                   en_US-kusal-medium, en_US-danny-low,
-#                   en_GB-alba-medium, en_GB-northern_english_male-medium
-#
-# Environment variables:
-#   PIPER_BIN           — path to piper binary (default: auto-detected via `which`)
-#   VOICECLAW_VOICES_DIR — path to folder containing *.onnx voice models
-#                          (default: ~/.local/share/piper/voices)
-
-set -euo pipefail
-
-TEXT="${1:-}"
-OUTPUT="${2:-/tmp/voiceclaw_tts_$$.wav}"
-VOICE="${3:-en_US-lessac-medium}"
-VOICES_DIR="${VOICECLAW_VOICES_DIR:-$HOME/.local/share/piper/voices}"
-PIPER_BIN="${PIPER_BIN:-$(which piper 2>/dev/null || echo piper)}"
-
-if [[ -z "$TEXT" ]]; then
-  echo "Usage: speak.sh \"text\" [output.wav] [voice]" >&2
-  echo "  Env: PIPER_BIN, VOICECLAW_VOICES_DIR" >&2
-  exit 1
-fi
-
-# Sanitize voice name — allow only safe characters to prevent path traversal
-VOICE=$(echo "$VOICE" | tr -cd 'a-zA-Z0-9_-')
-if [[ -z "$VOICE" ]]; then
-  echo "Error: voice name is empty after sanitization" >&2
-  exit 1
-fi
-
-MODEL="$VOICES_DIR/$VOICE.onnx"
-CONFIG="$VOICES_DIR/$VOICE.onnx.json"
-
-if [[ ! -f "$MODEL" ]]; then
-  echo "Error: voice model not found: $MODEL" >&2
-  echo "Set VOICECLAW_VOICES_DIR=/path/to/voices/ or install piper voices." >&2
-  echo "Available voices in $VOICES_DIR:" >&2
-  ls "$VOICES_DIR"/*.onnx 2>/dev/null | xargs -n1 basename | sed 's/\.onnx$//' >&2 || echo "  (none found)" >&2
-  exit 1
-fi
-
-# Generate WAV — local piper binary, no network
-CONFIG_ARGS=()
-[[ -f "$CONFIG" ]] && CONFIG_ARGS=(-c "$CONFIG")
-
-echo "$TEXT" | "$PIPER_BIN" -m "$MODEL" "${CONFIG_ARGS[@]}" -f "$OUTPUT" 2>/dev/null
-
-echo "$OUTPUT"

package/generated/skills-bundles/full/skills/productivity/voice-and-accessibility/skills-main__voiceclaw/scripts/transcribe.sh

@@ -1,50 +0,0 @@
-#!/usr/bin/env bash
-# transcribe.sh — Convert audio to text using local Whisper (whisper.cpp)
-# Usage: transcribe.sh <audio_file> [model_path]
-# Output: prints transcript to stdout
-# Supports: ogg, mp3, m4a, wav, flac (auto-converts to wav via ffmpeg)
-#
-# Environment variables:
-#   WHISPER_BIN   — path to whisper binary (default: auto-detected via `which`)
-#   WHISPER_MODEL — path to ggml model file (default: ~/.cache/whisper/ggml-base.en.bin)
-
-set -euo pipefail
-
-AUDIO_FILE="${1:-}"
-MODEL="${2:-${WHISPER_MODEL:-$HOME/.cache/whisper/ggml-base.en.bin}}"
-WHISPER_BIN="${WHISPER_BIN:-$(which whisper 2>/dev/null || echo whisper)}"
-TMP_WAV="/tmp/voiceclaw_stt_$$.wav"
-
-if [[ -z "$AUDIO_FILE" ]]; then
-  echo "Usage: transcribe.sh <audio_file> [model_path]" >&2
-  echo "  Env: WHISPER_BIN, WHISPER_MODEL" >&2
-  exit 1
-fi
-
-if [[ ! -f "$AUDIO_FILE" ]]; then
-  echo "Error: file not found: $AUDIO_FILE" >&2
-  exit 1
-fi
-
-if [[ ! -f "$MODEL" ]]; then
-  echo "Error: Whisper model not found: $MODEL" >&2
-  echo "Set WHISPER_MODEL=/path/to/ggml-base.en.bin to point to your model." >&2
-  echo "See README.md for one-time model download instructions." >&2
-  exit 1
-fi
-
-cleanup() { rm -f "$TMP_WAV"; }
-trap cleanup EXIT
-
-# Convert to 16kHz mono WAV (Whisper requirement) — local ffmpeg, no network
-ffmpeg -i "$AUDIO_FILE" -ar 16000 -ac 1 "$TMP_WAV" -y -loglevel error
-
-# Transcribe — local whisper binary, no network
-"$WHISPER_BIN" -m "$MODEL" "$TMP_WAV" 2>/dev/null \
-  | grep -E '^\[' \
-  | sed 's/\[[0-9:. ->]*\]  *//' \
-  | tr '\n' ' ' \
-  | sed 's/^[[:space:]]*//' \
-  | sed 's/[[:space:]]*$//'
-
-echo  # final newline

package/generated/skills-bundles/full/skills/research/media-search/skills-main__youtube-search/LICENSE.txt

@@ -1,21 +0,0 @@
-MIT License
-
-Copyright (c) 2026 AIsa (aisa.one)
-
-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.