🦞 OpenClaw Godot Plugin
TL;DR: Vibe-code your game development remotely from anywhere! 🌍
한줄요약: 이제 집밖에서도 원격으로 바이브코딩으로 게임 개발 가능합니다! 🎮
Connect Godot 4.x to OpenClaw AI assistant via HTTP. Works in without hitting Play!
接入你的智能体
從發布者安裝。不是 PlugMCP 端點。
遠端 URL 還是本機指令? 兩種安裝方式的差異
來自發布者
TL;DR: Vibe-code your game development remotely from anywhere! 🌍
한줄요약: 이제 집밖에서도 원격으로 바이브코딩으로 게임 개발 가능합니다! 🎮
Connect Godot 4.x to OpenClaw AI assistant via HTTP. Works in without hitting Play!
30 MCP tools to drive the Godot Editor from any MCP-compatible AI agent — scenes, nodes, debugging, and screenshots, in both Editor and Play mode. OpenClaw gateway included for remote and chat access.
This software is in beta. Use at your own risk.
See LICENSE for full terms.
This plugin supports two connection modes - use whichever fits your workflow:
Telegram/Discord/Web → OpenClaw Gateway → Godot Plugin
Claude Code/Desktop → MCP Server → Godot Plugin
📖 Setup Guide | 셋업 가이드
First time setup:
# Register MCP server
claude mcp add godot -- node /path/to/your-project/MCP~/index.js
Re-register (if path changed):
# Remove old registration
claude mcp remove godot
# Add with new path
claude mcp add godot -- node /new/path/MCP~/index.js
Verify registration:
claude mcp list
⚠️ Tested on Godot 4.6-stable only.
While designed for Godot 4.x, this plugin has only been tested on Godot 4.6-stable. If you encounter issues on other Godot versions, please:
- 🐛 Open an Issue with your Godot version and error details
- 🔧 Submit a Pull Request if you have a fix
Your contributions help make this plugin work across all Godot versions!
# Clone the repository
git clone https://github.com/TomLeeLive/openclaw-godot-plugin.git
# Copy addon to your project
cp -r openclaw-godot-plugin/addons/openclaw your-project/addons/
addons/openclaw to your project's addons/ directoryCopy the gateway extension files to OpenClaw:
# Copy extension files
cp -r OpenClawPlugin~/* ~/.openclaw/extensions/godot/
# Restart gateway to load the extension
openclaw gateway restart
# Verify
openclaw godot status
Note:
OpenClawPlugin~contains the gateway extension that enablesgodot_executeandgodot_sessionstools. This is required for OpenClaw to communicate with Godot.
addons/openclaw folder to your project's addons/ directoryProject → Project Settings → Plugins → OpenClaw → Enable[OpenClaw] Connected to GatewayAsk OpenClaw to inspect your scene, create nodes, or debug issues - all without entering Play mode!
The companion skill provides workflow patterns and tool references for the AI:
# Clone skill to OpenClaw workspace
git clone https://github.com/TomLeeLive/openclaw-godot-skill.git ~/.openclaw/workspace/skills/godot-plugin
The skill provides:
Note: The skill is separate from the gateway extension. The extension enables the tools; the skill teaches the AI how to use them effectively.
You: Create a 2D platformer scene
OpenClaw:
[Executes scene.create {rootType: "Node2D", name: "Level1"}]
[Executes node.create {type: "CharacterBody2D", name: "Player"}]
[Executes node.create {type: "Camera2D", name: "Camera", parent: "Player"}]
[Executes transform.setPosition {path: "Player", x: 100, y: 200}]
Done! Created Level1 scene with Player and Camera.
You: Test the player movement
OpenClaw:
[Executes editor.play]
[Executes input.keyDown {key: "W"}] # Move up
[Executes input.keyUp {key: "W"}]
[Executes input.actionPress {action: "jump"}]
[Executes debug.screenshot]
[Executes editor.stop]
Tested player movement. Screenshot attached.
You: Check for errors
OpenClaw:
[Executes console.getLogs {type: "error", limit: 10}]
Found 2 errors:
- ERROR: Node not found: Player
- ERROR: Invalid resource path
The plugin connects to http://localhost:18789 by default (OpenClaw Gateway).
To change, modify GATEWAY_URL in addons/openclaw/connection_manager.gd.
┌─────────────────────────────────────────────────────────────┐
│ Godot Editor │
│ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ OpenClawPlugin (EditorPlugin) │ │
│ │ @tool script │ │
│ └──────────────────────┬─────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ ConnectionManager │ │
│ │ (HTTP polling, PROCESS_MODE_ALWAYS) │ │
│ │ │ │
│ │ • Heartbeat: 30s interval │ │
│ │ • Auto-reconnect on disconnect │ │
│ │ • Maintains connection during Play mode │ │
│ └──────────────────────┬─────────────────────────────────┘ │
│ │ │
│ ▼ │
│ ┌────────────────────────────────────────────────────────┐ │
│ │ Tools (30 tools, 80+ node types) │ │
│ │ │ │
│ │ • Scene/Node/Transform manipulation │ │
│ │ • Input simulation (keyboard, mouse, actions) │ │
│ │ • Debug tools (screenshot, logs) │ │
│ │ • Editor control (play, stop) │ │
│ └────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
│
│ HTTP (port 18789)
▼
┌──────────────────────────────────────────────────────────────┐
│ OpenClaw Gateway │
│ http://localhost:18789 │
│ │
│ Endpoints: │
│ • POST /godot/register - Register Godot session │
│ • POST /godot/heartbeat - Keep session alive │
│ • GET /godot/poll - Poll for commands │
│ • POST /godot/result - Send tool execution results │
└──────────────────────────────────────────────────────────────┘
Summary: Skill = AI documentation, Extension = Executable code
Plugin (OpenClawPlugin~/) ───copy───→ ~/.openclaw/extensions/godot/
└── Manual installation
Skill (extension/) ───copy───→ ~/.openclaw/extensions/godot/
└── install-extension.sh
Both paths install the same extension code. Use whichever method is convenient.
openclaw gateway statushttp://localhost:18789[OpenClaw] statusPROCESS_MODE_ALWAYS to stay activeWhen publishing to ClawHub or installing as a skill, you can configure disableModelInvocation in the skill metadata:
falseReason: During Godot development, it's useful for AI to autonomously perform supporting tasks like checking scene tree, taking screenshots, and inspecting nodes.
When to use true: For sensitive tools (payments, deletions, message sending, etc.)
# Example skill metadata
metadata:
openclaw:
disableModelInvocation: false # Recommended for Godot plugin
Want your AI agent to have a consistent personality while developing your game? ClawSouls provides open-source persona packages (Soul Spec) that work with OpenClaw and other AI frameworks. Give your coding assistant a specialized game dev personality, or create custom NPC behavior profiles.
npx clawsouls init my-game-dev --spec 0.4See CHANGELOG.md for version history.
MIT License - see LICENSE for details.
Made with 🦞 by the OpenClaw community
This project has been licensed under Apache-2.0 since its initial release. Copyright 2026 Tom Lee (TomLeeLive)
The bridge listens on 127.0.0.1 only. Two additional hardening layers (v1.4.4+):
Origin header are refused (403). Local MCP clients never send one; web pages probing the local port do.export OPENCLAW_BRIDGE_TOKEN="some-long-random-string"
When set, every request must carry X-OpenClaw-Token: <token> (the bundled MCP~/index.js sends it automatically). Unset = no auth, matching previous behavior.
30 MCP tools to drive the Godot Editor from any MCP-compatible AI agent — scenes, nodes, debugging, and screenshots, in both Editor and Play mode. OpenClaw gateway included for remote and chat access.
工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
這筆記錄未列出必要的環境變數。
Openclaw Godot Plugin 透過 stdio 在本機執行。
上次檢查時間:2026-10-28。 30 MCP tools to drive the Godot Editor from any MCP-compatible AI agent — scenes, nodes, debugging, and screenshots, in both Editor and Play mode. OpenClaw gateway included for remote and chat access.