OpenClaw Unreal 插件

版本：1.0.0

通过 OpenClaw 控制 Unreal Engine Editor 的 MCP 技能。

连接模式

模式 A：OpenClaw 网关（远程）

插件通过 HTTP 轮询连接 OpenClaw 网关。当网关运行时自动生效。

模式 B：MCP 直连（Claude Code / Cursor）

插件在端口 27184 上运行嵌入式 HTTP 服务器。使用内置的 MCP 桥接器：

# Claude Code  
claude mcp add unreal -- node /path/to/Plugins/OpenClaw/MCP~/index.js  

# Cursor — 添加到 .cursor/mcp.json  
{"mcpServers":{"unreal":{"command":"node","args":["/path/to/Plugins/OpenClaw/MCP~/index.js"]}}}  

两种模式可同时运行。

编辑器面板

窗口 → OpenClaw Unreal 插件 — 打开一个可停靠选项卡，包含：

• 连接状态指示器
• MCP 服务器信息（地址、协议）
• 连接/断开按钮
• 工具调用和消息的实时日志

工具集

关卡操作

• level.getCurrent — 获取当前关卡名称
• level.list — 列出项目中所有关卡
• level.open — 按名称打开关卡
• level.save — 保存当前关卡

角色控制

• actor.find — 按名称/类查找角色
• actor.getAll — 列出所有角色
• actor.create — 创建角色：StaticMeshActor（立方体、球体、圆柱体、圆锥体）、点光源、摄像机
• actor.delete — 按名称删除角色
• actor.getData — 获取角色详细信息
• actor.setProperty — 通过UE反射系统设置属性

变换操作

• transform.getPosition / transform.setPosition — 获取/设置位置
• transform.getRotation / transform.setRotation — 获取/设置旋转
• transform.getScale / transform.setScale — 获取/设置缩放

变换工具要求有效的RootComponent（适用于StaticMeshActor、PointLight等，不适用于裸Actor）。

组件管理

• component.get — 获取组件数据
• component.add — 添加组件（暂未实现）
• component.remove — 移除组件（暂未实现）

编辑器控制

• editor.play — 启动PIE（使用RequestPlaySession）
• editor.stop — 停止PIE
• editor.pause / editor.resume — 暂停/恢复PIE
• editor.getState — 获取当前编辑器状态

调试工具

• debug.hierarchy — 显示角色层级树
• debug.screenshot — 捕获编辑器视口截图
• debug.log — 写入输出日志

输入模拟

• input.simulateKey — 模拟按键输入
• input.simulateMouse — 模拟鼠标输入
• input.simulateAxis — 模拟轴向输入

资源管理

• asset.list — 列出路径下的资源
• asset.import — 导入资源（暂未实现）

控制台

• console.execute — 执行控制台命令
• console.getLogs — 读取项目日志文件；参数：count（行数）、filter（文本过滤器）

蓝图系统

• blueprint.list — 列出蓝图资源
• blueprint.open — 打开蓝图（暂未实现）

故障排查

二进制文件过期/插件无法加载

清理构建缓存并重启编辑器：

rm -rf YourProject/Plugins/OpenClaw/Binaries YourProject/Plugins/OpenClaw/Intermediate

连接问题

• 确保 OpenClaw Gateway 正在运行：openclaw gateway status
• 检查 Editor Panel 日志中的错误信息
• 确认防火墙未阻止 MCP 端口