核心用法
OpenClaw Unreal Plugin 是一款将 Unreal Engine 编辑器暴露为 MCP 服务的插件,提供两种连接模式:通过 OpenClaw Gateway 的远程 HTTP 轮询(Mode A),或本地嵌入 HTTP 服务器直连 Claude Code / Cursor(Mode B)。安装后可在编辑器内打开 OpenClaw 面板监控连接状态与工具调用日志。
插件提供 10 大类共 30+ 个工具接口,覆盖关卡管理(打开/保存/切换)、Actor 全生命周期(创建/删除/查询/属性修改)、Transform 操作(位置/旋转/缩放)、组件管理、Play-in-Editor 控制(播放/暂停/停止)、调试工具(截图、层级树、日志输出)、输入模拟(键盘/鼠标/轴事件)、资产管理、控制台命令执行及蓝图浏览。所有 Actor 操作通过 UE 反射系统实现,支持运行时动态属性修改。
显著优点
- 双模式并行:Gateway 远程与本地 MCP 可同时运行,适应团队协作与个人开发不同场景
- AI 原生设计:专为 Claude Code、Cursor 等大模型工具链设计,自然语言即可驱动复杂编辑器操作
- 零侵入集成:纯插件形式,无需修改引擎源码,支持现有项目即插即用
- 实时可视化反馈:内置面板实时展示连接状态与调用日志,调试效率极高
- 完整 PIE 支持:可控制播放、暂停、单步执行,适合自动化测试与 AI 玩法验证
潜在缺点与局限性
- 组件操作未完工:
component.add/remove与asset.import、blueprint.open等标记为未实现,功能完整性受限 - Transform 依赖 RootComponent:无法操作无 RootComponent 的裸 Actor,使用时需注意 Actor 类型
- HTTP 轮询延迟:Gateway 模式为轮询架构,高频率操作可能存在延迟
- 平台绑定:仅支持 Unreal Engine 编辑器环境,无法用于运行时或独立游戏包
- 安全边界模糊:插件直接暴露编辑器底层能力(文件系统、控制台命令、输入模拟),若 MCP 客户端被恶意调用可导致任意代码执行
适合人群
- 使用 AI 辅助编程的 UE 游戏开发者与 Technical Artist
- 需要自动化关卡搭建、性能测试或回归验证的 QA 团队
- 研究 LLM 驱动游戏编辑器交互的学术与工业研究人员
常规风险
- RCE 风险:
console.execute与debug.log等工具可执行任意 Shell 命令或写入文件,MCP 客户端权限即编辑器权限 - 数据安全:
debug.screenshot可能捕获敏感画面,asset.list可遍历项目资源结构 - 稳定性风险:直接操作 Actor 属性或调用 PIE 状态切换可能导致编辑器崩溃或数据损坏,建议配合版本控制使用