⚡ ClawAdmin

Industrial-grade Admin Dashboard for OpenClaw

ClawAdmin is a powerful, industrial-themed management dashboard for OpenClaw - the AI coordinator and multi-agent orchestration system. Built with a cyberpunk/industrial aesthetic, it provides complete control over your OpenClaw deployment.

---

✨ Features

🎛️ Agent Management

• Multi-Agent Control - Manage multiple AI agents from a single interface
• File Editing - Built-in Monaco Editor for SOUL.md, USER.md, MEMORY.md, TOOLS.md, AGENTS.md
• Skill Management - Enable/disable skills per agent with visual toggles
• Permission System - Granular tool permissions (fs, exec, web, browser, message, system)

🔧 System Control

• Gateway Status - Real-time monitoring of OpenClaw gateway
• Configuration - Edit openclaw.json directly from the UI
• Channel Management - Configure Telegram, Discord, and other channels
• Cron Jobs - Schedule and manage automated tasks

🎨 Industrial UI Design

• Dark Theme - Near-black interface (#0a0a0a) with industrial orange (#ff6b00) accents
• Cyberpunk Aesthetic - Cyan tech glows, grid patterns, monospace fonts
• Responsive Layout - Works on desktop and tablet devices
• Monaco Editor - Full-featured code editing with syntax highlighting

---

🚀 Quick Start

Prerequisites

• Node.js ≥ 18.0.0
• OpenClaw installed and configured
• pnpm or npm

Installation

# Clone the repository
git clone https://github.com/GrandeVx/clawAdmin.git
cd clawAdmin

# Install all dependencies
npm run install:all

# Start development servers (frontend + backend)
npm run dev

The dashboard will be available at:

• Frontend: http://localhost:3000
• Backend API: http://localhost:4000

---

📁 Project Structure

clawAdmin/
├── 📂 frontend/          # React + TypeScript + Vite + shadcn/ui
│   ├── src/
│   │   ├── components/   # UI components
│   │   ├── pages/        # Page components
│   │   ├── hooks/        # Custom React hooks
│   │   └── lib/          # Utilities
│   ├── package.json
│   └── vite.config.ts
│
├── 📂 backend/           # Hono.js API server
│   ├── src/
│   │   └── index.ts      # Main API routes
│   ├── package.json
│   └── tsconfig.json
│
├── 📄 package.json       # Root workspace config
├── 📄 README.md          # This file
└── 📄 LICENSE            # MIT License

---

🔌 API Endpoints

Gateway

Method	Endpoint	Description
GET	/api/gateway/status	Get gateway status
POST	/api/gateway/restart	Restart gateway

Agents

Method	Endpoint	Description
GET	/api/agents	List all agents
GET	/api/agents/:id/files/:filename	Read agent file
POST	/api/agents/:id/files/:filename	Save agent file
GET	/api/agents/:id/skills	Get enabled skills
POST	/api/agents/:id/skills/:skill	Toggle skill
GET	/api/agents/:id/permissions	Get tool permissions
POST	/api/agents/:id/permissions	Save tool permissions

System

Method	Endpoint	Description
GET	/api/config	Read openclaw.json
GET	/api/skills	List available skills
GET	/api/cron	List cron jobs
GET	/api/channels	List channels

---

🛠️ Tool Permissions

ClawAdmin provides granular control over what tools each agent can access:

Category	Permissions	Description
Filesystem	read, write, edit	File operations
Execution	run, spawn	Command execution
Web	search, fetch	Web search and URL fetching
Browser	navigate, snapshot, act	Browser automation
Messaging	send, react	Send messages and reactions
System	restart, update	System-level operations

---

🎨 Design System

Color Palette

Token	Value	Usage
Background	#0a0a0a	Main background
Surface	#141414	Cards, panels
Border	#2a2a2a	Borders, dividers
Primary	#ff6b00	Industrial orange (actions)
Secondary	#00d4ff	Cyan tech (status, info)
Text	#e0e0e0	Primary text
Muted	#888888	Secondary text

Typography

• Font Family: System UI + JetBrains Mono (code)
• Headings: Bold, tight letter-spacing
• Body: Regular, comfortable line-height

---

🧪 Development

Frontend

cd frontend
npm run dev        # Start dev server
npm run build      # Production build
npm run lint       # Run ESLint

Backend

cd backend
npm run dev        # Start with hot reload
npm run build      # Compile TypeScript
npm start          # Run compiled code

---

🔐 Security Notes

• The dashboard has full filesystem access to OpenClaw directories
• Designed for local/loopback access only
• Tool permissions are enforced at the dashboard level
• Always review permissions before granting sensitive access

---

🤝 Contributing

Contributions are welcome! Please read our Contributing Guide for details.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/AmazingFeature)
3. Commit your changes (git commit -m 'Add some AmazingFeature')
4. Push to the branch (git push origin feature/AmazingFeature)
5. Open a Pull Request

---

📜 License

This project is licensed under the MIT License - see the LICENSE file for details.

---

🙏 Acknowledgments

• OpenClaw - The AI coordinator this dashboard manages
• shadcn/ui - Beautiful UI components
• Hono - Ultrafast web framework
• Monaco Editor - Code editing

---

Built with ⚡ by the OpenClaw Community

GitHub • Documentation • Discord