← 返回 Skills 市场
2655
总下载
0
收藏
8
当前安装
8
版本数
在 OpenClaw 中安装
/install mlx-audio-server
功能描述
Local 24x7 OpenAI-compatible API server for STT/TTS, powered by MLX on your Mac.
安全使用建议
This skill appears to do what it says (install a local MLX audio server and provide STT/TTS helpers), but take these precautions before installing:
- Review the Homebrew tap/formula (guoqiao/tap) referenced by install.sh on GitHub to ensure the code and install steps are trustworthy. Third-party taps can install arbitrary software.
- Prefer running install.sh manually yourself (inspect it line-by-line) rather than letting an agent run it autonomously. The script updates brew, installs packages, and starts a LaunchAgent service.
- Because the skill is marked always: true, it will be force-included in every agent run; consider removing or disabling the skill unless you need that behavior.
- No credentials are requested by the skill, and the runtime scripts only contact localhost for the API, but network activity to fetch the Homebrew tap and packages will occur. Only install on a machine you control and trust.
If you want help auditing the Homebrew formula or reviewing the tap's repository, provide the tap URL and I can list the specific install actions to check.
功能分析
Type: OpenClaw Skill
Name: mlx-audio-server
Version: 0.2.2
The skill is classified as suspicious primarily due to its reliance on an external Homebrew formula from a custom tap (`guoqiao/tap/mlx-audio-server`) in `install.sh`. This introduces a supply chain risk, as the content of this external formula is not part of the analyzed bundle and could potentially be altered or malicious. Additionally, the `install.sh` script establishes persistence by setting up `mlx-audio-server` as a LaunchAgent service on macOS, a high-risk capability, even though it aligns with the stated purpose of running a local 24x7 API server. While other scripts (`run_stt.sh`, `run_tts.sh`) only make local network calls to `localhost:8899`, the external dependency and persistence mechanism elevate the risk beyond benign.
能力评估
Purpose & Capability
Name and description match the provided scripts and README: the skill installs a Homebrew formula for an MLX audio server, exposes OpenAI-compatible endpoints on localhost, and includes helper scripts for STT/TTS. Required binary (brew) and ffmpeg/jq usage are appropriate for the stated purpose.
Instruction Scope
SKILL.md and the scripts limit actions to installing the Homebrew formula, starting/restarting a brew service, converting audio with ffmpeg, and POSTing to localhost:8899. They do not read unrelated system files or exfiltrate data to remote endpoints beyond standard Homebrew/GitHub network operations.
Install Mechanism
There is no formal install spec; the provided install.sh runs 'brew install guoqiao/tap/mlx-audio-server' and 'brew services restart'. This pulls code from a third-party Homebrew tap (guoqiao). Installing a third-party tap via brew is a moderate risk because it executes/installs upstream code not bundled with the skill and the tap/source should be reviewed before trust. No direct download URLs are embedded in the skill, but the tap may fetch arbitrary code.
Credentials
The skill requests no secrets or credentials. It optionally reads MLX_AUDIO_SERVER_PORT for the local port. There are no requested env vars that don't match the task.
Persistence & Privilege
The skill is marked always: true, which force-includes it in every agent run. Combined with the install script that registers a LaunchAgent (brew services) and restarts a service, this grants the skill ongoing system presence without clear justification. While running a local service fits the skill's purpose, always: true is broader than necessary and increases blast radius if the tapped formula or service behaved unexpectedly.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install mlx-audio-server - 安装完成后,直接呼叫该 Skill 的名称或使用
/mlx-audio-server触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.2.2
- Updated description to highlight always-on, local API server capabilities for STT/TTS on Mac.
- Simplified and clarified project overview in SKILL.md.
- Removed the run_stt.py script from the project.
v0.2.1
- Updated SKILL.md to clarify the Homebrew tap source, linking directly to the guoqiao/tap repository.
- Documented default models used for STT (mlx-community/glm-asr-nano-2512-8bit) and TTS (mlx-community/Qwen3-TTS-12Hz-1.7B-VoiceDesign-bf16).
- Improved installation instructions to specify the tap used for the Homebrew formula.
v0.2.0
mlx-audio-server 0.2.0
- Switched installation to use a Homebrew formula (`mlx-audio-server`) for easier setup and management.
- Now installs required dependencies (`ffmpeg`, `jq`) via Homebrew automatically.
- Added new files: `README.md` and `run_stt.py`.
- Updated documentation to reflect the improved installation process and usage instructions.
v0.1.4
- No file changes detected in this release.
- Version number updated to 0.1.4.
v0.1.3
No changes detected in this version.
v0.1.2
- Improved description for clarity: highlights OpenAI compatibility, local operation, and Apple Silicon support.
- Clarified that the server runs in the background as a launchd service.
- Updated default model names and descriptions for both STT and TTS.
- Added note on initial model downloads for first run performance.
- Made instructions and usage examples more concise and user-friendly.
v0.1.1
- Improved clarity in model names and usage instructions.
- Updated default model names to be inline code blocks for emphasis.
- Clarified output formats for both STT and TTS usage.
- Minor wording and formatting enhancements for better readability.
v0.1.0
mlx-audio-server 0.1.0
- Initial release of an audio processing server based on Apple's MLX framework for Apple Silicon.
- Provides fast and efficient text-to-speech (TTS), speech-to-text (STT), and speech-to-speech (STS) functionality.
- Runs as an OpenAI-compatible API server by default on port 8899.
- Includes default models for STT (glm-asr-nano-2512-8bit) and TTS (Qwen3-TTS-12Hz-1.7B-VoiceDesign-bf16).
- Offers simple install and usage scripts, leveraging brew and uv for environment setup.
- Supports macOS with Apple Silicon only.
元数据
常见问题
MLX Audio Server 是什么?
Local 24x7 OpenAI-compatible API server for STT/TTS, powered by MLX on your Mac. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 2655 次。
如何安装 MLX Audio Server?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install mlx-audio-server」即可一键安装,无需额外配置。
MLX Audio Server 是免费的吗?
是的,MLX Audio Server 完全免费(开源免费),可自由下载、安装和使用。
MLX Audio Server 支持哪些平台?
MLX Audio Server 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。
谁开发了 MLX Audio Server?
由 guoqiao(@guoqiao)开发并维护,当前版本 v0.2.2。
推荐 Skills