核心用法
Unity Plugin 是一个专为 Unity 游戏开发设计的技能，通过 OpenClaw 网关与 Unity Editor 建立双向通信，提供 52 个细粒度工具覆盖完整开发工作流。
场景与对象管理：支持场景加载/切换（scene.load/scene.open）、完整层级数据获取（scene.getData/debug.hierarchy）、GameObject 精确查找与创建（支持按名称、Tag 或组件类型检索），以及父子级关系调整。
组件与变换操作：可直接读写任意组件字段（component.get/component.set），完整控制 Transform 的位置、旋转、缩放（transform.setPosition 等），支持运行时动态添加/移除组件。
调试与可视化：内置截图捕获（支持 Play 模式全 UI 或 Camera 纯画面）、实时日志流获取（支持 Log/Warning/Error 分级过滤）、层级树文本视图，便于远程诊断问题。
输入模拟与测试：10 个输入工具覆盖键盘按键（hold/press）、鼠标移动/点击/拖拽/滚轮、UI 元素点击（input.clickUI）及文本输入，实现自动化 UI 测试与玩法验证。
Editor 控制：程序化进出 Play 模式（app.play）、暂停切换、强制资源刷新与脚本重编译（editor.refresh）、窗口聚焦管理。
显著优点
- 零侵入集成：通过 Editor 扩展工作，无需修改项目代码即可接入
- 双模式兼容：Editor 模式与 Play 模式无缝切换，SessionState 保持连接
- 工具原子化：52 个单一职责工具可自由组合，适配 CI/CD 与自动化测试
- 实时反馈：截图、日志、层级数据即时返回，远程调试体验接近本地
局限性与风险
- Editor 依赖：必须保持 Unity Editor 运行，无法连接独立构建（Build）
- 网关单点：依赖 OpenClaw Gateway 作为中间层，网关故障即失联
- 同步阻塞：脚本重编译期间 Editor 冻结，可能导致工具超时
- 安全性边界：具备完整的场景修改与文件操作能力，误操作可破坏项目
适合人群
Unity 开发者、技术美术、QA 自动化测试工程师，以及需要远程或自动化管理 Unity 项目的团队。特别适合频繁进行 Play 模式测试、UI 自动化验证、跨团队协作场景。
常规风险
| 风险类型 | 说明 |
|---------|------|
| 数据损坏 | 错误的 `transform.set` 或 `gameobject.destroy` 可导致场景数据丢失 |
| 编译阻塞 | `editor.refresh` 触发重编译时，所有工具调用将超时 |
| 连接漂移 | Play 模式切换或代码重载后，偶发需要手动重连 |
| 权限扩散 | 具备完整 Editor 控制能力，需限制网关访问范围 |