← Back to Skills Marketplace
OpenClaw Voice Control
by
CarrotYuan
· GitHub ↗
· v0.1.9
· MIT-0
300
Downloads
0
Stars
0
Active Installs
10
Versions
Install in OpenClaw
/install openclaw-voice-control
Description
Local macOS voice-control integration for OpenClaw. Use when setting up, deploying, troubleshooting, or operating wakeword-triggered voice access to a local...
Usage Guidance
This skill appears to do what it says, but it will fetch and install code from the linked GitHub repository and download local ML models. Before installing: (1) review the repository (especially setup/pyproject, setup scripts, and scripts/deploy_macos.sh) to confirm there is no unexpected behavior, (2) do not supply a highly-privileged OPENCLAW_TOKEN — create a least-privilege token for voice access, (3) confirm any steps that modify system state (launchd auto-start), and (4) prefer running the initial validation in an isolated user account or VM if you want to limit risk. If you are not comfortable reviewing the repo, do not run pip install -e . or enable auto-start.
Capability Assessment
Purpose & Capability
Name, description, required binaries (python3, git, launchctl), required env vars (OPENCLAW_BASE_URL, OPENCLAW_TOKEN, SENSEVOICE_MODEL_PATH, SENSEVOICE_VAD_MODEL_PATH) and launchd usage align with a local macOS voice-control integration for OpenClaw.
Instruction Scope
SKILL.md directs the agent to clone the GitHub repo into the skill workspace, create/activate a venv, pip install -e ., download local models, run the voice service and an overlay, and optionally deploy a launchd auto-start. These steps are within scope but involve running repository code and network downloads; the skill does explicitly require user confirmation before system-changing steps.
Install Mechanism
There is no automated install spec in the registry (instruction-only). The recommended flow uses git fetch and pip install -e . from the upstream GitHub repo and model downloads (modelscope/funasr). This is expected for this kind of local integration, but pip install will execute the repo's installation code so the repo contents should be reviewed prior to installation.
Credentials
Requested environment variables are appropriate for the stated purpose: a base URL and token to contact the local OpenClaw agent and local model path variables for ASR/VAD. No unrelated credentials or broad cloud creds are requested. Note that OPENCLAW_TOKEN is a primary credential that grants whatever access the OpenClaw service allows, so use least-privilege tokens.
Persistence & Privilege
The skill does not force permanent inclusion (always:false). It explicitly offers optional background resident behavior and launchd auto-start via a deploy script; this is reasonable for a persistent voice entrypoint but increases attack surface and should only be enabled after inspecting deploy_macos.sh and confirming intent.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-voice-control - After installation, invoke the skill by name or use
/openclaw-voice-control - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.9
openclaw-voice-control 0.1.9
- Expanded SKILL.md documentation to add instructions for changing the macOS TTS voice.
- Clarified that the user must ensure their preferred voice is downloaded via System Settings before selection.
- No changes to code or user-visible features; documentation only.
v0.1.8
- Reworded setup instructions: "foreground validation" is now "direct-run validation"
- Clarified requirement to stop direct-run tests before proceeding with background deployment or additional validation
- Added warnings about running multiple simultaneous voice runtimes and the risks of duplicate replies
- No code or logic changes; documentation updated only
v0.1.7
- Documentation updated in SKILL.md; text edits and clarifications.
- No code or functional changes, only documentation changes in this release.
v0.1.6
- Updated environment and binary requirements in the `metadata` section, adding variables such as `OPENCLAW_BASE_URL`, `SENSEVOICE_MODEL_PATH`, and `SENSEVOICE_VAD_MODEL_PATH`, and including `launchctl` as a required binary.
- Added new instruction to explicitly ask for user confirmation before performing any system-changing steps (e.g., repository fetch, pip install, model downloads, enabling launchd/auto-start).
- Clarified default route variable requirements for `.env` with a new section listing essential environment variables for setup.
- Improved instructions on handling optional Porcupine wakeword integration, emphasizing not to prompt for Porcupine-specific variables unless requested.
- Enhanced clarity on not assuming system state or reusing old environments or assets without user input.
v0.1.5
openclaw-voice-control 0.1.5
- Updated setup instructions: Foreground validation now requires launching both the voice service and overlay process.
- Added command examples for running both processes simultaneously during foreground validation.
- Clarified that both commands must be run from the same installed skill workspace for proper validation.
- Foreground validation steps and execution rules now explicitly mention starting both main and overlay processes before enabling background behavior.
v0.1.4
- Changed default wakeword provider to openWakeWord and updated all instructions and prerequisites accordingly.
- Added detailed main installation path using openWakeWord, including SenseVoice and VAD model download steps.
- Made Picovoice/Porcupine route optional and documented only as a fallback, not the default.
- Added a safety warning section about voice access and recommended security practices.
- Clarified daily maintenance commands and background deployment flow.
- Improved execution rules, setup prerequisites, shutdown intents, and configuration guides for clarity and security.
v0.1.3
- Added homepage and metadata fields to SKILL.md, documenting repository, supported OS, required binaries, environment variables, and primary token variable.
- No functional or behavioral changes to the skill logic. Documentation and metadata only.
v0.1.2
openclaw-voice-control v0.1.2
- Clarified documentation requirements for model and wakeword files in SKILL.md
- Updated language to specify that SenseVoice and VAD model directories should be downloaded or populated per repository setup, not guessed manually
- No functional or code changes; documentation only
v0.1.1
- Significant repository cleanup: removed 37 files, leaving only SKILL.md in the skill workspace.
- Installation, configuration, and operation are now strictly gated on having the full repository synced—not just SKILL.md.
- Instructions and execution rules in SKILL.md have been updated to emphasize that partial copies are not sufficient and to reinforce starting from a complete repository sync.
- Install and deployment steps now require validation of the full repository presence before proceeding.
v0.1.0
Initial release of OpenClaw Voice Control for macOS, providing local voice access integration for OpenClaw agents.
- Adds wakeword activation, local ASR via FunASR/SenseVoice, and macOS TTS playback.
- Supports overlay UI and background resident mode using launchd with auto-start after login.
- Requires user-provided wakeword/model files and secrets; does not bundle sensitive assets or tokens.
- Documentation details strict installation, deployment, and token handling rules.
- Includes scripts for deployment, service management, and troubleshooting.
- Foreground/manual operation and background/auto-start are both supported, with choice prompted during setup.
Metadata
Frequently Asked Questions
What is OpenClaw Voice Control?
Local macOS voice-control integration for OpenClaw. Use when setting up, deploying, troubleshooting, or operating wakeword-triggered voice access to a local... It is an AI Agent Skill for Claude Code / OpenClaw, with 300 downloads so far.
How do I install OpenClaw Voice Control?
Run "/install openclaw-voice-control" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is OpenClaw Voice Control free?
Yes, OpenClaw Voice Control is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does OpenClaw Voice Control support?
OpenClaw Voice Control is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin).
Who created OpenClaw Voice Control?
It is built and maintained by CarrotYuan (@carrotyuan); the current version is v0.1.9.
More Skills