最近我把 OpenClaw 这个本地 AI Agent 框架和 SolidWorks 的二次开发链路打通了现在能做到用自然语言直接驱动一部分建模、改参和导出操作。这套组合的定位不是拿 AI 替代 CAD 软件而是让 AI 当“一个能听懂人话的调度员”把重复的 API 调用和参数化设计串成一条能复用的流水线。对于已经在 SolidWorks 里用宏、VBA、C# 做过自动化的人这篇编程指南会告诉你如何用 OpenClaw 做统一入口对于刚接触 OpenClaw、还没想清楚它能接进什么工程场景的人这也是一份 SolidWorks 侧的落地参考。文章里涉及的环境配置、部署步骤和踩坑点都是我自己反复试过的不保证百分之百适配你的版本但至少能让你少走一大半弯路。1. 这个组合到底在解决什么问题1.1 当AI Agent遇上CAD编程OpenClaw 本质上是一个可本地部署的 AI Agent 运行时它负责接收指令、规划任务、调用外部工具再通过 Teams、飞书这类 channel 把结果反馈出来。我们平时说的 Agent 不是聊天机器人它和纯问答工具最大的区别在于“工具调用能力”它能把自然语言翻译成程序能理解的参数再触发本地的脚本或服务。SolidWorks 这边的能力其实一直很开放从新建文档、画草图、拉伸特征到批量改工程图、导出 STEP/IGES底层全都有 API。问题在于这些接口的学习成本不低非程序员光记住IFeatureManager和SketchManager的调用方式就需要不少时间。把 OpenClaw 和 SolidWorks 放到一起等于在“人话”和“API”之间加了一个翻译层。你可以直接说“把这两个面合并”OpenClaw 解析意图后生成或调用对应脚本再返回模型文件路径。这套方案和以前的“宏录制 回放”思路完全不同。录制宏只能重复一模一样的动作而 OpenClaw 能根据不同的参数动态生成调用。更重要的是它能编排多步骤比如“先按 A 型号生成箱体再按 B 型号生成法兰最后把两个零件装配体导出成 STEP”。这种流程以前要写一大段 VBA 或 C# 代码现在只要把参数交给 Agent脚本可以复用同一套封装。1.2 适合谁来参考、能省下什么如果你已经在用 SolidWorks但遇到参数化选型、批量导出、模型格式转换这类重复工作时这套组合会很值。如果你只会写代码但 SolidWorks 操作不熟练OpenClaw 也能帮你把设计意图和 API 调用之间衔接起来毕竟脚本写好之后剩下都是 Agent 的事。最直观的收益是省掉“上下文切换”。以前我要在 SolidWorks 界面、Visual Studio、Python 脚本之间来回跳一会儿查特征树一会儿看日志。现在通过 OpenClaw 把入口统一了尤其适合非标设备、产品改型、批量模型导入 Unity 做验证的人。热词里经常有人搜“solidworks模型导入unity3d”这类工作通常要经过导出中间格式、设定单位、修复法线好几步用脚本固化后让 Agent 执行基本就是一句话的事。当然前提是你得先把环境打磨稳后面的章节就是干这个的。2. 环境准备SolidWorks侧的基础坑2.1 安装、许可和常见启动错误任何集成方案都以一个能正常启动的 SolidWorks 为前提但这一步恰恰最耗人。热词里大量出现“solidworks安装教程”“solidworks崩溃”“无法获得下列许可solidworks standard”说明很多人卡在环境和授权上。先说安装。建议使用管理员身份运行安装程序安装前把杀毒软件退出这个不是玄学安装包里的许可相关服务容易被误删导致后边所有 API 调用全部失败。安装版本选你计划长期使用的版本比如 SolidWorks 2025 SP5 或 2026尽量升到 SP5 以上API 行为会更一致少一些莫名其妙的问题。遇到“无法获得下列许可 solidworks standard”时多数原因是许可服务没启动或授权文件位置不对。先确认 SolidNetWork License Manager 服务已经启动再检查证书有没有被安全软件拦截。公司电脑如果没法手动改服务可以联系 IT 放开对lmgrd.exe和sw_d.exe的端口限制。我遇到过看起来许可证还在但服务停掉的情况重启服务后马上恢复所以排查顺序很重要先服务后文件再端口。如果碰到“安装项目错误: 项目文件不存在 (c:\windows\solidworks\im_20260-40000-1100-100)”这种诡异路径多半是安装缓存损坏把 C 盘里 SolidWorks 相关的临时文件夹清掉重新运行安装修复。删除 SolidWorks 时如果 Electrical 目录一直显示“打开中”先把 SQL Server 相关的 SolidWorks 服务停掉否则文件夹始终被占用。2.2 SolidWorks API与宏环境准备用 OpenClaw 驱动 SolidWorks本质上还是要调用 API。建议把宏录制功能打开用来快速生成代码骨架。录制一次“新建零件 → 画草图 → 拉伸”后保存成宏文件你会看到 VBA 代码里每一行对应什么操作。这个文件就是最可靠的 API 词典。具体操作是在 SolidWorks 里打开“工具 → 宏 → 录制”执行几个基础操作后保存。此时你会得到类似Part.SketchManager.CreateLine的调用样例。OpenClaw 需要读取这些宏文件来了解接口命名和参数顺序。我更推荐直接用 C# 写一个小工具类用SolidWorks.Interop.sldworks命名空间因为 VBA 在复杂几何计算时效率不太行但早期验证用 VBA 最快。要注意宏安全设置。SolidWorks 的宏功能默认可能被禁用需要到选项中把宏安全性设为中或低并勾选“允许访问 VBA 项目”。如果调用 API 时遇到“被调用的对象已与其客户端断开连接”多半是 COM 调用被界面操作打断。批量自动任务时尽量把 SolidWorks 主窗口最小化减少焦点切换引发的崩溃。2.3 模型导入Unity的扩展准备热词里“solidworks模型导入unity3d”搜得很多这里提前把坑说一下。SolidWorks 的模型要进 Unity优先走 STEP 或 IGES 作为中间交换格式也可以直接导出 FBX但单位必须统一。SolidWorks 默认是毫米Unity 默认是米导出时如果没选对单位模型会放大或缩小到完全没法用。装配体模型建议用“另存为 → 零件”先把虚拟零部件保存为标准零件否则 Unity 导入后层级混乱零件名对不上。这段工作和 OpenClaw 的关系在于导出动作完全可以由 API 脚本完成你只需要把导出路径、格式选项写进脚本然后让 Agent 在任务末尾触发。后边我会给一个可用的示例。3. OpenClaw的部署与通道配置3.1 先搞清OpenClaw是什么、和WorkBuddy怎么选很多人拿 OpenClaw 和 WorkBuddy 比。两者都是做 Agent 工作流的区别在于侧重点OpenClaw 更适合本地部署、命令行控制、可编程配置适合想深挖自动化链路的人WorkBuddy 更偏 UI 化操作对不懂代码的人友好。如果你要把 SolidWorks 这种桌面端软件接进来我建议选 OpenClaw因为它能直接把任务脚本跑在本地读写文件没有限制对 COM 进程的调度也更容易控制。WorkBuddy 当然也能用但它把很多操作关在自家沙箱里处理 COM 进程时限制更多。尤其当你需要在 SolidWorks 的进程中反复执行脚本、释放对象时沙箱环境反而添乱。OpenClaw 安装后是命令行优先自定义脚本自由度大本地文件读写、进程启动结束、COM 调用都直接由 Agent 进程操作不会因为网络隔离导致失败。缺点也很明显入门要懂配置文件第一次部署会卡在模型 API 和 channel 授权的互相纠缠上。3.2 本地一键部署与Teams、飞书通道接入部署 OpenClaw 时可以选“本地一键部署”它会自动拉取运行时依赖并生成默认配置文件。跑通基础对话后再接入通道。热词里两个高频需求是“如何接入microsoft teams”和“openclaw在飞书输出容易被截断”说明很多人把它当聊天机器人用但通道影响的是和用户交互的载体不影响 SolidWorks 脚本执行。接入 Teams 时在 Teams 侧创建一个 Bot 应用拿到 client id 和 tenant id再填到 OpenClaw 的 channel 配置里。同一个局域网内测试时把回调地址设为本机局域网地址即可如果要远程访问用公司 IT 提供的连接方案。要注意 Teams 的消息长度限制Agent 一次回复太长会被截断解决思路是把长输出写入本地文件只回传摘要和文件路径。飞书通道的处理类似用富文本分块或者直接给链接。如果你跑 SolidWorks 批量任务结果文件往往很大走文件路径比走聊天内容靠谱得多否则聊天气泡很快就爆了。3.3 配置千问模型和session file locked问题模型配置方面热词“openclaw 配置千问”说明不少人在用阿里千问做底座。原因是本地部署时调用云端 API 比本地小模型的输出更可控。千问的接口兼容 OpenAI 格式在 OpenClaw 里填 base_url 和 api_key 就能用。做工程任务时要把温度调到 0别让 AI 自由发挥太多代码生成场景要的是确定性和可复现。部署过程中最典型的报错是agent failed before reply: session file locked (timeout 60000ms) openclaw。这通常是上一次 Agent 进程没正常退出锁文件还在。在 OpenClaw 的数据目录下找到 session 相关文件删掉带 lock 后缀的文件再重启服务。我遇到过一次是因为杀毒软件扫描占用文件句柄添加白名单后就没再出现。另外多个 Agent 实例同时操作同一个 session 目录也会锁冲突通过 Hub 启动时别开两个窗口操作同一个项目。3.4 用日志判断Agent卡在哪个环节部署完成以后跑一个有工具调用的任务日志里会打印tool_call节点。如果卡在“session file locked”说明进程没起来如果卡在“tool input”说明参数传错了如果卡在“tool output”说明你的 SolidWorks 脚本异常。我习惯开 DEBUG 日志把 Agent 和 SolidWorks 两侧的日志都加上时间戳事后对表排查。这个方法看着笨其实是排查 Agent 链路问题最快的路径。很多时候你以为 Agent 出问题了实际是脚本在某个 API 调用上抛了异常只是没顺着日志往下翻。把日志级别调低然后重复一次任务就能看到卡点。4. 用OpenClaw驱动SolidWorks编程的实操4.1 整体调用链路设计OpenClaw 和 SolidWorks 的集成链路我建议分成四层指令层、Agent 层、脚本层、CAD 层。指令层是用户说话比如“生成一个直径 50 的圆凸台厚度 10mm导出 STL 到 D:\output”。Agent 层负责解析意图、拆解步骤并调用定义好的工具函数。脚本层是我们用 VBA 或 C# 写的 SolidWorks API 程序Agent 通过命令行启动这个程序传入参数。CAD 层就是 SolidWorks COM 进程接收参数后建模、导出。关键点是不要让 Agent 试图动态写一整段复杂 API 代码然后直接执行那样很容易翻车。我实践的可靠方案是提前写好封装好的脚本只暴露几个参数给 Agent例如CreateBoss(radius, height, path)。Agent 只需要负责生成合理的参数和调用时机具体建模逻辑由脚本保证。这就像你不会让实习生凭空画发动机而是让他按标准流程填工艺卡片。Agent 可以不懂FeatureExtrusion2的每个布尔参数但脚本一定得懂。把不确定的部分锁在脚本里Agent 只做任务编排成功率会高很多。4.2 编写SolidWorks API脚本的要点说几个写脚本的硬经验。第一所有与 SolidWorks 交互的调用都通过SldWorks.Application的 API激活文档用GetActiveDoc2或OpenDoc6。但 OpenClaw 调用时 SolidWorks 可能还没启动脚本里必须先判断swApp是不是Nothing如果是就创建实例不然会直接报“对象引用未设置”。第二单位要显式设置。建议在脚本开头用swUnitsType_e.swUnitsTypeMMGS切换为毫米克秒制不然 SolidWorks 默认可能走到英寸制参数全乱。第三每执行一个建模步骤都调用EditRebuild3避免界面刷新不及时导致后续步骤读取不到几何。还需要注意 COM 进程的释放。SolidWorks 的 API 调用完成后要手动Marshal.ReleaseComObject或CloseDoc不然每次跑完任务都残留一个进程跑几次后内存占满接着就是 SolidWorks 崩溃。热词里很多人问 SolidWorks 崩溃问题可能不是软件本身的问题而是脚本没有正确释放 COM 引用。脚本里要加上异常处理把所有错误写进日志文件。OpenClaw 拿不到异常栈时只能干瞪眼但脚本自己记录Err.Description之后问题就很好定位。还要关闭所有弹窗提示用SetUserPreferenceToggle把各种确认对话框关掉否则 SolidWorks 等用户点击时Agent 已经超时了。4.3 让OpenClaw执行SolidWorks任务的写法这里给一个最小可复现的示例。先在 SolidWorks 宏里建一个模块Sub CreateBoss(radius As Double, height As Double, outPath As String) Dim swApp As SldWorks.SldWorks Dim swModel As SldWorks.ModelDoc2 Dim swPart As SldWorks.PartDoc Set swApp Application.SldWorks Set swModel swApp.NewDocument(C:\ProgramData\SolidWorks\Templates\Part.prtdot, 0, 0, 0) Set swPart swModel Dim skMgr As SldWorks.SketchManager Set skMgr swModel.SketchManager swModel.SketchManager.AddToDB True skMgr.InsertSketch True skMgr.CreateCircleByRadius 0, 0, 0, radius skMgr.InsertSketch False Dim feat As SldWorks.Feature Set feat swModel.FeatureManager.FeatureExtrusion2(True, False, False, 0, 0, height, 0.01, False, False, False, False, 0, 0, False, False, False, False, True, True, True, 0, 0, False) swModel.SaveAs3 outPath, 0, 2 End Sub真实参数要看你的 SolidWorks 版本 API 签名但思路是固定的输入参数由 OpenClaw 生成脚本只做机械执行。OpenClaw 侧配置一个工具映射到命令行调用。比如用 Python 包装import subprocess def run_solidworks_macro(macro: str, radius: float, height: float, output: str): cmd [ C:/Program Files/SolidWorks Corp/SolidWorks/swmacro.exe, /m, macro, str(radius), str(height), output ] subprocess.run(cmd, timeout120, checkTrue)OpenClaw 读到任务后用 JSON 生成参数调这个函数等进程执行完读取输出日志再回复用户。超时要设置合理SolidWorks 首次启动可能要 30 秒给 120 秒比较稳。如果任务失败让 OpenClaw 先把 SolidWorks 进程杀掉再重试不然锁文件会越来越多。4.4 参数化改型和批量导出的真实示例拿“把法兰厚度改成 8mm”这个需求来说整个流程是这样的用户给 OpenClaw 发一句话Agent 解析出模型路径、目标特征名和厚度值然后调用封装好的set_flange_thickness(model_path, feature_name, thickness)脚本。脚本打开模型遍历特征树找到目标特征修改拉伸深度参数重建保存最后把输出路径写进日志。整个过程不需要你手动打开 SolidWorks 点特征树。批量导出的场景也适用。比如有一批 STEP 文件要转成 Unity 能用的 FBXAgent 逐一遍历文件路径调用导出脚本每个文件处理完都更新一下任务列表。我自己实践时发现批处理时不要用一个 SolidWorks 进程处理太多文件每处理几个文件就重启一次进程避免内存泄漏。否则跑到一半界面消失后台进程还占着资源排错非常痛苦。5. 常见问题与排查技巧实录5.1 SolidWorks崩溃、卸载残留和SQL Server问题SolidWorks 崩溃分两类建模崩溃和 API 调用崩溃。API 调用崩溃大多来自没有释放 COM 对象或者调用了不存在的接口。热词里“solidworks flenet server服务无法启动”“solidworks electrical无法连接到sql server”这两个都影响工程数据库类功能和自动脚本关系不大但如果跑装配体检查时挂掉先检查服务是否开启。Flenet Server 负责产品数据管理服务没起来会导致文件打不开而不是崩溃。卸载残留也是绕不开的坑。想重装 SolidWorks 时C 盘文件夹中的“SolidWorks Electrical”总显示“打开中”删不掉原因是 SQL Server 服务还在占用。先把名为SolidWorksSQLServer和SolidWorks Electrical的服务停掉再删除文件夹。如果还删不掉用文件句柄工具查看占用进程强制结束后再删。这个问题出现频率很高基本可以算 SolidWorks 重装流程里最扎心的一步。5.2 OpenClaw在飞书输出截断与session锁冲突热词明确提到“openclaw在飞书输出容易被截断”。数据量一大飞书会把消息截断尤其在给出代码块或日志时。我的做法是修改 Agent 的输出策略超过一定长度就调用一个工具把内容写到文件回复里只保留文件路径和一行摘要。使用方点开文件看全文既保住上下文又避免截断。session file locked 问题之前提过这里补充一个更隐蔽的场景Agent 挂起后你以为重新启动就好了实际旧进程没有退出导致新 session 拿不到锁。排查时打开任务管理器找到所有 OpenClaw 相关进程全部结束后再重启。如果通过 Hub 管理 Agent还要看 Hub 日志确认是哪个 session 被锁不用整包删。5.3 国标型材库、焊接轮廓和批量保存很多人搜“solidworks国标型材库”“solidworks焊接轮廓件大全下载”这些是建模资源问题和编程集成同样相关。因为 Agent 跑自动化设计时如果模型要用到 GB 型材你得提前把型材库配置好并把对应路径固化在脚本里。SolidWorks 的焊接轮廓默认放在设计库目录下安装后要确认路径没有中文否则 API 加载轮廓时容易报错。批量保存虚拟零部件为标准零件对应英文是“Save Bodies”操作。API 里有SaveBodyToFile方法但必须先选中 Solid Body所以脚本里需要先用特征管理器选中目标再调用保存。这个操作很常用比如从多实体零件里把每个实体拆成独立零件方便后续导入 Unity 或出 BOM 表。5.4 联动错误速查表报错场景直接原因排查顺序我用的土办法agent failed before reply: session file locked旧进程未退出session 锁被占用1. 清理 lock 文件 2. 结束 OpenClaw 进程 3. 重启服务把启动脚本写成先删锁再启动无法获得下列许可 solidworks standard许可服务未启动或授权文件被拦截1. 检查服务 2. 检查授权文件 3. 检查防火墙重启 SolidNetWork License Manager 立竿见影SolidWorks 崩溃COM 对象未释放、内存泄漏、杀毒扫描1. 查崩溃日志 2. 看任务管理器残留进程 3. 释放引用每处理几个文件重启一次 SolidWorks飞书输出截断消息超过平台长度限制1. 检查是否长代码块 2. 输出到文件回复里只放摘要和文件路径SolidWorks Electrical 无法连接 SQL ServerSQL 服务未启动或密码不对1. 启动 SQL 服务 2. 检查连接配置不用 Electrical 的可以安装时取消勾选安装项目错误 im_20260-40000-1100-100安装缓存损坏1. 清理临时文件 2. 修复安装用管理员权限跑修复最后分享一次实际经历。我第一次让 OpenClaw 自动生成带法兰的轴类零件结果脚本里单位写反输出模型比目标大了 25.4 倍整个排查花了三个小时最后发现是 API 默认单位是英寸而我用毫米传参。从那以后我在所有脚本开头都强制转换单位并把单位信息写进 Agent 的系统提示词里。这个细节如果你遇到了能直接省掉大量排查时间。下一步我还在尝试让 OpenClaw 直接调用 SolidWorks 的 Design Library按名称加载自定义特征库。这个玩法等有结果了再单独写。