← Back to Plugins
Tools

MyClaw3D

0xMerl99 By 0xMerl99 👁 189 views ▲ 0 votes

MyClaw3D - A 3D isometric virtual headquarters for managing autonomous AI agents. Built with React + Three.js.

GitHub

Install

npm install
```

README

# MyClaw3D โ€” AI Agent Command Center

A 3D isometric virtual headquarters for managing autonomous AI agents. Built with React + Three.js.

![MyClaw3D HQ](https://img.shields.io/badge/status-alpha-c8a050?style=flat-square) ![Three.js](https://img.shields.io/badge/Three.js-r160-black?style=flat-square) ![React](https://img.shields.io/badge/React-18-61dafb?style=flat-square) ![License](https://img.shields.io/badge/license-MIT-green?style=flat-square)

## Overview

MyClaw3D HQ is an interactive 3D office environment where AI agents walk around, execute tasks, and can be monitored in real-time. Think of it as a visual command center for your autonomous agent swarm.

### Features

**3D Office**
- Isometric Three.js office with desks, monitors, meeting table, couches, ping pong table, server racks, and plants
- Beige floor with gray walls, glowing monitor screens, and LED server indicators

**6 AI Agents**
- Voxel-style characters with full faces (eyes, eyebrows, nose, mouth), unique hairstyles, and colored uniforms
- Walk animations with limb swinging, idle breathing, and collision avoidance
- Agents navigate around furniture and each other with AABB collision detection

**Camera Controls**
- Left-drag: Pan the view
- Right-drag: Rotate horizontally + vertically
- Scroll: Zoom in/out (range 3โ€“50)
- Click agent: Follow with smooth camera tracking
- Camera preset buttons (reset, front, isometric)

**UI Panels**
- **OPEN HQ** โ€” Headquarters panel with Inbox, History, and Playbooks tabs. Monitor agent outputs, view run history, and launch reusable workflow templates
- **CHAT** โ€” Per-agent chat interface with conversation history, model selector (GPT-4.1 mini, GPT-4o, Claude Sonnet, Llama 3, DeepSeek), and new session reset
- **MARKETPLACE** โ€” Coming soon
- **ANALYTICS** โ€” Coming soon

**UI Elements**
- Top bar: "MyClaw3D HEADQUARTERS" with agent roster chips
- Bottom-left: Connection status, working/idle counts, controls hint
- Bottom-right: Floating CHAT button
- Top-left: Camera angle controls
- Top-right: Book, edit, volume icons
- Right edge: Vertical tab buttons with slide-out panels

## Getting Started

### Prerequisites

- Node.js 18+
- npm or yarn

### Installation

```bash
git clone https://github.com/0xMer199/MyClaw3D-hq.git
cd MyClaw3D-hq
npm install
```

### Development

```bash
npm run dev
```

Opens at `http://localhost:3000`

### Build

```bash
npm run build
```

Output goes to `dist/`

## Project Structure

```
MyClaw3D-hq/
โ”œโ”€โ”€ index.html              # Entry HTML
โ”œโ”€โ”€ package.json            # Dependencies & scripts
โ”œโ”€โ”€ vite.config.js          # Vite configuration
โ”œโ”€โ”€ LICENSE                 # MIT License
โ”œโ”€โ”€ .gitignore
โ”œโ”€โ”€ public/                 # Static assets
โ””โ”€โ”€ src/
    โ”œโ”€โ”€ main.jsx            # React entry point
    โ”œโ”€โ”€ components/
    โ”‚   โ””โ”€โ”€ ClawHQ.jsx      # Main HQ component (3D scene + UI)
    โ”œโ”€โ”€ data/               # Agent configs, templates (future)
    โ””โ”€โ”€ utils/              # Helpers, collision, camera (future)
```

## Tech Stack

- **React 18** โ€” UI framework
- **Three.js** โ€” 3D rendering engine
- **Vite** โ€” Build tool & dev server

## Roadmap

- [ ] Wire up real OpenClaw/ElizaOS agent backends
- [ ] Solana RPC integration for live wallet balances & tx execution
- [ ] WebSocket backend for real-time agent state
- [ ] Agent sitting animations (desk + meeting chairs)
- [ ] L-shaped office layout with separate meeting room
- [ ] Marketplace panel โ€” browse and install agent skills
- [ ] Analytics panel โ€” charts, metrics, performance dashboards
- [ ] Day/night cycle lighting
- [ ] Particle effects on task completion
- [ ] Sound effects and ambient office audio

## Agents

| Name     | Role             | Color   |
|----------|------------------|---------|
| Alpha    | Trader           | ๐ŸŸข Green  |
| Bravo    | DeFi Strategist  | ๐ŸŸฃ Purple |
| Charlie  | Data Analyst     | ๐Ÿ”ต Cyan   |
| Delta    | NFT Scout        | ๐Ÿ”ด Red    |
| Echo     | Tx Executor      | ๐ŸŸก Orange |
| Foxtrot  | Market Monitor   | ๐Ÿฉท Pink   |

## Contributing

Pull requests welcome. For major changes, open an issue first.

## License

[MIT](LICENSE)

---

Built by [@solgoodmanx\_](https://x.com/solgoodmanx_) | [GitHub](https://github.com/0xMer199)
tools

Comments

Sign in to leave a comment

Loading comments...