核心用法
Unity Plugin Skill 是一套面向 Unity 游戏开发的 MCP（Model Context Protocol）技能，通过 OpenClaw Unity Plugin 与 Unity Editor 建立双向通信，提供 52+ 个精细化的工具接口。开发者可在 AI 辅助下完成场景层级检视、GameObject 与 Component 的增删改查、Transform 属性调整、脚本执行、输入模拟、Play 模式控制及调试截图等任务。
安装流程需执行 ./scripts/install-extension.sh 将扩展文件复制至 ~/.openclaw/extensions/unity/，重启 Gateway 后即可使用 unity_execute 工具调用各类命令。工具按功能划分为 Console、Scene、GameObject、Transform、Component、Script、Application、Debug、Editor、Input Simulation 十大类别，覆盖从编辑器脚本到运行时测试的完整工作流。
典型场景包括：使用 debug.hierarchy 快速浏览场景结构，gameobject.find 定位目标对象，transform.setPosition 调整位置，input.clickUI 模拟用户点击，以及 app.play 控制 Play 模式进出。截图功能支持 Play 模式的 ScreenCapture 与 Editor 模式的 Camera.main.Render() 两种模式，便于对比 UI 呈现效果。
显著优点
- 功能全面：52+ 工具覆盖 Unity 开发的常见需求，从场景管理到输入模拟一应俱全
- 双模式支持：无缝切换 Editor 与 Play 模式，插件通过 SessionState 保持连接
- 安全设计：
disableModelInvocation: true确保 AI 不会自动执行工具，需用户显式授权 - 输入模拟完备：10 个输入工具支持键盘、鼠标、UI 点击、拖拽、滚轮等完整交互链
- 调试友好：实时日志获取、层级可视化、截图对比，提升调试效率
潜在缺点与局限性
- 安装门槛：需手动执行脚本安装扩展并重启 Gateway，首次配置较为繁琐
- 连接稳定性：Play 模式切换或长时间运行后可能出现连接中断，需手动重连
- 脚本更新延迟：Unity 不会自动重编译代码变更，需显式调用
editor.refresh - 超时风险：工具调用可能因 Unity 响应缓慢而超时，需开发者自行排查
- 平台限制：依赖 OpenClaw Gateway 与 Unity Editor 本地运行，暂不支持远程或云编辑器
适合人群
- Unity 开发者：寻求 AI 辅助编码、场景调试、自动化测试的程序员
- 技术美术（TA）：需要快速调整场景对象、验证视觉效果、批量截图对比
- QA 测试工程师：利用输入模拟进行回归测试、UI 自动化验证
- 独立游戏开发者：单人团队需高效工具链加速迭代
常规风险
- 误操作风险：虽设有手动触发保护，但用户仍需注意 Play 模式下的对象修改可能影响运行状态
- 数据一致性：强制重编译或刷新可能导致未保存的脚本更改丢失
- 扩展冲突：与其他 Unity Editor 扩展共存时可能出现工具响应异常
- 权限问题：扩展安装涉及文件系统写入，需确保脚本执行权限正确