← 返回 Skills 市场
OpenClaw Voice Control
作者
CarrotYuan
· GitHub ↗
· v0.1.9
· MIT-0
300
总下载
0
收藏
0
当前安装
10
版本数
在 OpenClaw 中安装
/install 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...
安全使用建议
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openclaw-voice-control - 安装完成后,直接呼叫该 Skill 的名称或使用
/openclaw-voice-control触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
常见问题
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... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 300 次。
如何安装 OpenClaw Voice Control?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openclaw-voice-control」即可一键安装,无需额外配置。
OpenClaw Voice Control 是免费的吗?
是的,OpenClaw Voice Control 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
OpenClaw Voice Control 支持哪些平台?
OpenClaw Voice Control 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。
谁开发了 OpenClaw Voice Control?
由 CarrotYuan(@carrotyuan)开发并维护,当前版本 v0.1.9。
推荐 Skills