Skip to content
Back to search

openclaw-unity-plugin

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.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/tomleelive--openclaw-unity-plugin/badge.svg)](/listings/tomleelive--openclaw-unity-plugin)

HTML

<a href="/listings/tomleelive--openclaw-unity-plugin"><img src="/api/listings/tomleelive--openclaw-unity-plugin/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 587 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # 🦞 OpenClaw Unity Plugin
  2. > **TL;DR:** Vibe-code your game development remotely from anywhere! 🌍
  3. >
  4. > **한줄요약:** 이제 집밖에서도 원격으로 바이브코딩으로 게임 개발 가능합니다! 🎮
  5. Connect Unity to [OpenClaw](https://github.com/openclaw/openclaw) AI assistant via HTTP. Works in **Editor mode** without hitting Play!
  6. [![Unity](https://img.shields.io/badge/Unity-2021.3+-black?logo=unity)](https://unity.com)
  7. [![OpenClaw](https://img.shields.io/badge/OpenClaw-2026.2.3+-green)](https://github.com/openclaw/openclaw)
  8. [![License](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
  9. [![Buy Me A Coffee](https://img.shields.io/badge/Buy%20Me%20A%20Coffee-support-yellow?logo=buy-me-a-coffee)](https://buymeacoffee.com/tomleelive)
  10. ## ⚠️ Disclaimer
  11. This software is in **beta**. Use at your own risk.
  12. - Always backup your project before using
  13. - Test in a separate project first
  14. - The authors are not responsible for any data loss or project corruption
  15. See [LICENSE](LICENSE) for full terms.
  16. ## 🔀 Hybrid Architecture
  17. This plugin supports **two connection modes** - use whichever fits your workflow:
  18. ### Mode A: OpenClaw Gateway (Remote Access)
  19. ```
  20. Telegram/Discord/Web → OpenClaw Gateway → Unity Plugin
  21. ```
  22. - ✅ Remote access from anywhere
  23. - ✅ Chat integration (Telegram, Discord, etc.)
  24. - ✅ Cron jobs, automation, multi-device
  25. - ⚠️ Requires OpenClaw Gateway running
  26. ### Mode B: MCP Direct (Local Development)
  27. ```
  28. Claude Code/Desktop → MCP Server → Unity Plugin
  29. ```
  30. - ✅ Direct connection, no middleware
  31. - ✅ Works with Claude Code, Cursor, etc.
  32. - ✅ Lower latency for local development
  33. - ⚠️ Local only (127.0.0.1)
  34. ### Quick Setup
  35. | Mode | Setup |
  36. |------|-------|
  37. | **OpenClaw** | Install plugin + gateway extension; the gateway's bridge token authenticates the connection |
  38. | **MCP** | Enable MCP Bridge: `Window > OpenClaw > Start MCP Bridge` — the panel shows the token file MCP clients read |
  39. ## 🔑 Bridge authentication (v1.7.0)
  40. Both local bridges are authenticated with a per-launch secret. Neither accepts an
  41. anonymous caller any more, and neither answers a browser.
  42. **Gateway bridge — this add-on is the client.** When the OpenClaw gateway loads
  43. the Unity extension it writes a random 32-byte token to
  44. `~/.openclaw/unity-bridge.token` with mode `0600`. This add-on reads it and sends
  45. it as `X-OpenClaw-Bridge-Token` on `POST /unity/register`; the gateway answers
  46. with a per-session token that every later request carries as
  47. `X-OpenClaw-Session`. Each command the gateway queues has a nonce, and this
  48. add-on echoes that nonce with the result, so no other local process can answer in
  49. its place.
  50. **MCP bridge — this add-on is the server.** When the bridge starts it generates a
  51. per-launch token and writes it to `~/.openclaw/unity-mcp-bridge.token` with mode
  52. `0600`. `MCP~/index.js` reads that file and sends it as `X-OpenClaw-Token`. Every
  53. request needs it (401 otherwise), the listener binds `127.0.0.1` only, requests
  54. carrying `Origin` or `Referer` are refused with 403, and no CORS headers are sent
  55. — before 1.7.0 it replied `Access-Control-Allow-Origin: *`, which let any open web
  56. page run Editor tools including `script.execute`.
  57. | Variable | Effect |
  58. |----------|--------|
  59. | `OPENCLAW_CONFIG_DIR` / `OPENCLAW_HOME` | Where both token files live (default `~/.openclaw`) |
  60. | `OPENCLAW_BRIDGE_TOKEN` | Use this token instead of the files, on both sides |
  61. | `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. |
  62. Tokens are never written to the Unity console — only the token file's path is.
  63. The `0600` file keeps other users out; a process running as **you** can read it,
  64. which is the same boundary that protects your SSH keys.
  65. 📖 **[Setup Guide](Documentation~/SETUP_GUIDE.md)** | **[셋업 가이드](Documentation~/SETUP_GUIDE_KO.md)**
  66. ## ✨ Key Features
  67. - 🎮 **Works in Editor & Play Mode** - No need to hit Play to use AI tools
  68. - 🔌 **Auto-Connect** - Connects when Unity starts, maintains connection across mode changes
  69. - 📋 **Console Integration** - Capture and query Unity logs for debugging
  70. - 🎬 **Scene Management** - List, load, and inspect scenes
  71. - 🔧 **Component Editing** - Add, remove, and modify component properties
  72. - 📸 **Debug Tools** - Screenshots, hierarchy view, and more
  73. - 🎯 **Input Simulation** - Keyboard, mouse, and UI interaction for game testing
  74. - 🔄 **Editor Control** - Trigger recompilation and asset refresh remotely
  75. - 🔒 **Security Controls** - Configure what operations are allowed
  76. ## Requirements
  77. | Component | Version |
  78. |-----------|---------|
  79. | **Unity** | 2021.3+ |
  80. | **OpenClaw** | 2026.2.3+ |
  81. > ⚠️ **Tested on Unity 6000.3 (Unity 6.3 LTS) only.**
  82. >
  83. > While designed for Unity 2021.3+, this plugin has only been tested on Unity 6000.3.7f1 (Unity 6.3 LTS).
  84. > If you encounter issues on other Unity versions, please:
  85. > - 🐛 [Open an Issue](https://github.com/TomLeeLive/openclaw-unity-plugin/issues) with your Unity version and error details
  86. > - 🔧 [Submit a Pull Request](https://github.com/TomLeeLive/openclaw-unity-plugin/pulls) if you have a fix
  87. >
  88. > Your contributions help make this plugin work across all Unity versions!
  89. ## Installation
  90. ### Option 1: Git URL (Recommended)
  91. 1. Open Unity Package Manager (`Window > Package Manager`)
  92. 2. Click `+` → `Add package from git URL...`
  93. 3. Enter:
  94. ```
  95. https://github.com/TomLeeLive/openclaw-unity-plugin.git
  96. ```
  97. ### Option 2: Local Package
  98. 1. Clone this repository
  99. 2. In Unity: `Window > Package Manager` → `+` → `Add package from disk...`
  100. 3. Select the `package.json` file
  101. ## Quick Start
  102. ### 1. Install OpenClaw Gateway Extension (Required)
  103. Copy the gateway extension files to OpenClaw:
  104. ```bash
  105. # Copy extension files
  106. cp -r OpenClawPlugin~/* ~/.openclaw/extensions/unity/
  107. # Restart gateway to load the extension
  108. openclaw gateway restart
  109. # Verify
  110. openclaw unity status
  111. ```
  112. > **Note:** `OpenClawPlugin~` contains the gateway extension that enables `unity_execute` and `unity_sessions` tools. This is required for OpenClaw to communicate with Unity.
  113. ### 2. Install Unity Package
  114. See [Installation](#installation) above for Git URL or local package setup.
  115. ### 3. Configure in Unity
  116. 1. Open `Window > OpenClaw Plugin`
  117. 2. Set Gateway URL: `http://localhost:18789` (default)
  118. 3. Connection is automatic when Unity starts
  119. 4. Status shows green when connected
  120. ### 4. Chat with OpenClaw
  121. Ask OpenClaw to inspect your scene, create objects, or debug issues - all without entering Play mode!
  122. ### 5. Install OpenClaw Skill (Optional)
  123. The companion skill provides workflow patterns and tool references for the AI:
  124. ```bash
  125. # Clone skill to OpenClaw workspace
  126. git clone https://github.com/TomLeeLive/openclaw-unity-skill.git ~/.openclaw/workspace/skills/unity-plugin
  127. ```
  128. The skill provides:
  129. - Quick reference for all 55 tools
  130. - Common workflow patterns (scene inspection, UI testing, etc.)
  131. - Detailed parameter documentation
  132. - Troubleshooting guides
  133. > **Note:** The skill is separate from the gateway extension. The extension enables the tools; the skill teaches the AI how to use them effectively.
  134. ## 📚 Documentation
  135. - **[Development Guide](Documentation~/DEVELOPMENT.md)** - Architecture, extending tools, and contribution guidelines
  136. - **[Testing Guide](Documentation~/TESTING.md)** - Complete testing guide with examples
  137. ## Available Tools (~100 total)
  138. ### Console (3 tools)
  139. | Tool | Description |
  140. |------|-------------|
  141. | `console.getLogs` | Get Unity console logs (with type filter) |
  142. | `console.getErrors` | Get error/exception logs (with optional warnings) |
  143. | `console.clear` | Clear captured logs |
  144. ### Scene (7 tools)
  145. | Tool | Description |
  146. |------|-------------|
  147. | `scene.list` | List all scenes in build settings |
  148. | `scene.getActive` | Get active scene info |
  149. | `scene.getData` | Get scene hierarchy data |
  150. | `scene.load` | Load a scene by name (Play mode) |
  151. | `scene.open` | Open a scene in Editor mode |
  152. | `scene.save` | Save active scene (Editor mode) |
  153. | `scene.saveAll` | Save all open scenes (Editor mode) |
  154. ### GameObject (8 tools)
  155. | Tool | Description |
  156. |------|-------------|
  157. | `gameobject.find` | Find by name, tag, or component type |
  158. | `gameobject.getAll` | Get all GameObjects with filtering |
  159. | `gameobject.create` | Create GameObject or primitive |
  160. | `gameobject.destroy` | Destroy a GameObject |
  161. | `gameobject.delete` | Delete a GameObject (alias for destroy) |
  162. | `gameobject.getData` | Get detailed object data |
  163. | `gameobject.setActive` | Enable/disable object |
  164. | `gameobject.setParent` | Change parent |
  165. ### Transform (6 tools)
  166. | Tool | Description |
  167. |------|-------------|
  168. | `transform.getPosition` | Get world position (x, y, z) |
  169. | `transform.getRotation` | Get rotation in Euler angles |
  170. | `transform.getScale` | Get local scale |
  171. | `transform.setPosition` | Set world position |
  172. | `transform.setRotation` | Set rotation (Euler) |
  173. | `transform.setScale` | Set local scale |
  174. ### Component
  175. | Tool | Description |
  176. |------|-------------|
  177. | `component.add` | Add component to object |
  178. | `component.remove` | Remove component |
  179. | `component.get` | Get component data |
  180. | `component.set` | Set field/property value |
  181. | `component.list` | List available types |
  182. ### Script (3 tools)
  183. | Tool | Description |
  184. |------|-------------|
  185. | `script.execute` | Execute code/methods (Debug.Log, Time.timeScale, PlayerPrefs, reflection calls) |
  186. | `script.read` | Read script file contents |
  187. | `script.list` | List script files in project |
  188. ### Application
  189. | Tool | Description |
  190. |------|-------------|
  191. | `app.getState` | Get play mode, FPS, etc. |
  192. | `app.play` | Enter play mode (Editor) |
  193. | `app.pause` | Toggle pause (Editor) |
  194. | `app.stop` | Exit play mode (Editor) |
  195. ### Debug
  196. | Tool | Description |
  197. |------|-------------|
  198. | `debug.log` | Write to console |
  199. | `debug.screenshot` | Capture screenshot (with UI) |
  200. | `debug.hierarchy` | Text hierarchy view |
  201. ### Editor (5 tools)
  202. | Tool | Description |
  203. |------|-------------|
  204. | `editor.refresh` | Refresh AssetDatabase (triggers recompile) |
  205. | `editor.recompile` | Request script recompilation |
  206. | `editor.domainReload` | Force domain reload (reinitializes static fields) |
  207. | `editor.focusWindow` | Focus Editor window (game/scene/console/hierarchy/project/inspector) |
  208. | `editor.listWindows` | List all open Editor windows |
  209. ### Input Simulation (NEW in v1.2.0)
  210. | Tool | Description |
  211. |------|-------------|
  212. | `input.keyPress` | Press and release a key |
  213. | `input.keyDown` | Press and hold a key |
  214. | `input.keyUp` | Release a key |
  215. | `input.type` | Type text into input field |
  216. | `input.mouseMove` | Move mouse cursor |
  217. | `input.mouseClick` | Click at position |
  218. | `input.mouseDrag` | Drag from A to B |
  219. | `input.mouseScroll` | Scroll wheel |
  220. | `input.getMousePosition` | Get current cursor position |
  221. | `input.clickUI` | Click UI element by name |
  222. > ⚠️ **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.
  223. ### Material (5 tools) - NEW in v1.5.0
  224. | Tool | Description |
  225. |------|-------------|
  226. | `material.create` | Create material with shader, color, metallic, smoothness |
  227. | `material.assign` | Assign material to GameObject |
  228. | `material.modify` | Modify material properties (color, metallic, emission, etc.) |
  229. | `material.getInfo` | Get detailed material info with all shader properties |
  230. | `material.list` | List materials in project with filtering |
  231. ### Prefab (5 tools) - NEW in v1.5.0
  232. | Tool | Description |
  233. |------|-------------|
  234. | `prefab.create` | Create prefab from scene GameObject |
  235. | `prefab.instantiate` | Instantiate prefab in scene with position |
  236. | `prefab.open` | Open prefab for editing |
  237. | `prefab.close` | Close prefab editing mode |
  238. | `prefab.save` | Save currently edited prefab |
  239. ### Asset (7 tools) - NEW in v1.5.0
  240. | Tool | Description |
  241. |------|-------------|
  242. | `asset.find` | Search assets by query, type, folder |
  243. | `asset.copy` | Copy asset to new path |
  244. | `asset.move` | Move/rename asset |
  245. | `asset.delete` | Delete asset (with trash option) |
  246. | `asset.refresh` | Refresh AssetDatabase |
  247. | `asset.import` | Import/reimport specific asset |
  248. | `asset.getPath` | Get asset path by name |
  249. ### Package Manager (4 tools) - NEW in v1.5.0
  250. | Tool | Description |
  251. |------|-------------|
  252. | `package.add` | Install package by name or git URL |
  253. | `package.remove` | Remove installed package |
  254. | `package.list` | List installed packages |
  255. | `package.search` | Search Unity package registry |
  256. ### Test Runner (3 tools) - NEW in v1.5.0
  257. | Tool | Description |
  258. |------|-------------|
  259. | `test.run` | Run EditMode/PlayMode tests with filtering |
  260. | `test.list` | List available tests |
  261. | `test.getResults` | Get last test run results |
  262. ### Batch Execution (1 tool) - NEW in v1.6.0
  263. | Tool | Description |
  264. |------|-------------|
  265. | `batch.execute` | Execute multiple tools in one call (10-100x performance) |
  266. **Example:**
  267. ```json
  268. {
  269. "commands": [
  270. { "tool": "scene.getActive", "params": {} },
  271. { "tool": "gameobject.find", "params": { "name": "Player" } },
  272. { "tool": "debug.screenshot", "params": {} }
  273. ],
  274. "stopOnError": false
  275. }
  276. ```
  277. ### Session Info (1 tool) - NEW in v1.6.0
  278. | Tool | Description |
  279. |------|-------------|
  280. | `session.getInfo` | Get session info (project, processId, machineNa) for multi-instance support |
  281. ### ScriptableObject (6 tools) - NEW in v1.6.0
  282. | Tool | Description |
  283. |------|-------------|
  284. | `scriptableobject.create` | Create new ScriptableObject asset |
  285. | `scriptableobject.load` | Load and inspect ScriptableObject fields |
  286. | `scriptableobject.save` | Save ScriptableObject changes |
  287. | `scriptableobject.getField` | Get specific field value |
  288. | `scriptableobject.setField` | Set field value with auto-save |
  289. | `scriptableobject.list` | List ScriptableObjects in project |
  290. ### Shader (3 tools) - NEW in v1.6.0
  291. | Tool | Description |
  292. |------|-------------|
  293. | `shader.list` | List shaders in project |
  294. | `shader.getInfo` | Get shader properties and info |
  295. | `shader.getKeywords` | Get shader keywords |
  296. ### Texture (5 tools) - NEW in v1.6.0
  297. | Tool | Description |
  298. |------|-------------|
  299. | `texture.create` | Create new texture with color fill |
  300. | `texture.getInfo` | Get texture info (size, format, import settings) |
  301. | `texture.setPixels` | Fill region with color |
  302. | `texture.resize` | Resize texture via import settings |
  303. | `texture.list` | List textures in project |
  304. ## Architecture
  305. ```
  306. ┌─────────────────────────────────────────────────────────────┐
  307. │ Unity Editor │
  308. │ │
  309. │ ┌────────────────────────────────────────────────────────┐ │
  310. │ │ OpenClawEditorBridge │ │
  311. │ │ [InitializeOnLoad] │ │
  312. │ │ │ │
  313. │ │ • EditorApplication.delayCall → safe init │ │
  314. │ │ • EditorApplication.update → connection polling │ │
  315. │ │ • SessionState → survives Play mode transitions │ │
  316. │ └──────────────────────┬─────────────────────────────────┘ │
  317. │ │ │
  318. │ ▼ │
  319. │ ┌────────────────────────────────────────────────────────┐ │
  320. │ │ OpenClawConnectionManager │ │
  321. │ │ (Singleton - shared across modes) │ │
  322. │ │ │ │
  323. │ │ • HTTP polling for commands │ │
  324. │ │ • Main thread execution queue │ │
  325. │ │ • Automatic reconnection │ │
  326. │ │ • JSON parsing with nested object support │ │
  327. │ └──────────────────────┬─────────────────────────────────┘ │
  328. │ │ │
  329. │ ▼ │
  330. │ ┌────────────────────────────────────────────────────────┐ │
  331. │ │ OpenClawTools (~80 tools) │ │
  332. │ │ │ │
  333. │ │ • Scene/GameObject/Component manipulation │ │
  334. │ │ • Debug tools (screenshot, hierarchy) │ │
  335. │ │ • Input simulation (keyboard, mouse, UI) │ │
  336. │ │ • Editor control (recompile, refresh) │ │
  337. │ └────────────────────────────────────────────────────────┘ │
  338. └──────────────────────────────────────────────────────────────┘
  339. │
  340. │ HTTP
  341. ▼
  342. ┌──────────────────────────────────────────────────────────────┐
  343. │ OpenClaw Gateway │
  344. │ http://localhost:18789 │
  345. │ │
  346. │ Endpoints: │
  347. │ • POST /unity/register - Register Unity session │
  348. │ • POST /unity/heartbeat - Keep session alive │
  349. │ • GET /unity/poll - Poll for commands │
  350. │ • POST /unity/result - Send tool execution results │
  351. └──────────────────────────────────────────────────────────────┘
  352. ```
  353. ## Configuration
  354. Create via `Assets > Create > OpenClaw > Config` and place in `Resources` folder.
  355. | Setting | Description | Default |
  356. |---------|-------------|---------|
  357. | `gatewayUrl` | OpenClaw gateway URL | `http://localhost:18789` |
  358. | `apiToken` | Bridge token override (normally left empty — the gateway's `~/.openclaw/unity-bridge.token` is used) | (empty) |
  359. | `autoConnect` | Connect on start | `true` |
  360. | `showStatusOverlay` | Show status in Game view | `true` |
  361. | `captureConsoleLogs` | Capture logs for AI | `true` |
  362. | `allowCodeExecution` | Allow code execution | `true` |
  363. | `allowFileAccess` | Allow file operations | `true` |
  364. | `allowSceneModification` | Allow scene changes | `true` |
  365. ## Example Usage
  366. ### Scene Inspection
  367. ```
  368. You: What GameObjects are in my scene?
  369. OpenClaw: [Executes debug.hierarchy]
  370. Your scene has:
  371. ▶ Main Camera [Camera, AudioListener]
  372. ▶ Directional Light [Light]
  373. ▶ Player [PlayerController, Rigidbody]
  374. ▶ Model [MeshRenderer]
  375. ▶ UI Canvas [Canvas, GraphicRaycaster]
  376. ▶ PlayButton [Button]
  377. ```
  378. ### Game Testing with Input Simulation
  379. ```
  380. You: Test the login flow - enter username "TestPlayer" and click Play
  381. OpenClaw:
  382. [Executes input.clickUI {name: "UsernameInput"}]
  383. [Executes input.type {text: "TestPlayer"}]
  384. [Executes input.clickUI {name: "PlayButton"}]
  385. [Executes debug.screenshot]
  386. Done! Clicked username input, typed "TestPlayer", and clicked Play button.
  387. Screenshot attached showing the result.
  388. ```
  389. ### Remote Recompilation
  390. ```
  391. You: I updated the PlayerController script, recompile Unity
  392. OpenClaw: [Executes editor.recompile]
  393. Script recompilation requested. Unity will reload shortly.
  394. ```
  395. ## Troubleshooting
  396. ### Bridge won't connect
  397. 1. Check Gateway status: `openclaw gateway status`
  398. 2. Verify URL: default is `http://localhost:18789`
  399. 3. Check `Window > OpenClaw Plugin` for errors
  400. ### Connection lost during Play mode transition
  401. - Plugin uses `SessionState` to survive domain reloads
  402. - Auto-reconnects after Play mode transition
  403. - If stuck, use `editor.refresh` or click "Force Reconnect"
  404. ### Screenshot shows wrong content
  405. - In Play mode: Uses `ScreenCapture` (includes UI)
  406. - In Editor mode: Uses `Camera.main.Render()` (no overlay UI)
  407. - Use Play mode for accurate game screenshots
  408. ### Screen Lock / Remote Access
  409. When using `debug.screenshot` remotely (via SSH, screen sharing, etc.):
  410. | Game View Mode | Screen Lock | Screenshot Works? |
  411. |----------------|-------------|-------------------|
  412. | **Play Focused** | ✅ OK | ✅ Yes |
  413. | Normal | ❌ May fail | ⚠️ Depends |
  414. **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.
  415. To enable: Click the dropdown next to "Scale" in Game View → Select "Play Focused"
  416. ### Script changes not applied after Play mode restart
  417. Unity's "Enter Play Mode Settings" can skip domain reload for faster iteration, but this prevents script recompilation.
  418. **Symptoms:**
  419. - Code changes don't take effect when re-entering Play mode
  420. - Old behavior persists despite saving scripts
  421. - `editor.refresh` or `editor.recompile` has no effect during Play mode
  422. **Solution:**
  423. 1. Go to `Edit → Project Settings → Editor`
  424. 2. Find "Enter Play Mode Settings"
  425. 3. Check ✅ **"Reload Domain"**
  426. **What this does:**
  427. | Setting | Reload Domain ON | Reload Domain OFF |
  428. |---------|------------------|-------------------|
  429. | Script changes | ✅ Applied on Play | ❌ Ignored until manual refresh |
  430. | Play mode entry | ~2-5 seconds | ~0.5 seconds |
  431. | Static variables | Reset | Preserved |
  432. | Best for | Development with active coding | Testing/playing without code changes |
  433. **Tip:** Keep "Reload Domain" ON during development. Only disable it when you need fast iteration without code changes.
  434. ## 🔐 Security: Model Invocation Setting
  435. When publishing to ClawHub or installing as a skill, you can configure `disableModelInvocation` in the skill metadata:
  436. | Setting | AI Auto-Invoke | User Explicit Request |
  437. |---------|---------------|----------------------|
  438. | `false` (default) | ✅ Allowed | ✅ Allowed |
  439. | `true` | ❌ Blocked | ✅ Allowed |
  440. ### Recommendation for Unity Plugin: **`true`**
  441. **Reason:** During Unity development, it's useful for AI to autonomously perform supporting tasks like checking scene hierarchy, taking screenshots, and inspecting GameObjects.
  442. **When to use `true`:** For sensitive tools (payments, deletions, message sending, etc.)
  443. ```yaml
  444. # Example skill metadata
  445. metadata:
  446. openclaw:
  447. disableModelInvocation: true # Recommended for Unity plugin
  448. ```
  449. ## ⚠️ Important Notes
  450. - **Development Only**: Disable `allowCodeExecution` in production builds
  451. - **TextMeshPro**: Plugin works with or without TMPro (uses reflection)
  452. - **Unity 6**: Deferred initialization prevents UPM EPIPE crashes
  453. ## 🎭 AI Personas for Game Development
  454. Want your AI agent to have a consistent personality while developing your game? [ClawSouls](https://clawsouls.ai) 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.
  455. - Browse community souls: [clawsouls.ai](https://clawsouls.ai)
  456. - Soul Spec standard: [soulspec.org](https://soulspec.org)
  457. - Quick start: `npx clawsouls init my-game-dev --spec 0.4`
  458. ## Changelog
  459. See [CHANGELOG.md](CHANGELOG.md) for version history.
  460. ## License
  461. MIT License - See [LICENSE](LICENSE)
  462. ---
  463. Made with 🦞 by the OpenClaw community
  464. ## License
  465. This project has been licensed under [Apache-2.0](LICENSE) since its initial release.
  466. Copyright 2026 Tom Lee (TomLeeLive)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.