FreeCAD CADPilot

安装指南

1. ClawHub CLI 从源直接安装技能的最快方式。
   npx clawhub@latest install freecad-cadpilot
2. 手动安装 将技能文件夹复制到以下位置之一
   全局模式
   ~/.openclaw/skills/
   工作区
   /skills/
   优先级：工作区 > 本地 > 内置
3. 提示词安装 将此提示词复制到 OpenClaw 即可自动安装。
   请帮我使用 Clawhub 安装 freecad-cadpilot。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。
   更倾向于下载？
   获取包含原生技能文件的ZIP压缩包。
   下载技能 (.zip)

什么是

FreeCAD CADPilot 是一项 Openclaw Skills 集成，可通过 CADPilot 转接器及其本地 stdio MCP 服务器，将 AI 代理连接到已安装的 FreeCAD 实例。它会检查 FreeCAD XML-RPC 端点、验证 uvx 可执行文件、确认 MCP 配置，并在任何建模操作之前探测服务器。
此技能优先考虑安全、透明的使用方式：仅调用探测结果公布的工具，建议先针对相应建模工具调用 operation_help，并优先使用 cad 而非 execute_code。它不会创建 MCP 服务器、重新实现 CAD 工具，也不会编辑 FreeCAD 插件。

应用场景

使用 CADPilot 将 OpenClaw 连接到本地运行的 FreeCAD 实例。
验证 FreeCAD RPC 端点、本地
uvx
是否可用、MCP 服务器配置以及工具握手。
在请求 CAD 操作前，发现 CADPilot 中有哪些工具可用。
先查阅
operation_help
，再调用相应的已公布工具，以创建或修改模型。
在不重启 FreeCAD，也不调用会修改数据的工具作为健康检查的情况下，排查连接或工具调用问题。

工作原理

在 127.0.0.1:9875 的本地 XML-RPC 端点调用 ping()，检查 FreeCAD 是否正在监听；如果结果不是 True，则停止。
从当前环境的 PATH 中解析 uvx；如果未找到可执行文件路径，则停止并报告必须安装 uv。
使用 openclaw mcp show cadpilot --json 检查已保存的 MCP 配置。确认配置使用已解析的 uvx 路径、参数 cadpilot，且没有 URL；如果服务器缺失，则注册服务器。
使用 openclaw mcp probe cadpilot --json 探测 MCP 服务器。只有在诊断信息为空且已公布的工具列表非空时，才继续。
若要检查连通性，报告探测结果中的只读工具名称后停止；不要调用会修改数据的工具来模拟健康检查。
对于建模请求，先针对所请求的操作调用 operation_help，然后调用相应的已公布工具，并优先使用 cad 而非 execute_code。
如果结果明确指出所请求的文档或对象，或返回 FreeCAD 错误，则报告结果。如果探测成功后调用一直挂起，则报告可能有模态对话框阻塞 FreeCAD 的 GUI 线程，并停止。

配置指南

前置条件：OpenClaw、uvx，以及安装了 CADPilot 转接器的本地 FreeCAD 实例。技能元数据还将 python 或 python3 列为可接受的 Python 可执行文件。除非用户提出要求，否则不要重启 FreeCAD。
检查 FreeCAD 的本地 RPC 服务器是否有响应：
python3 -c 'import xmlrpc.client; print(xmlrpc.client.ServerProxy("http://127.0.0.1:9875", allow_none=True).ping())'
只有在输出为 True 时才继续；否则报告 RPC 服务器未运行。如有需要，如果 python 是可用的可执行文件，则用它替换 python3。
从 PATH 中解析 uvx：
command -v uvx
如果缺少该命令，则报告必须安装 uv。不要硬编码其他计算机上的路径。
检查 MCP 配置：
openclaw mcp show cadpilot --json
如果服务器缺失，则使用已解析的 uvx 路径注册：
openclaw mcp add cadpilot --command "" --arg cadpilot --connect-timeout 90 --timeout 60 5 秒的 initialize 超时表示 OpenClaw 注册失败，而非 FreeCAD 故障。然后验证 MCP 握手： openclaw mcp probe cadpilot --json
只有在诊断信息为空且工具列表非空时才继续。让 MCP 使用本地 stdio，让 XML-RPC 连接使用 127.0.0.1:9875；不要配置远程 URL，也不要将 FreeCAD 暴露在 0.0.0.0 上。

数据架构

此技能介绍连接设置和工具发现行为；它不规定生成的项目文件格式，也不会创建单独的数据存储。
项目 详情
技能元数据 名称 freecad-cadpilot，版本 1.0.1，描述用于说明 FreeCAD/CADPilot 的使用方式。
前置条件元数据 需要 openclaw 和 uvx 二进制文件，以及 python 或 python3。
MCP 服务器 服务器名称为 cadpilot；本地 stdio 命令是已解析的 uvx 可执行文件，参数为 cadpilot；不使用 URL。
FreeCAD RPC 本地端点 127.0.0.1:9875，使用 XML-RPC ping() 检查。
探测输出 JSON，其中包含诊断信息和已公布的工具列表；只能调用该列表中的名称，OpenClaw 将其公开为 cadpilot__。
生成的文件和机密信息 未指定生成文件的架构。不要将 API 密钥放入任何文件，也不要配置远程访问。

高级特性

强制采用两段式本地架构：OpenClaw 通过 stdio 连接 CADPilot，而 CADPilot 通过本地 XML-RPC 端点与 FreeCAD 通信。
将 MCP 探测结果作为可用工具的唯一依据；工具调用仅限于探测返回的名称。
将只读连通性验证与建模操作分开，避免临时使用会修改数据的调用进行健康检查。
在执行操作前使用
operation_help
；如果两种工具都适用且已公布，则优先使用更高层级的
cad
工具，而非
execute_code
。
针对 RPC 不可用、缺少
uvx
、MCP 配置或握手问题、FreeCAD 错误，以及可能被模态 GUI 对话框阻塞的调用，提供故障处理方式。
避免修改 CADPilot 插件、构建替代 MCP 服务器、远程暴露 FreeCAD，或在未获用户授权时重启 FreeCAD。

name: freecad-cadpilot description: "FreeCAD, CADPilot, or CAD modeling. Connect local FreeCAD through the cadpilot stdio MCP server and call only tools the probe advertises." version: 1.0.1