适用于 Openclaw 的 FreeCAD Scripts

一种用于生成生产级 FreeCAD Python 脚本、宏和参数化 3D 模型的专业自动化技能。

jhauga

v1.0.0

2026年4月8日

安装

基本信息

Skill.md

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。


                  npx clawhub@latest install freecad-scripts

2. 手动安装

将技能文件夹复制到以下位置之一

全局模式

~/.openclaw/skills/

工作区

<project>/skills/

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。


                  请帮我使用 Clawhub 安装 freecad-scripts。如果尚未安装 Clawhub，请先安装（npm i -g clawhub）。

更倾向于下载？

获取包含原生技能文件的ZIP压缩包。

什么是 FreeCAD Scripts？

FreeCAD Scripts 技能是一个功能强大的扩展，专为需要自动化复杂 CAD 工作流程的工程师、设计师和开发人员而设计。它提供了一个与 FreeCAD Python API 交互的专家层，允许用户将自然语言描述转换为精确的几何图形、约束草图和自动化宏。通过与 Openclaw Skills 集成，该工具简化了创建自定义 FeaturePython 对象和复杂 3D 模型的过程。

无论您是构建自定义工作台还是执行重复的几何操作，此技能都能处理 API 语法和文档管理的繁重工作。它支持包括 Part、Mesh、Sketcher 和 Draft 在内的广泛模块，是任何希望通过 Openclaw Skills 拓展开源 CAD 自动化边界的人的必备伴侣。

FreeCAD Scripts 应用场景

使用自定义宏自动化重复的 3D 建模任务和 CAD 操作。
创建根据属性变化动态更新的参数化 FeaturePython 对象。
在 FreeCAD 环境中使用 PySide2 开发交互式 GUI 工具和任务面板。
在 BRep 实体和三角网格格式之间转换及操作几何图形。
为工程文档编写复杂的工程图导出和 FEM 分析脚本。

FreeCAD Scripts 工作原理

通过访问活动文档或通过 App 模块创建新文档来初始化 FreeCAD 环境。
使用 Part 模块定义 3D 几何图形，或在 Sketcher 模块中创建约束 2D 几何图形。
使用 Vectors、Placements 和 Rotations 应用空间变换，以精确放置对象。
执行布尔并集、切割和圆角等拓扑操作，以精炼 3D 形状。
执行文档重算以在 FreeCAD 界面中更新几何图形和可视化表示。

FreeCAD Scripts 配置指南

要在 Openclaw Skills 中使用此技能，请确保您的系统上安装了 FreeCAD（版本 0.19 或更高）。大多数模块都随附 FreeCAD Python 解释器。

# Verify FreeCAD installation
freecad --version

# Ensure your environment points to the FreeCAD Python site-packages if running externally
export PYTHONPATH=$PYTHONPATH:/path/to/freecad/lib

FreeCAD Scripts 数据架构与分类体系

该技能根据 FreeCAD 文档模型和对象层次结构组织 CAD 数据：

组件	描述
FreeCAD.Document	所有对象的主容器，可通过 ActiveDocument 访问。
Part::Feature	包含 BRep 几何和拓扑数据的标准对象。
App::Property	驱动参数化行为的数据字段（长度、角度、矢量）。
Coin3D Scenegraph	通过 Pivy 模块处理的可视化数据，用于 GUI 渲染。