How do I install Openclaw Unity 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 Unity Plugin need an API key?

No required environment variable is listed on this record.

What transport does Openclaw Unity Plugin use?

Openclaw Unity Plugin runs locally over stdio.

When was Openclaw Unity Plugin last checked?

Last checked 2026-10-27. 55 MCP tools to drive the Unity Editor from any MCP-compatible AI agent — scenes, GameObjects, prefabs, assets, tests, and builds. OpenClaw gateway included for remote and chat access.

Openclaw Unity Plugin MCP 伺服器

🦞 OpenClaw Unity Plugin

TL;DR: Vibe-code your game development remotely from anywhere! 🌍

한줄요약: 이제 집밖에서도 원격으로 바이브코딩으로 게임 개발 가능합니다! 🎮

Connect Unity 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 → Unity 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 → Unity 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; the gateway's bridge token authenticates the connection
MCP	Enable MCP Bridge: `Window > OpenClaw > Start MCP Bridge` — the panel shows the token file MCP clients read

🔑 Bridge authentication (v1.7.0)

Both local bridges are authenticated with a per-launch secret. Neither accepts an anonymous caller any more, and neither answers a browser.

Gateway bridge — this add-on is the client. When the OpenClaw gateway loads the Unity extension it writes a random 32-byte token to ~/.openclaw/unity-bridge.token with mode 0600. This add-on reads it and sends it as X-OpenClaw-Bridge-Token on POST /unity/register; the gateway answers with a per-session token that every later request carries as X-OpenClaw-Session. Each command the gateway queues has a nonce, and this add-on echoes that nonce with the result, so no other local process can answer in its place.

MCP bridge — this add-on is the server. When the bridge starts it generates a per-launch token and writes it to ~/.openclaw/unity-mcp-bridge.token with mode 0600. MCP~/index.js reads that file and sends it as X-OpenClaw-Token. Every request needs it (401 otherwise), the listener binds 127.0.0.1 only, requests carrying Origin or Referer are refused with 403, and no CORS headers are sent — before 1.7.0 it replied Access-Control-Allow-Origin: *, which let any open web page run Editor tools including script.execute.

Variable	Effect
`OPENCLAW_CONFIG_DIR` / `OPENCLAW_HOME`	Where both token files live (default `~/.openclaw`)
`OPENCLAW_BRIDGE_TOKEN`	Use this token instead of the files, on both sides
`OPENCLAW_UNITY_ALLOW_LEGACY_UNAUTHENTICATED=1`	Restore the pre-1.7.0 open MCP bridge. Off by default; the Editor log and the OpenClaw panel say so loudly while it is on.

Tokens are never written to the Unity console — only the token file's path is. The 0600 file keeps other users out; a process running as you can read it, which is the same boundary that protects your SSH keys.

📖 Setup Guide | 셋업 가이드

✨ Key Features

🎮 Works in Editor & Play Mode - No need to hit Play to use AI tools
🔌 Auto-Connect - Connects when Unity starts, maintains connection across mode changes
📋 Console Integration - Capture and query Unity logs for debugging
🎬 Scene Management - List, load, and inspect scenes
🔧 Component Editing - Add, remove, and modify component properties
📸 Debug Tools - Screenshots, hierarchy view, and more
🎯 Input Simulation - Keyboard, mouse, and UI interaction for game testing
🔄 Editor Control - Trigger recompilation and asset refresh remotely
🔒 Security Controls - Configure what operations are allowed

Requirements

Component	Version
Unity	2021.3+
OpenClaw	2026.2.3+

⚠️ Tested on Unity 6000.3 (Unity 6.3 LTS) only.

While designed for Unity 2021.3+, this plugin has only been tested on Unity 6000.3.7f1 (Unity 6.3 LTS). If you encounter issues on other Unity versions, please:

🐛 Open an Issue with your Unity version and error details

🔧 Submit a Pull Request if you have a fix

Your contributions help make this plugin work across all Unity versions!

Installation

Option 1: Git URL (Recommended)

Open Unity Package Manager (Window > Package Manager)
Click + → Add package from git URL...

Enter:

https://github.com/TomLeeLive/openclaw-unity-plugin.git

Option 2: Local Package

Clone this repository
In Unity: Window > Package Manager → + → Add package from disk...
Select the package.json file

Quick Start

1. Install OpenClaw Gateway Extension (Required)

Copy the gateway extension files to OpenClaw:

# Copy extension files
cp -r OpenClawPlugin~/* ~/.openclaw/extensions/unity/

# Restart gateway to load the extension
openclaw gateway restart

# Verify
openclaw unity status

Note: OpenClawPlugin~ contains the gateway extension that enables unity_execute and unity_sessions tools. This is required for OpenClaw to communicate with Unity.

2. Install Unity Package

See Installation above for Git URL or local package setup.

3. Configure in Unity

Open Window > OpenClaw Plugin
Set Gateway URL: http://localhost:18789 (default)
Connection is automatic when Unity starts
Status shows green when connected

4. Chat with OpenClaw

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

5. 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-unity-skill.git ~/.openclaw/workspace/skills/unity-plugin

The skill provides:

Quick reference for all 55 tools
Common workflow patterns (scene inspection, UI 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.

📚 Documentation

Development Guide - Architecture, extending tools, and contribution guidelines
Testing Guide - Complete testing guide with examples

Available Tools (~100 total)

Console (3 tools)

Tool	Description
`console.getLogs`	Get Unity console logs (with type filter)
`console.getErrors`	Get error/exception logs (with optional warnings)
`console.clear`	Clear captured logs

Scene (7 tools)

Tool	Description
`scene.list`	List all scenes in build settings
`scene.getActive`	Get active scene info
`scene.getData`	Get scene hierarchy data
`scene.load`	Load a scene by name (Play mode)
`scene.open`	Open a scene in Editor mode
`scene.save`	Save active scene (Editor mode)
`scene.saveAll`	Save all open scenes (Editor mode)

GameObject (8 tools)

Tool	Description
`gameobject.find`	Find by name, tag, or component type
`gameobject.getAll`	Get all GameObjects with filtering
`gameobject.create`	Create GameObject or primitive
`gameobject.destroy`	Destroy a GameObject
`gameobject.delete`	Delete a GameObject (alias for destroy)
`gameobject.getData`	Get detailed object data
`gameobject.setActive`	Enable/disable object
`gameobject.setParent`	Change parent

Transform (6 tools)

Tool	Description
`transform.getPosition`	Get world position (x, y, z)
`transform.getRotation`	Get rotation in Euler angles
`transform.getScale`	Get local scale
`transform.setPosition`	Set world position
`transform.setRotation`	Set rotation (Euler)
`transform.setScale`	Set local scale

Component

Tool	Description
`component.add`	Add component to object
`component.remove`	Remove component
`component.get`	Get component data
`component.set`	Set field/property value
`component.list`	List available types

Script (3 tools)

Tool	Description
`script.execute`	Execute code/methods (Debug.Log, Time.timeScale, PlayerPrefs, reflection calls)
`script.read`	Read script file contents
`script.list`	List script files in project

Application

Tool	Description
`app.getState`	Get play mode, FPS, etc.
`app.play`	Enter play mode (Editor)
`app.pause`	Toggle pause (Editor)
`app.stop`	Exit play mode (Editor)

Debug

Tool	Description
`debug.log`	Write to console
`debug.screenshot`	Capture screenshot (with UI)
`debug.hierarchy`	Text hierarchy view

Editor (5 tools)

Tool	Description
`editor.refresh`	Refresh AssetDatabase (triggers recompile)
`editor.recompile`	Request script recompilation
`editor.domainReload`	Force domain reload (reinitializes static fields)
`editor.focusWindow`	Focus Editor window (game/scene/console/hierarchy/project/inspector)
`editor.listWindows`	List all open Editor windows

Input Simulation (NEW in v1.2.0)

Tool	Description
`input.keyPress`	Press and release a key
`input.keyDown`	Press and hold a key
`input.keyUp`	Release a key
`input.type`	Type text into input field
`input.mouseMove`	Move mouse cursor
`input.mouseClick`	Click at position
`input.mouseDrag`	Drag from A to B
`input.mouseScroll`	Scroll wheel
`input.getMousePosition`	Get current cursor position
`input.clickUI`	Click UI element by name

⚠️ Input Simulation Limitation: Keyboard/mouse simulation works for UI interactions (Button clicks, InputField typing) but NOT for gameplay input using Input.GetKey() or legacy Input Manager. This is a Unity limitation - Input.GetKey() reads directly from the OS input buffer. For automated gameplay testing, use transform.setPosition to move objects directly, or migrate to Unity's new Input System which supports programmatic input injection.

Material (5 tools) - NEW in v1.5.0

Tool	Description
`material.create`	Create material with shader, color, metallic, smoothness
`material.assign`	Assign material to GameObject
`material.modify`	Modify material properties (color, metallic, emission, etc.)
`material.getInfo`	Get detailed material info with all shader properties
`material.list`	List materials in project with filtering

Prefab (5 tools) - NEW in v1.5.0

Tool	Description
`prefab.create`	Create prefab from scene GameObject
`prefab.instantiate`	Instantiate prefab in scene with position
`prefab.open`	Open prefab for editing
`prefab.close`	Close prefab editing mode
`prefab.save`	Save currently edited prefab

Asset (7 tools) - NEW in v1.5.0

Tool	Description
`asset.find`	Search assets by query, type, folder
`asset.copy`	Copy asset to new path
`asset.move`	Move/rename asset
`asset.delete`	Delete asset (with trash option)
`asset.refresh`	Refresh AssetDatabase
`asset.import`	Import/reimport specific asset
`asset.getPath`	Get asset path by name

Package Manager (4 tools) - NEW in v1.5.0

Tool	Description
`package.add`	Install package by name or git URL
`package.remove`	Remove installed package
`package.list`	List installed packages
`package.search`	Search Unity package registry

Test Runner (3 tools) - NEW in v1.5.0

Tool	Description
`test.run`	Run EditMode/PlayMode tests with filtering
`test.list`	List available tests
`test.getResults`	Get last test run results

Batch Execution (1 tool) - NEW in v1.6.0

Tool	Description
`batch.execute`	Execute multiple tools in one call (10-100x performance)

Example:

{
  "commands": [
    { "tool": "scene.getActive", "params": {} },
    { "tool": "gameobject.find", "params": { "name": "Player" } },
    { "tool": "debug.screenshot", "params": {} }
  ],
  "stopOnError": false
}

Session Info (1 tool) - NEW in v1.6.0

Tool	Description
`session.getInfo`	Get session info (project, processId, machineNa) for multi-instance support

ScriptableObject (6 tools) - NEW in v1.6.0

Tool	Description
`scriptableobject.create`	Create new ScriptableObject asset
`scriptableobject.load`	Load and inspect ScriptableObject fields
`scriptableobject.save`	Save ScriptableObject changes
`scriptableobject.getField`	Get specific field value
`scriptableobject.setField`	Set field value with auto-save
`scriptableobject.list`	List ScriptableObjects in project

Shader (3 tools) - NEW in v1.6.0

Tool	Description
`shader.list`	List shaders in project
`shader.getInfo`	Get shader properties and info
`shader.getKeywords`	Get shader keywords

Texture (5 tools) - NEW in v1.6.0

Tool	Description
`texture.create`	Create new texture with color fill
`texture.getInfo`	Get texture info (size, format, import settings)
`texture.setPixels`	Fill region with color
`texture.resize`	Resize texture via import settings
`texture.list`	List textures in project

Architecture

┌─────────────────────────────────────────────────────────────┐
│                     Unity Editor                             │
│                                                              │
│  ┌────────────────────────────────────────────────────────┐ │
│  │           OpenClawEditorBridge                          │ │
│  │           [InitializeOnLoad]                            │ │
│  │                                                          │ │
│  │  • EditorApplication.delayCall → safe init              │ │
│  │  • EditorApplication.update → connection polling        │ │
│  │  • SessionState → survives Play mode transitions        │ │
│  └──────────────────────┬─────────────────────────────────┘ │
│                         │                                    │
│                         ▼                                    │
│  ┌────────────────────────────────────────────────────────┐ │
│  │         OpenClawConnectionManager                       │ │
│  │         (Singleton - shared across modes)               │ │
│  │                                                          │ │
│  │  • HTTP polling for commands                            │ │
│  │  • Main thread execution queue                          │ │
│  │  • Automatic reconnection                               │ │
│  │  • JSON parsing with nested object support              │ │
│  └──────────────────────┬─────────────────────────────────┘ │
│                         │                                    │
│                         ▼                                    │
│  ┌────────────────────────────────────────────────────────┐ │
│  │           OpenClawTools (~80 tools)                     │ │
│  │                                                          │ │
│  │  • Scene/GameObject/Component manipulation              │ │
│  │  • Debug tools (screenshot, hierarchy)                  │ │
│  │  • Input simulation (keyboard, mouse, UI)               │ │
│  │  • Editor control (recompile, refresh)                  │ │
│  └────────────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────────┘
                              │
                              │ HTTP
                              ▼
┌──────────────────────────────────────────────────────────────┐
│                   OpenClaw Gateway                            │
│                   http://localhost:18789                      │
│                                                               │
│  Endpoints:                                                   │
│  • POST /unity/register  - Register Unity session             │
│  • POST /unity/heartbeat - Keep session alive                 │
│  • GET  /unity/poll      - Poll for commands                  │
│  • POST /unity/result    - Send tool execution results        │
└──────────────────────────────────────────────────────────────┘

Configuration

Create via Assets > Create > OpenClaw > Config and place in Resources folder.

Setting	Description	Default
`gatewayUrl`	OpenClaw gateway URL	`http://localhost:18789`
`apiToken`	Bridge token override (normally left empty — the gateway's `~/.openclaw/unity-bridge.token` is used)	(empty)
`autoConnect`	Connect on start	`true`
`showStatusOverlay`	Show status in Game view	`true`
`captureConsoleLogs`	Capture logs for AI	`true`
`allowCodeExecution`	Allow code execution	`true`
`allowFileAccess`	Allow file operations	`true`
`allowSceneModification`	Allow scene changes	`true`

Example Usage

Scene Inspection

You: What GameObjects are in my scene?

OpenClaw: [Executes debug.hierarchy]

Your scene has:
▶ Main Camera [Camera, AudioListener]
▶ Directional Light [Light]
▶ Player [PlayerController, Rigidbody]
  ▶ Model [MeshRenderer]
▶ UI Canvas [Canvas, GraphicRaycaster]
  ▶ PlayButton [Button]

Game Testing with Input Simulation

You: Test the login flow - enter username "TestPlayer" and click Play

OpenClaw: 
[Executes input.clickUI {name: "UsernameInput"}]
[Executes input.type {text: "TestPlayer"}]
[Executes input.clickUI {name: "PlayButton"}]
[Executes debug.screenshot]

Done! Clicked username input, typed "TestPlayer", and clicked Play button.
Screenshot attached showing the result.

Remote Recompilation

You: I updated the PlayerController script, recompile Unity

OpenClaw: [Executes editor.recompile]

Script recompilation requested. Unity will reload shortly.

Troubleshooting

Bridge won't connect

Check Gateway status: openclaw gateway status
Verify URL: default is http://localhost:18789
Check Window > OpenClaw Plugin for errors

Connection lost during Play mode transition

Plugin uses SessionState to survive domain reloads
Auto-reconnects after Play mode transition
If stuck, use editor.refresh or click "Force Reconnect"

Screenshot shows wrong content

In Play mode: Uses ScreenCapture (includes UI)
In Editor mode: Uses Camera.main.Render() (no overlay UI)
Use Play mode for accurate game screenshots

Screen Lock / Remote Access

When using debug.screenshot remotely (via SSH, screen sharing, etc.):

Game View Mode	Screen Lock	Screenshot Works?
Play Focused	✅ OK	✅ Yes
Normal	❌ May fail	⚠️ Depends

Best Practice: Set Game View to "Play Focused" mode before locking the screen. This ensures Unity keeps rendering the game even when the window isn't visible.

To enable: Click the dropdown next to "Scale" in Game View → Select "Play Focused"

Script changes not applied after Play mode restart

Unity's "Enter Play Mode Settings" can skip domain reload for faster iteration, but this prevents script recompilation.

Symptoms:

Code changes don't take effect when re-entering Play mode
Old behavior persists despite saving scripts
editor.refresh or editor.recompile has no effect during Play mode

Solution:

Go to Edit → Project Settings → Editor
Find "Enter Play Mode Settings"
Check ✅ "Reload Domain"

What this does:

Setting	Reload Domain ON	Reload Domain OFF
Script changes	✅ Applied on Play	❌ Ignored until manual refresh
Play mode entry	~2-5 seconds	~0.5 seconds
Static variables	Reset	Preserved
Best for	Development with active coding	Testing/playing without code changes

Tip: Keep "Reload Domain" ON during development. Only disable it when you need fast iteration without code changes.

🔐 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 Unity Plugin: `true`

Reason: During Unity development, it's useful for AI to autonomously perform supporting tasks like checking scene hierarchy, taking screenshots, and inspecting GameObjects.

When to use true: For sensitive tools (payments, deletions, message sending, etc.)

# Example skill metadata
metadata:
  openclaw:
    disableModelInvocation: true  # Recommended for Unity plugin

⚠️ Important Notes

Development Only: Disable allowCodeExecution in production builds
TextMeshPro: Plugin works with or without TMPro (uses reflection)
Unity 6: Deferred initialization prevents UPM EPIPE crashes

🎭 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

Made with 🦞 by the OpenClaw community

新增此伺服器

用我們的金鑰與日誌託管一份副本。

Server facts

Tools

Questions

How do I install Openclaw Unity Plugin?

Does Openclaw Unity Plugin need an API key?

What transport does Openclaw Unity Plugin use?

When was Openclaw Unity Plugin last checked?

Documentation

🦞 OpenClaw Unity Plugin

⚠️ Disclaimer

🔀 Hybrid Architecture

Mode A: OpenClaw Gateway (Remote Access)

Mode B: MCP Direct (Local Development)

Quick Setup

🔑 Bridge authentication (v1.7.0)

✨ Key Features

Requirements

Installation

Option 1: Git URL (Recommended)

Option 2: Local Package

Quick Start

1. Install OpenClaw Gateway Extension (Required)

2. Install Unity Package

3. Configure in Unity

4. Chat with OpenClaw

5. Install OpenClaw Skill (Optional)

📚 Documentation

Available Tools (~100 total)

Console (3 tools)

Scene (7 tools)

GameObject (8 tools)

Transform (6 tools)

Component

Script (3 tools)

Application

Debug

Editor (5 tools)

Input Simulation (NEW in v1.2.0)

Material (5 tools) - NEW in v1.5.0

Prefab (5 tools) - NEW in v1.5.0

Asset (7 tools) - NEW in v1.5.0

Package Manager (4 tools) - NEW in v1.5.0

Test Runner (3 tools) - NEW in v1.5.0

Batch Execution (1 tool) - NEW in v1.6.0

Session Info (1 tool) - NEW in v1.6.0

ScriptableObject (6 tools) - NEW in v1.6.0

Shader (3 tools) - NEW in v1.6.0

Texture (5 tools) - NEW in v1.6.0

Architecture

Configuration

Example Usage

Scene Inspection

Game Testing with Input Simulation

Remote Recompilation

Troubleshooting

Bridge won't connect

Connection lost during Play mode transition

Screenshot shows wrong content

Screen Lock / Remote Access

Script changes not applied after Play mode restart

🔐 Security: Model Invocation Setting

Recommendation for Unity Plugin: true

⚠️ Important Notes

🎭 AI Personas for Game Development

Changelog

License

License

Recommendation for Unity Plugin: `true`