← Back to Skills Marketplace
dyz2102

ClawBB

by dyz2102 · GitHub ↗ · v1.1.5 · MIT-0
cross-platform ⚠ suspicious
107
Downloads
0
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install clawbb
Description
ClawBB — Free macOS voice-to-text built for Vibe Coding. Hold Globe key, speak, text appears at your cursor. Powered by Google Gemini LLM. Apple Notarized.
README (SKILL.md)

ClawBB (虾BB)

Hold Globe key. Speak. Text appears. Free voice-to-text built for Vibe Coding.

  • 🆓 Free forever — Google Gemini free tier, 250 transcriptions/day
  • 🌏 Bilingual — Mixed Chinese + English, perfect punctuation for AI prompts
  • 🔴 Live streaming preview — See text appear as you speak (Gemini Live API)
  • ⚡ 341KB pure Swift — Zero dependencies, macOS native
  • 🧠 LLM engine — Not Whisper ASR. Gemini understands meaning, not just sound.
  • 📖 Open source — MIT License, Apple Notarized

Install

Download the Apple Notarized DMG (app release v1.1.3): from GitHub Releases:

curl -L -o /tmp/XiaBB.dmg "https://github.com/dyz2102/xiabb/releases/download/v1.1.3/XiaBB-v1.1.3-macOS-arm64.dmg"

Verify checksum before opening:

echo "ce53a5b0ccc3b0993b284686ab05716f3e616969f98395d1baf8aec083f8d784  /tmp/XiaBB.dmg" | shasum -a 256 -c

Then open the DMG and drag XiaBB.app to Applications:

open /tmp/XiaBB.dmg

The app is signed with Developer ID and Apple Notarized — no Gatekeeper warnings.

Build from source (optional)

If you prefer to inspect and compile yourself:

git clone https://github.com/dyz2102/xiabb.git /tmp/xiabb-build
cd /tmp/xiabb-build
# Review install.sh and native/main.swift before running
cat install.sh
bash install.sh

Requires Xcode Command Line Tools (xcode-select --install).

Setup

Gemini API Key

Get a free key at https://aistudio.google.com/apikey, then configure:

# Recommended: environment variable
export GEMINI_API_KEY="your-key-here"

Or configure via the app's menu bar → "Configure Gemini API Key...".

The key is stored locally at ~/Tools/xiabb/.api-key (chmod 600 recommended).

Permissions

On first launch, macOS will prompt for:

  • Accessibility: Required for Globe key detection (CGEventTap)
  • Microphone: Required for voice recording

Both are standard macOS permissions for a voice input app. Grant them in System Settings → Privacy & Security.

Usage

Action Result
Hold 🌐 Globe key Start recording, HUD shows live preview
Release 🌐 Globe key Transcription pastes at cursor
Click HUD 📋 Copy last result

Security & Privacy

  • Open source: Full source at https://github.com/dyz2102/xiabb — review before use
  • Apple Notarized: Signed with Developer ID, verified by Apple
  • No account required: No signup, no tracking, no telemetry
  • Audio processing: Audio is sent to Google Gemini API for transcription. Review Google's privacy policy if this concerns you.
  • Local storage only: API key and config stored locally, never transmitted except to Gemini API

Links

Usage Guidance
This skill appears internally consistent, but take standard precautions before installing: 1) Verify the GitHub repository (https://github.com/dyz2102/xiabb) and the DMG checksum/signature match the release; 2) Prefer building from source if you want to fully audit the code (SKILL.md includes build steps); 3) Store and protect your GEMINI_API_KEY (it will be saved at ~/Tools/xiabb/.api-key unless you choose env); 4) Be aware audio is sent to Google Gemini — review Google's privacy policy before use; 5) Confirm the app's notarization/signer in Gatekeeper when first opening. If any of these checks fail or the repo/release doesn't match the published claims, do not install.
Capability Analysis
Type: OpenClaw Skill Name: clawbb Version: 1.1.5 The skill bundle (SKILL.md) provides instructions for the agent to download a macOS DMG from an external GitHub repository (github.com/dyz2102/xiabb) and execute it, or alternatively clone the repo and run an 'install.sh' script. While these actions are aligned with the stated purpose of installing a voice-to-text utility, the pattern of downloading and executing remote payloads and requesting high-level system permissions (Accessibility and Microphone) constitutes a high-risk behavior profile, even though no explicit malicious intent is evident in the provided text.
Capability Assessment
✓ Purpose & Capability
Name/description claim voice-to-text powered by Google Gemini and the skill requires GEMINI_API_KEY and a local config path (~/Tools/xiabb/.api-key). Those requirements are directly related and proportionate to a Gemini-based transcription client.
✓ Instruction Scope
SKILL.md only instructs how to download or build the macOS app, how to provide the GEMINI_API_KEY (env or local file), and notes the app will request Accessibility and Microphone permissions and send audio to Gemini. There are no instructions to read unrelated files, exfiltrate other secrets, or call unexpected external endpoints.
ℹ Install Mechanism
The skill is instruction-only (no install spec). It recommends curl to download a DMG from a GitHub Releases URL and provides a SHA‑256 checksum to verify. GitHub Releases is a standard host and a checksum is provided, but downloading and running a DMG is inherently higher risk than a pure instruction-only skill — verify signature/checksum and the upstream repo before opening.
✓ Credentials
Only GEMINI_API_KEY is declared as required (primary credential) and the config path is where that key is stored locally. The requested credential is appropriate for a client that sends audio to the Gemini API.
✓ Persistence & Privilege
always is false; the skill does not request permanent platform-level inclusion or modifications to other skills. The app will request standard macOS permissions (Accessibility, Microphone), which are expected for this functionality.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install clawbb
  3. After installation, invoke the skill by name or use /clawbb
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.1.5
Fix version consistency: skill v1.1.5 references app release v1.1.3
v1.1.4
Fix security scan: remove swiftc requirement, add checksum, declare config path, add security section
v1.1.3
Initial release — Free macOS voice-to-text for Vibe Coding
Metadata
Slug clawbb
Version 1.1.5
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is ClawBB?

ClawBB — Free macOS voice-to-text built for Vibe Coding. Hold Globe key, speak, text appears at your cursor. Powered by Google Gemini LLM. Apple Notarized. It is an AI Agent Skill for Claude Code / OpenClaw, with 107 downloads so far.

How do I install ClawBB?

Run "/install clawbb" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is ClawBB free?

Yes, ClawBB is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does ClawBB support?

ClawBB is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created ClawBB?

It is built and maintained by dyz2102 (@dyz2102); the current version is v1.1.5.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments