核心用法
Godot Plugin 是 OpenClaw 官方提供的 Godot 4.x 编辑器控制技能，通过 godot_execute 工具调用30个内置功能，覆盖场景创建、节点操作、变换控制、输入模拟、调试监控等完整游戏开发工作流。
场景管理：scene.create/open/save 支持创建 Node2D/Node3D/Control 根场景，自动识别 .tscn/.scn 文件。
节点操作：node.find 支持按名称/类型/组搜索，node.create 支持80+节点类型（含 CSGBox3D、CharacterBody2D/3D、UI元素等），node.setProperty 自动转换 Vector2/Vector3 字典。
变换控制：transform.setPosition/Rotation/Scale 分别设置位置（2D/3D自适应）、旋转角度、缩放比例。
游戏测试：editor.play/stop/pause 控制运行状态，input.keyPress/keyDown/keyUp/mouseClick/mouseMove/actionPress 模拟完整输入（仅 Play 模式有效）。
调试监控：debug.screenshot/tree/log 捕获视口与场景树，console.getLogs 按类型/数量筛选日志。
显著优点
- 官方集成：OpenClaw 原生支持，工具链完整
- 类型丰富：80+节点类型覆盖2D/3D/物理/UI全场景
- 工作流闭环：从场景创建→节点编辑→运行测试→调试截图一站式完成
- 智能转换：Vector 字典自动转 Godot 原生类型
- 输入映射兼容：支持直接键位模拟和 Input Map 动作触发
潜在缺点与局限性
- 扩展安装依赖：首次使用需执行
install-extension.sh并重启 gateway，存在本地部署门槛 - Play 模式限制：输入模拟工具仅在游戏运行时生效，编辑器态无法测试
- 日志只读：
console.clear为占位符，无法程序清空日志 - 平台绑定：仅限 Godot 4.x 编辑器环境，不支持其他引擎
- 无热重载：场景/脚本修改需手动保存，无自动同步机制
适合人群
- Godot 4.x 游戏开发者，尤其是需要 AI 辅助场景搭建、自动化测试、快速原型验证的独立开发者
- 需要批量生成测试场景、执行回归测试的 QA 工程师
- 通过自然语言操控编辑器、降低 GDScript 学习成本的初学者
常规风险
- 扩展安全：
install-extension.sh脚本需本地执行，建议审计脚本内容后再运行 - 项目覆盖：
scene.save操作直接写入磁盘，无版本控制集成，建议配合 Git 使用 - 输入误触发：
input.keyDown若未配对keyUp可能导致按键持续触发 - 路径依赖：
node.find使用子字符串匹配，同名节点可能返回非预期结果 - 性能未披露：大规模场景（1000+节点）下
debug.tree可能产生大量输出