← 返回 Skills 市场

FreeCAD

Name: FreeCAD
Author: ninja7v

作者 Luc · GitHub ↗ · v1.0.1 · MIT-0

cross-platform ✓ 安全检测通过

449

总下载

当前安装

版本数

在 OpenClaw 中安装

/install skill-freecad

功能描述

Create or modify 3D CAD models in FreeCAD using parametric JSON operations.

安全使用建议

This skill appears to do what it claims: it runs a packaged Python engine that uses your local FreeCAD installation to create and export CAD models. Before installing or running: - Ensure FreeCAD is installed on the host; the script will try to auto-locate it and can also use FREECAD_PATH if you set it. - Do NOT set FREECAD_PATH to an untrusted directory — the skill imports FreeCAD modules from that path, and a malicious path could execute arbitrary Python code during import. - The skill saves files (model.FCStd, model.step, and any export filename you request) into the working directory; confirm that writing these files is acceptable. - There are no declared network calls or secret-collection behaviors, but the code runs local Python imports and file I/O, so run it in an environment you control (or sandbox) if you have concerns. - Optional: review the FreeCAD installation and the working directory permissions before use. Overall the package is internally consistent with its stated purpose, though it assumes a correctly installed FreeCAD runtime.

功能分析

Type: OpenClaw Skill Name: skill-freecad Version: 1.0.1 The FreeCAD skill provides a structured and safe interface for 3D modeling using parametric JSON operations. The implementation in `scripts/cad_engine.py` and its supporting modules (e.g., `scripts/ops/export.py` and `scripts/ops/utils.py`) includes path traversal protections by using `os.path.basename` on user-provided filenames. The skill instructions in `SKILL.md` enforce the use of structured JSON and discourage the agent from generating raw Python code, which reduces the risk of execution errors or injection. No evidence of data exfiltration, unauthorized network access, or malicious persistence was found.

能力评估

✓ Purpose & Capability

The name/description (parametric FreeCAD operations) aligns with the included scripts: primitives, booleans, transforms, arrays, profiles, export and document management. The only external dependency is the FreeCAD Python libraries, which the code tries to locate. No unrelated binaries or credentials are requested.

✓ Instruction Scope

SKILL.md instructs the agent to produce structured JSON and call the packaged engine (python scripts/cad_engine.py), then read JSON from stdout. The skill writes model.FCStd and model.step and returns object metadata; these outputs are declared. The runtime code also references an optional FREECAD_PATH and standard OS program folders to find FreeCAD — this is reasonable for locating the FreeCAD runtime but is not documented in SKILL.md.

✓ Install Mechanism

There is no external installer or network download; code is bundled with the skill and executed via the system python. No archives or remote URLs are fetched, which keeps install risk low.

ℹ Credentials

The skill declares no required env vars, but the code optionally reads FREECAD_PATH and uses standard ProgramFiles/ProgramW6432/ProgramFiles(x86) locations to find FreeCAD. This is proportionate to the purpose (locating the FreeCAD installation). Be aware that FREECAD_PATH (if set) points the interpreter at a directory whose contents will be imported — setting it to an untrusted path could cause arbitrary code execution during import.

✓ Persistence & Privilege

The skill does not request always:true, does not modify other skills or system-wide agent settings, and only reads/writes files in the working directory (model.FCStd, exported files). It does not request elevated privileges or credentials.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install skill-freecad
安装完成后，直接呼叫该 Skill 的名称或使用 /skill-freecad 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.1

Fix "suspicious patterns detected" by OpenClaw: - Added Dependencies: Added formal metadata.openclaw frontmatter declaring the python runtime requirement. - Auto-Discovery: Implemented a dynamic path-injector in the engine. Standard python will now automatically hunt for and bind to local FreeCAD installations (Windows/Mac/Linux) without crashing. - Security (Sandboxing): Enforced os.path.basename() on all file export operations to prevent path traversal attacks. The skill can no longer write files outside of its active workspace directory. - Clarified Scope: Updated the description to explicitly clarify the use of parametric JSON operations.

v1.0.0

Introducing the FreeCAD Engine for OpenClaw! A fully autonomous, two-way bridge allowing LLM agents to procedurally generate and modify 3D mechanical designs without writing raw Python scripts. Features: - Structured Generative Architecture: Create and modify complex 3D CAD models entirely through atomic JSON payloads passed to a persistent headless engine. - Complete CSG Modeling: Native support for 3D primitives (box, cylinder, sphere, cone, torus) and 2D-to-3D sketching (extrude/revolve polyline profiles). - Advanced Modifiers & Arrays: Easily apply fillets, chamfers, or duplicate objects across linear and polar array patterns. - Intelligent Boolean Batching: Orchestrate massive, multi-step CAD assemblies (fuse, cut, common) in a single workflow execution using the batch operation. - Two-Way Intelligence (Inspect): The engine intercepts standard FreeCAD output and responds exclusively in JSON, granting the AI "vision" into the document state (bounding box dimensions, volume, and object layers) so it can perfectly align subsequent parts. - Automated Exporter: Operates against a single persistent model.FCStd file and supports exporting geometry natively to .step, .stl, and .brep. Requirements: - FreeCAD installed on the host machine. - A python environment containing the FreeCAD library bindings (the environment must be able to run import FreeCAD). (Developer Note: Do not let the agent write messy FreeCAD scripts! Strictly map thoughts into the JSON schema and let cad_engine.py handle the topological Heavy-Lifting).

元数据

Slug skill-freecad

版本 1.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 2

常见问题

FreeCAD 是什么？

Create or modify 3D CAD models in FreeCAD using parametric JSON operations. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件，目前累计下载 449 次。

如何安装 FreeCAD？

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

FreeCAD 是免费的吗？

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

FreeCAD 支持哪些平台？

FreeCAD 跨平台运行，可在任意部署了 OpenClaw / Claude Code 的环境中使用（cross-platform）。

谁开发了 FreeCAD？

由 Luc（@ninja7v）开发并维护，当前版本 v1.0.1。