← 返回 Skills 市场
saybanet

MLX Local AI

作者 saybanet · GitHub ↗ · v1.0.1 · MIT-0
cross-platform ⚠ suspicious
331
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install mlx-local-ai
功能描述
一键部署支持Apple Silicon的本地LLM与中文向量Embedding服务,含统一API网关及便捷启动管理脚本。
安全使用建议
This package mostly does what it says (sets up a local LLM + embedding stack), but there are several red flags you should address before running: - Unknown model mirror: install/start set HF_ENDPOINT to https://hf-mirror.com. That mirror will serve model artifacts and possibly model-level code. Treat it as untrusted until you verify its operator and content. Prefer official Hugging Face endpoints or local model files. - Remote code execution risk: start_ai.sh launches the chat server with --trust-remote-code. When combined with an untrusted model mirror this allows arbitrary Python from the model repository to run on your machine. Only use --trust-remote-code with repositories you trust. - Missing file: install.sh expects scripts/embedding_server.py to exist (or copies it to $HOME/embedding_server.py), but the package does not include it. That means embedding may not start as advertised; inspect or provide that server script before installing. - Supply-chain & reproducibility: install.sh uses pip install with no pinned versions. That can install unexpected package versions. Review the pip packages (mlx, mlx-lm, sentence-transformers, etc.) and consider pinning versions or auditing them before installation. - Persistent environment changes: SKILL.md suggests appending a source line to your ~/.zshrc and install.sh creates files under $HOME. Back up your rc files first and review config/env.example before sourcing it. Recommended actions: review the code for mlx and mlx-lm packages, verify the identity/trustworthiness of hf-mirror.com or switch HF_ENDPOINT to a trusted source, remove --trust-remote-code or only use it for vetted model repos, supply or inspect embedding_server.py, and run the installation in an isolated environment (VM/container) if you want to test it safely.
功能分析
Type: OpenClaw Skill Name: mlx-local-ai Version: 1.0.1 The skill bundle provides a legitimate set of scripts to deploy local LLM and embedding services on Apple Silicon using the MLX framework. It includes installation, service management, and testing scripts that operate within expected parameters, such as creating a virtual environment in `~/mlx-env` and running local servers on ports 8080 and 8081. While it uses the `--trust-remote-code` flag for the model server and a Hugging Face mirror (`hf-mirror.com`), these are standard practices for local AI deployments and do not indicate malicious intent.
能力评估
Purpose & Capability
The files and scripts implement a local LLM + embedding service as described, but there are small inconsistencies: scripts expect an embedding_server.py to be copied to $HOME (scripts/embedding_server.py is not present in the package), and config/openclaw.json sets the agent primary model to an external model (baiduqianfancodingplan/...) while the skill advertises local models — this could cause unexpected network usage. Overall capability is aligned but some referenced artifacts are missing or point to external models.
Instruction Scope
Runtime instructions and scripts set HF_ENDPOINT to an unknown domain (https://hf-mirror.com) and the chat start command uses --trust-remote-code. That combination lets model loading pull and execute remote model code from the mirror, which can run arbitrary Python during load. SKILL.md and install.sh also instruct modifying shell startup (sourcing env.example into ~/.zshrc), which changes user environment persistently. The scripts otherwise only manipulate files under the user's home directory.
Install Mechanism
There is no signed/verified install package; install.sh uses pip install (no pinned versions) and relies on downloading models from an unverified HF mirror (hf-mirror.com). While no explicit wget/curl downloads of executables appear, model downloads via the mirror and pip installs are a supply-chain vector. The missing embedding_server.py referenced by install.sh is another coherence problem.
Credentials
The skill declares no required env vars, but scripts rely on HF_ENDPOINT and provide comments for optional BAIDU_API_KEY/TAVILY_API_KEY. config/env.example is written and the SKILL.md instructs appending a source line to the user's ~/.zshrc, which introduces persistent environment changes. The openclaw.json also embeds an apiKey value 'local-mlx' (local-only), and the agent default primary model points to an external model — causing the agent to potentially call remote services unrelated to the local-only claim.
Persistence & Privilege
The skill does not request elevated privileges and is not 'always' enabled. However install.sh copies start_ai.sh to ~/start_ai.sh, creates a virtual environment at $HOME/mlx-env, writes config/env.example and suggests modifying ~/.zshrc to source it — these are persistent changes to the user's home environment. Uninstall.sh offers removal steps, but model caches are left unless manually removed.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install mlx-local-ai
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /mlx-local-ai 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
Initial release of mlx-local-ai: one-click local AI services for Apple Silicon. - Provides local LLM (Qwen3.5-4B-OptiQ-4bit via MLX-LM) and embedding (bge-base-zh-v1.5) services - Unified OpenClaw API gateway with OpenAI-compatible endpoints - Simple installation, start/stop scripts, and status checking - Clear API usage examples and troubleshooting steps - macOS 14+, Apple Silicon, Python 3.10+ required
元数据
Slug mlx-local-ai
版本 1.0.1
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

MLX Local AI 是什么?

一键部署支持Apple Silicon的本地LLM与中文向量Embedding服务,含统一API网关及便捷启动管理脚本。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 331 次。

如何安装 MLX Local AI?

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

MLX Local AI 是免费的吗?

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

MLX Local AI 支持哪些平台?

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

谁开发了 MLX Local AI?

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

💬 留言讨论