← 返回 Skills 市场
146
总下载
0
收藏
0
当前安装
3
版本数
在 OpenClaw 中安装
/install xiaozhi-mcp-openclaw-official
功能描述
按小智官方 MCP 接入方式,把小智 AI 设备通过 MCP 接到 OpenClaw / OpenAI-compatible 后端。适用于已经有小智 MCP 接入点(wss://api.xiaozhi.me/mcp/?token=...)的场景。提供一个 `openclaw_query(message)` MCP...
安全使用建议
This package is a small bridge that will forward MCP messages to a model backend and return replies. Before installing: (1) Understand that you must provide MCP_ENDPOINT and OPENAI_KEY (these are secrets); the registry metadata incorrectly omits them — treat that as a red flag. (2) Change OPENAI_BASE from the code's default (https://openclaw.994938.xyz/v1) to a backend you trust; leaving the default will send your API key and queries to that third-party host. (3) Treat MCP_ENDPOINT carefully — it likely contains a token in the URL; don't share .env files. (4) Review .env.example and the code locally to confirm behavior and remove any default endpoints you don't trust. (5) Consider running the bridge in a restricted environment/network and monitoring outgoing connections. If you cannot verify the maintainer or the default backend domain, avoid installing or use only with dummy credentials and behind network controls.
功能分析
Type: OpenClaw Skill
Name: xiaozhi-mcp-openclaw-official
Version: 1.0.2
The bundle implements a bridge (mcp_pipe.py) that connects a remote WebSocket endpoint (MCP_ENDPOINT) to a local MCP server process, piping stdin/stdout/stderr between them. This architecture allows a remote service (XiaoZhi AI) to drive local tool execution, which is functionally similar to a reverse shell and grants the remote endpoint control over local process communication. While this aligns with the stated purpose of hardware integration, the use of a remote-to-local pipe and a hardcoded third-party backend (https://openclaw.994938.xyz/v1 in openclaw_mcp.py) represents a significant security risk.
能力评估
Purpose & Capability
The repository and SKILL.md claim to bridge a XiaoZhi MCP endpoint to an OpenAI/OpenClaw-compatible backend; the two Python files implement that bridge (websocket -> subprocess -> HTTP requests to a model backend). This is coherent with the stated purpose. However, the registry metadata lists 'required env vars: none' while the SKILL.md and code clearly require MCP_ENDPOINT, OPENAI_BASE, OPENAI_KEY and MODEL — a mismatch that may mislead users about what secrets are needed.
Instruction Scope
Runtime instructions limit behavior to connecting to a provided MCP websocket, launching the mcp script, and forwarding queries to a model backend. The code does not attempt to read unrelated system files or credentials. Two points to note: (1) exception/error text from backend calls is included in user-facing replies which could leak internal errors; (2) mcp_pipe.py spawns a subprocess and proxies raw messages between websocket and the MCP script — this is expected for this bridge but grants the script full ability to send/receive MCP messages.
Install Mechanism
No install script downloads arbitrary code; the package is instruction-only with a requirements.txt. Installation is via pip install -r requirements.txt (standard). There are no remote archive downloads or obscure install URLs.
Credentials
The code needs sensitive environment values (MCP_ENDPOINT which typically embeds a token, OPENAI_KEY) — these are appropriate for a bridge but the registry metadata fails to declare them. More importantly, OPENAI_BASE defaults to 'https://openclaw.994938.xyz/v1' in code: a third-party domain is embedded as a default backend without explanation. If a user leaves defaults unchanged, their API key and all forwarded messages could be sent to that external service. This default backend choice is unexpected and increases risk.
Persistence & Privilege
The skill is not marked always:true and does not request persistent platform privileges. It doesn't attempt to modify other skills or system-wide agent settings. It runs as a transient bridge process.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install xiaozhi-mcp-openclaw-official - 安装完成后,直接呼叫该 Skill 的名称或使用
/xiaozhi-mcp-openclaw-official触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.2
Rename skill display name to 小智AI-Xiaozhi Mcp Openclaw Official.
v1.0.1
Add bilingual Chinese/English README and SKILL documentation.
v1.0.0
Initial release: official XiaoZhi MCP bridge for OpenClaw/OpenAI-compatible backends, with openclaw_query tool and minimal deployment instructions.
元数据
常见问题
Xiaozhi Mcp Openclaw Official 是什么?
按小智官方 MCP 接入方式,把小智 AI 设备通过 MCP 接到 OpenClaw / OpenAI-compatible 后端。适用于已经有小智 MCP 接入点(wss://api.xiaozhi.me/mcp/?token=...)的场景。提供一个 `openclaw_query(message)` MCP... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 146 次。
如何安装 Xiaozhi Mcp Openclaw Official?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install xiaozhi-mcp-openclaw-official」即可一键安装,无需额外配置。
Xiaozhi Mcp Openclaw Official 是免费的吗?
是的,Xiaozhi Mcp Openclaw Official 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Xiaozhi Mcp Openclaw Official 支持哪些平台?
Xiaozhi Mcp Openclaw Official 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Xiaozhi Mcp Openclaw Official?
由 joe12801(@joe12801)开发并维护,当前版本 v1.0.2。
推荐 Skills