核心用法
Godot Plugin Skill 是一套面向 Godot 4.x 游戏引擎的远程控制能力集，通过 OpenClaw Gateway 扩展实现编辑器级别的 API 调用。用户需先安装 extension/ 目录下的网关扩展，重启后即可使用 godot_execute 工具调用 40+ 内置功能。
功能覆盖四大工作流：场景管理（创建、打开、保存、切换）、节点操作（查找、创建、删除、属性读写）、实时调试（场景树快照、截图、日志抓取）、游戏测试（播放控制、键鼠/手柄输入模拟）。所有工具通过统一的 JSON-RPC 接口执行，参数采用 Godot 原生命名规范。
显著优点
1. 深度集成：直接操作编辑器内部状态，无需导出项目或修改源码
2. 测试自动化：支持 input.actionPress 等输入映射，可编写自动化 QA 脚本
3. 零侵入性：插件运行在编辑器进程外部，不污染项目代码
4. 向量化友好：node.setProperty 自动将字典转换为 Vector2/Vector3
5. 调试可视化：debug.tree 以文本形式输出完整场景层级，便于 LLM 理解
潜在局限
- 运行时依赖：输入模拟仅在 Play 模式下生效，无法编辑时测试
- 日志只读：
console.clear为占位实现，无法真正清理日志 - 平台绑定：需 Godot 4.x 编辑器保持运行，不支持导出后的独立游戏
- 权限风险：具备文件系统遍历（
resource.list、script.read）能力
适合人群
- 需要批量处理场景/节点配置的技术美术
- 希望自动化游戏测试流程的 QA 工程师
- 通过自然语言控制编辑器的游戏开发新手
- 构建 AI 辅助编码工作流的开发者
常规风险
- 项目意外修改：
node.delete、scene.save等操作不可逆，建议配合版本控制 - 输入干扰：模拟键鼠可能意外触发系统快捷键
- 日志敏感信息：
console.getLogs可能捕获包含用户数据或路径的报错