← 返回 Skills 市场
dyz2102

ClawBB

作者 dyz2102 · GitHub ↗ · v1.1.5 · MIT-0
cross-platform ⚠ suspicious
107
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install 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.
使用说明 (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

安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install clawbb
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /clawbb 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
Slug clawbb
版本 1.1.5
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 3
常见问题

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. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 107 次。

如何安装 ClawBB?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install clawbb」即可一键安装,无需额外配置。

ClawBB 是免费的吗?

是的,ClawBB 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

ClawBB 支持哪些平台?

ClawBB 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 ClawBB?

由 dyz2102(@dyz2102)开发并维护,当前版本 v1.1.5。

💬 留言讨论