核心用法
OpenClaw Unreal Skill 是一套面向 Unreal Engine 5 的 AI 辅助开发工具链，通过 HTTP 长轮询机制实现 OpenClaw Gateway 与 Unreal Editor 的双向通信。用户安装配套 C++ 插件后，即可在对话中直接指挥 AI 完成场景搭建、Actor 操控、关卡编辑、蓝图管理等任务。
典型工作流程：
1. 在 Unreal 项目中启用 OpenClaw 插件并确认连接状态
2. 通过自然语言指令让 AI 执行具体任务（如"创建光源""移动玩家起点""开始游戏测试"）
3. AI 自动调用对应工具（actor.create、transform.setPosition、editor.play 等）完成操作
4. 实时获取截图、层级结构、日志等反馈信息
显著优点
- 全流程覆盖：从关卡创建、Actor 生成、Transform 调整到 PIE 运行控制，完整覆盖关卡设计核心环节
- 组件级精细操控：支持获取/添加/删除组件，可直接修改具体属性值
- 实时调试能力：截图、日志获取、层级查看等功能让 AI 具备"视觉"理解场景状态
- 输入模拟：支持键盘、鼠标、手柄轴输入模拟，可用于自动化测试或演示脚本
- 蓝图集成：可直接列出并打开项目中的 Blueprint 资源
- 灵活配置：支持项目级或全局级 JSON 配置，便于团队协作
潜在缺点与局限性
- 架构耦合：依赖 OpenClaw Gateway 持续运行，且采用 HTTP 轮询而非 WebSocket，高频操作场景下存在延迟
- 版本锁定：仅支持 Unreal 5.x，需维护 C++ 插件与 Skill 的版本同步
- 安全性考量：默认启用 AI 自动调用（
disableModelInvocation: false），Actor 删除、控制台命令等操作存在误触风险 - 命名敏感：Actor 查找区分大小写，中文命名或特殊字符支持未明确说明
- 网络依赖：本地开发仍需保持 Gateway 服务，无法纯离线使用
适合人群
- 技术美术（TA）：快速验证场景布局、灯光布置效果
- 关卡设计师：通过自然语言快速原型搭建，减少重复拖拽操作
- 独立开发者：单人团队需要高效率工具链整合
- 自动化测试工程师：利用输入模拟和状态检测编写 Editor 内自动化脚本
- 教学演示场景：讲师可通过语音指令实时操控引擎展示
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 误操作删除 | AI 错误执行 `actor.destroy` 或 `console.execute` | 关键项目启用版本控制；敏感操作设为需用户确认 |
| 场景污染 | 大量自动化生成 Actor 导致关卡混乱 | 定期使用 `level.save` 创建快照；在副本关卡测试 |
| 性能影响 | 高频轮询+截图在大场景下造成卡顿 | 适当降低截图频率；关闭不必要的 `debug.hierarchy` 调用 |
| 插件兼容性 | 与特定 UE5 版本或第三方插件冲突 | 在干净项目先行测试；关注 GitHub Issues 更新 |
| 网络安全 | Gateway 默认监听 0.0.0.0:18789，局域网暴露 | 配置防火墙规则；生产环境限制为 127.0.0.1 |
综合评估
该 Skill 代表了一种颇具前瞻性的"自然语言驱动引擎工作流"尝试，将传统需要多步菜单操作的开发任务压缩为单轮对话。对于熟悉 Unreal 术语的用户，效率提升显著；但对引擎初学者，建议先理解底层概念再使用，避免"黑箱操作"导致的认知断层。整体而言，这是专业向、高效率的辅助开发工具，适合已具备 UE 基础的技术人员作为加速器使用。