openclaw-monitor

agent
Guvenlik Denetimi
Basarisiz
Health Uyari
  • No license รขโ‚ฌโ€ Repository has no license file
  • Description รขโ‚ฌโ€ Repository has a description
  • Active repo รขโ‚ฌโ€ Last push 0 days ago
  • Low visibility รขโ‚ฌโ€ Only 8 GitHub stars
Code Basarisiz
  • exec() รขโ‚ฌโ€ Shell command execution in auth.js
  • process.env รขโ‚ฌโ€ Environment variable access in auth.js
  • fs module รขโ‚ฌโ€ File system access in auth.js
  • process.env รขโ‚ฌโ€ Environment variable access in mcp-server.js
  • network request รขโ‚ฌโ€ Outbound network request in mcp-server.js
Permissions Gecti
  • Permissions รขโ‚ฌโ€ No dangerous permissions requested
Purpose
This tool provides a real-time 3D visualization dashboard to monitor AI agents and their active sessions using a browser-based Node.js server.

Security Assessment
The overall security risk is High. The most critical issue is a confirmed failure in the scan: the tool executes shell commands directly from the authentication file (`auth.js`). Combined with file system access and environment variable reading, this creates a significant risk for remote code execution or privilege escalation if exploited. Additionally, the main server file (`mcp-server.js`) makes outbound network requests. While the automated scan did not find hardcoded secrets, the presence of unbounded environment variable access means any secrets stored locally could potentially be extracted or exposed by the outbound network calls.

Quality Assessment
The project is very new and currently has low community visibility with only 8 GitHub stars, meaning it has not been broadly tested or audited by a large user base. It was recently updated, indicating active development. However, the repository is missing a proper license file despite claiming to be MIT-licensed in the documentation. This lack of a formal license creates legal ambiguity and restricts how developers can safely use, modify, or distribute the code in their own projects.

Verdict
Not recommended โ€” the execution of arbitrary shell commands within the authentication module presents a severe security risk that outweighs the benefits of this early-stage tool.
SUMMARY

๐ŸŸข Real-time 3D dashboard for OpenClaw AI agents โ€” each agent is a continent, each session is a minion. Physics, live chat, thinking bubbles.

README.md

๐ŸŸข OpenClaw Monitor 3D

Real-time 3D visualization dashboard for OpenClaw AI agents.

Watch your AI agents come alive in a vibrant 3D world โ€” each agent is a continent, each session is a cute minion walking around. Click to see live conversations, send messages, and monitor your agent army in real-time.

GitHub Stars
Three.js
Node.js
License: MIT

Demo

โœจ Why OpenClaw Monitor?

Problem Solution
"What is my agent doing right now?" ๐ŸŸก Minions with live thinking bubbles
"Which session is active?" ๐ŸŒ Each session = a minion on its continent
"I want to talk to my agent directly" ๐Ÿ’ฌ Click any minion to chat
"Agent dashboards are boring" ๐ŸŽฎ Pokemon-style 3D world with physics

๐ŸŒ 3D World

  • Agent Continents โ€” Each OpenClaw agent gets a vibrant village with houses, trees, flowers, ponds, fences, lamp posts, and benches
  • Dynamic Nature โ€” Wind-swaying grass (600+ blades), fluffy animated trees, rippling water with lily pads, floating cherry blossom petals
  • Clouds & Sky โ€” Volumetric clouds, dynamic lighting

๐ŸŸก Minions (Sessions)

  • Unique Characters โ€” Randomized height, width, color, eye count, hair style
  • Chinese Names โ€” Each minion gets a random name (ๅฐๆ˜Ž, ้˜ฟ่Šฑ, ๅคงๅฃฎ...)
  • Physics System โ€” Gravity, ground collision, drag & drop with falling
  • Smart Pathfinding โ€” Walk to points of interest (house, table, pond, bench)
  • AABB Collision โ€” No walking through walls, furniture, or other minions
  • Live Expressions โ€” Eyes change based on state (thinking, done, idle)
  • Thinking Bubbles โ€” Animated "..." + mini speech bubble showing latest tool call

๐Ÿ’ฌ Conversation Bubbles

  • Real-time Updates โ€” Live thinking process, tool calls, and replies via SSE
  • Expandable Content โ€” Thinking blocks are collapsible for long conversations
  • Two View Modes โ€” Floating bubble (default) or fixed panel (pinned to bottom)
  • Auto-scroll โ€” Smart scroll that respects user position

๐Ÿ› ๏ธ Quick Start

# Clone the repo
git clone https://github.com/ccperdst-lab/openclaw-monitor.git
cd openclaw-monitor

# Install dependencies
npm install

# Start the server
npm start

# Open in browser
open http://localhost:7777

โš™๏ธ Configuration

The monitor auto-detects your OpenClaw installation at ~/.openclaw. You can customize via config.yaml:

openclawRoot: ~/.openclaw  # Path to OpenClaw root
port: 7777                 # Server port

๐Ÿ—๏ธ Architecture

โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”     SSE      โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
โ”‚  OpenClaw       โ”‚ โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ–ถ  โ”‚  Monitor     โ”‚
โ”‚  Gateway        โ”‚              โ”‚  Server      โ”‚
โ”‚  (agents/)      โ”‚ โ—€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€  โ”‚  (Express)   โ”‚
โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜   WebSocket  โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”ฌโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
                                        โ”‚
                                   โ”Œโ”€โ”€โ”€โ”€โ–ผโ”€โ”€โ”€โ”€โ”
                                   โ”‚ Three.js โ”‚
                                   โ”‚ 3D World โ”‚
                                   โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜

๐Ÿ”ฅ Similar Projects

Project Difference
openclaw-office Isometric view, no physics
Divan Room-based, no minions
agent-monitor Pixel art style

Our edge: Full 3D world + physics + per-session minions + direct chat.

๐Ÿค Contributing

Contributions welcome! Please check Issues for what needs work.

โญ Star History

If this project helps you, please give it a star! It helps others discover it.

Star History Chart

๐Ÿ“ License

MIT

Yorumlar (0)

Sonuc bulunamadi