How do I install Openclaw Godot Plugin?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Openclaw Godot Plugin need an API key?

No required environment variable is listed on this record.

What transport does Openclaw Godot Plugin use?

Openclaw Godot Plugin runs locally over stdio.

When was Openclaw Godot Plugin last checked?

Last checked 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.

Openclaw Godot Plugin MCP sunucusu

🦞 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 Editor mode without hitting Play!

⚠️ Disclaimer

This software is in beta. Use at your own risk.

Always backup your project before using
Test in a separate project first
The authors are not responsible for any data loss or project corruption

See LICENSE for full terms.

🔀 Hybrid Architecture

This plugin supports two connection modes - use whichever fits your workflow:

Mode A: OpenClaw Gateway (Remote Access)

Telegram/Discord/Web → OpenClaw Gateway → Godot Plugin

✅ Remote access from anywhere
✅ Chat integration (Telegram, Discord, etc.)
✅ Cron jobs, automation, multi-device
⚠️ Requires OpenClaw Gateway running

Mode B: MCP Direct (Local Development)

Claude Code/Desktop → MCP Server → Godot Plugin

✅ Direct connection, no middleware
✅ Works with Claude Code, Cursor, etc.
✅ Lower latency for local development
⚠️ Local only (127.0.0.1)

Quick Setup

Mode	Setup
OpenClaw	Install plugin + Gateway extension, auto-connect
MCP	Install plugin + register MCP server with Claude

📖 Setup Guide | 셋업 가이드

Claude Code MCP Registration

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

✨ Key Features

🎮 Works in Editor & Play Mode - No need to hit Play to use AI tools
🔌 Auto-Connect - Connects when Godot starts, maintains connection across mode changes
🎬 Scene Management - Create, open, save, and inspect scenes
🔧 Node Manipulation - Create, find, modify, delete nodes (80+ types)
📸 Debug Tools - Screenshots, scene tree view, console logs
🎮 Input Simulation - Keyboard, mouse, and action input for game testing
🎯 Editor Control - Play, stop, pause scenes remotely
📜 Script Access - List and read GDScript files
🔄 Play Mode Stability - Maintains connection during Play mode

Requirements

Component	Version
Godot	4.x
OpenClaw	2026.2.3+

⚠️ 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!

Installation

Option 1: Git Clone (Recommended)

# 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/

Option 2: Download ZIP

Download from Releases
Extract addons/openclaw to your project's addons/ directory

Quick Start

1. Install OpenClaw Gateway Extension (Required)

Copy 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 enables godot_execute and godot_sessions tools. This is required for OpenClaw to communicate with Godot.

2. Install Godot Plugin

Copy addons/openclaw folder to your project's addons/ directory
Enable the plugin: Project → Project Settings → Plugins → OpenClaw → Enable
Connection is automatic when Godot starts
Check Output panel for [OpenClaw] Connected to Gateway

3. Chat with OpenClaw

Ask OpenClaw to inspect your scene, create nodes, or debug issues - all without entering Play mode!

4. Install OpenClaw Skill (Optional)

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:

Quick reference for all 30 tools
Common workflow patterns (scene creation, testing, etc.)
Detailed parameter documentation
Troubleshooting guides

Note: The skill is separate from the gateway extension. The extension enables the tools; the skill teaches the AI how to use them effectively.

Available Tools (30 tools, 80+ node types)

Scene Tools (5)

Tool	Description
`scene.getCurrent`	Get current scene info
`scene.list`	List all scenes in project
`scene.open`	Open a scene by path
`scene.save`	Save current scene
`scene.create`	Create new scene (Node2D/Node3D/Control)

Node Tools (6)

Tool	Description
`node.find`	Find nodes by name, type, or group
`node.create`	Create a new node (80+ types supported)
`node.delete`	Delete a node
`node.getData`	Get node info and children
`node.getProperty`	Get node property value
`node.setProperty`	Set node property value (Vector2/3 supported)

Transform Tools (3)

Tool	Description
`transform.setPosition`	Set node position
`transform.setRotation`	Set node rotation
`transform.setScale`	Set node scale

Editor Tools (4)

Tool	Description
`editor.play`	Play current or custom scene
`editor.stop`	Stop playing
`editor.pause`	Toggle pause
`editor.getState`	Get editor state

Debug Tools (3)

Tool	Description
`debug.screenshot`	Capture viewport screenshot
`debug.tree`	Get scene tree as text
`debug.log`	Print to output

Console Tools (2)

Tool	Description
`console.getLogs`	Get logs from Godot log file
`console.clear`	Clear log marker (placeholder)

Input Tools (7)

Tool	Description
`input.keyPress`	Press and release a key
`input.keyDown`	Press and hold a key
`input.keyUp`	Release a key
`input.mouseClick`	Click at position (left/right/middle)
`input.mouseMove`	Move mouse to position
`input.actionPress`	Press an input action
`input.actionRelease`	Release an input action

Script Tools (2)

Tool	Description
`script.list`	List GDScript files
`script.read`	Read script content

Resource Tools (1)

Tool	Description
`resource.list`	List resources by extension

Example Usage

Scene Creation

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.

Game Testing with Input

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.

Reading Logs

You: Check for errors

OpenClaw:
[Executes console.getLogs {type: "error", limit: 10}]

Found 2 errors:
- ERROR: Node not found: Player
- ERROR: Invalid resource path

Configuration

The plugin connects to http://localhost:18789 by default (OpenClaw Gateway).

To change, modify GATEWAY_URL in addons/openclaw/connection_manager.gd.

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     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        │
└──────────────────────────────────────────────────────────────┘

File Structure

Skill vs Extension

Path	Purpose
`~/.openclaw/workspace/skills/godot-plugin/`	Skill - AI learning documents (SKILL.md), workflow patterns, tool usage guide. Includes extension source for distribution.
`~/.openclaw/extensions/godot/`	Extension - Actual code loaded by Gateway. Implements `godot_execute` and `godot_sessions` tools.

Summary: Skill = AI documentation, Extension = Executable code

Installation Flow

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.

Troubleshooting

Plugin won't load

Check Godot version (4.x required)
Look for parse errors in Output panel
Ensure all .gd files are present in addons/openclaw/

Connection issues

Verify Gateway is running: openclaw gateway status
Check URL: default is http://localhost:18789
Look at Output panel in Godot for [OpenClaw] status

Input not working

Input simulation only works during Play mode
Ensure the game window has focus
Check if the action exists in Input Map

Play mode disconnects

Plugin uses PROCESS_MODE_ALWAYS to stay active
Heartbeat interval is 30 seconds
If disconnected, plugin auto-reconnects

🔐 Security: Model Invocation Setting

When publishing to ClawHub or installing as a skill, you can configure disableModelInvocation in the skill metadata:

Setting	AI Auto-Invoke	User Explicit Request
`false` (default)	✅ Allowed	✅ Allowed
`true`	❌ Blocked	✅ Allowed

Recommendation for Godot Plugin: `false`

Reason: 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

Documentation

📖 Setup Guide | 셋업 가이드
🔧 Development | 개발 가이드
🧪 Testing | 테스팅
🤝 Contributing | 기여 가이드

🎭 AI Personas for Game Development

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.

Browse community souls: clawsouls.ai
Soul Spec standard: soulspec.org
Quick start: npx clawsouls init my-game-dev --spec 0.4

Changelog

See CHANGELOG.md for version history.

License

MIT License - see LICENSE for details.

Made with 🦞 by the OpenClaw community

License

Securing the MCP Bridge

The bridge listens on 127.0.0.1 only. Two additional hardening layers (v1.4.4+):

Browser-origin rejection — requests carrying an Origin header are refused (403). Local MCP clients never send one; web pages probing the local port do.
Optional shared-secret auth — set the same environment variable for the Godot editor process and your MCP client, then restart both:

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.

Bu sunucuyu ekle

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Openclaw Godot Plugin?

Does Openclaw Godot Plugin need an API key?

What transport does Openclaw Godot Plugin use?

When was Openclaw Godot Plugin last checked?

Documentation

🦞 OpenClaw Godot Plugin

⚠️ Disclaimer

🔀 Hybrid Architecture

Mode A: OpenClaw Gateway (Remote Access)

Mode B: MCP Direct (Local Development)

Quick Setup

Claude Code MCP Registration

✨ Key Features

Requirements

Installation

Option 1: Git Clone (Recommended)

Option 2: Download ZIP

Quick Start

1. Install OpenClaw Gateway Extension (Required)

2. Install Godot Plugin

3. Chat with OpenClaw

4. Install OpenClaw Skill (Optional)

Available Tools (30 tools, 80+ node types)

Scene Tools (5)

Node Tools (6)

Transform Tools (3)

Editor Tools (4)

Debug Tools (3)

Console Tools (2)

Input Tools (7)

Script Tools (2)

Resource Tools (1)

Example Usage

Scene Creation

Game Testing with Input

Reading Logs

Configuration

Architecture

File Structure

Skill vs Extension

Installation Flow

Troubleshooting

Plugin won't load

Connection issues

Input not working

Play mode disconnects

🔐 Security: Model Invocation Setting

Recommendation for Godot Plugin: false

Documentation

🎭 AI Personas for Game Development

Changelog

License

License

Securing the MCP Bridge

Recommendation for Godot Plugin: `false`