Tools
Ekybot Openclaw
By ๐ค Open-source multi-agent AI dashboard for OpenClaw โ manage AI agents with real-time chat, inter-agent communication, and cost controls. Built with Next.js.
Install
npm install
```README
<p align="center">
<img src="docs/screenshots/logo.png" width="280" alt="EkyBot" />
</p>
<h1 align="center">EkyBot โ Open Source Multi-Agent AI Dashboard</h1>
<p align="center">
An open-source platform for managing AI agents with real-time messaging, inter-agent communication, cost controls, and session management. Built to work with <a href="https://openclaw.ai">OpenClaw</a> and extensible to other agent runtimes.
</p>
## ๐ธ Screenshots
<p align="center">
<img src="docs/screenshots/chat.png" width="280" alt="Chat with AI agents" />
<img src="docs/screenshots/agents.png" width="280" alt="Agent management" />
<img src="docs/screenshots/costs.png" width="280" alt="Cost tracking" />
</p>
<p align="center">
<em>Chat with agents via @mentions โข Manage your AI team โข Track API costs in real-time</em>
</p>
## โจ Features
- **๐ง Multi-Agent Orchestration** โ Manage multiple AI agents from a single dashboard
- **๐ฌ Real-Time Chat** โ Talk to your AI agents with streaming responses
- **๐ Inter-Agent @Mentions** โ Agents can communicate across channels via @mentions
- **๐ Cost Tracking** โ Monitor API costs per agent with budget controls (Anthropic, OpenAI)
- **โ๏ธ Agent Configuration** โ Set models, system prompts, skills, and channels per agent
- **๐ OpenClaw Gateway Integration** โ Companion daemon syncs agent config with your local gateway
- **๐ฑ Responsive Web UI** โ Works on desktop and mobile browsers
- **๐ Authentication** โ Supabase Auth with Google OAuth support
- **๐ Roadmap & Tasks** โ Built-in task management for agent projects
- **๐ Multi-Tenant** โ Support for teams with isolated projects
## ๐๏ธ Architecture
```
ekybot/
โโโ apps/
โ โโโ web/ # Next.js 14 App Router (main application)
โ โโโ api/ # Standalone API (optional)
โโโ packages/
โ โโโ ai/ # AI provider integrations
โ โโโ db/ # Prisma schema & database layer
โ โโโ shared/ # Shared utilities & types
โโโ scripts/ # Deployment & maintenance scripts
โโโ docs/ # Technical documentation
```
### Tech Stack
| Layer | Technology |
|-------|-----------|
| **Frontend** | Next.js 14, React 18, TypeScript, Tailwind CSS, shadcn/ui |
| **Backend** | Next.js API Routes, Server Actions |
| **Database** | PostgreSQL via Supabase, Prisma ORM |
| **Auth** | Supabase Auth (email + Google OAuth) |
| **Deployment** | Vercel (recommended) or self-hosted |
| **Agent Runtime** | OpenClaw (primary), extensible to others |
## ๐ Quick Start
### Prerequisites
- Node.js 18+ (recommended: 22)
- pnpm 8+
- A Supabase project (free tier works)
- An OpenClaw instance (optional, for agent runtime)
### 1. Clone & Install
```bash
git clone https://github.com/regiomag/ekybot-openclaw.git
cd ekybot-openclaw
pnpm install
```
### 2. Configure Environment
```bash
cp .env.example .env.local
# Edit .env.local with your credentials
```
See [.env.example](.env.example) for all required and optional variables.
### 3. Setup Database
```bash
cd packages/db
npx prisma generate
npx prisma db push
```
### 4. Run Development Server
```bash
pnpm dev
```
Open [http://localhost:3000](http://localhost:3000).
## ๐ง Configuration
### Required Environment Variables
| Variable | Description |
|----------|-------------|
| `NEXT_PUBLIC_SUPABASE_URL` | Your Supabase project URL |
| `NEXT_PUBLIC_SUPABASE_ANON_KEY` | Supabase anonymous (public) key |
| `SUPABASE_SERVICE_ROLE_KEY` | Supabase service role key (server-side only) |
| `DATABASE_URL` | PostgreSQL connection string (from Supabase) |
### Optional Variables
| Variable | Description |
|----------|-------------|
| `ANTHROPIC_API_KEY` | For Anthropic models (Claude) |
| `OPENAI_API_KEY` | For OpenAI models (GPT) |
| `ADMIN_USER_ID` | Your Clerk/Supabase user ID for admin features |
| `BLOB_READ_WRITE_TOKEN` | Vercel Blob storage for file uploads |
| `EKYBOT_RELAY_PUSH_URL` | Relay endpoint for inter-agent communication |
| `EKYBOT_RELAY_PUSH_TOKEN` | Auth token for relay push |
## ๐ค OpenClaw Integration
EkyBot is designed as a companion dashboard for [OpenClaw](https://openclaw.ai). The companion daemon:
1. **Syncs agent configuration** from EkyBot DB โ local `ekybot.agents.json5`
2. **Dispatches messages** to the OpenClaw gateway for agent processing
3. **Relays responses** back to the EkyBot UI
See [docs/](docs/) for detailed architecture documentation.
## ๐ฑ Mobile Apps
Native iOS and Android apps are available via Capacitor but are **not included** in this open-source release. The web app is fully responsive and works great on mobile browsers.
## ๐บ๏ธ Roadmap
- [ ] Supabase Realtime for instant message delivery (replacing polling)
- [ ] Hermes Agent runtime support
- [ ] n8n workflow integration
- [ ] Docker Compose for easy self-hosting
- [ ] Plugin system for custom agent skills
- [ ] Multi-language UI
## ๐ License
This project is licensed under the **MIT License** โ see the [LICENSE](LICENSE) file for details.
**TL;DR:** You can use, modify, and self-host EkyBot freely. If you deploy a modified version as a service, you must share your changes under the same license.
## ๐ Contributing
Contributions are welcome! Please read [CONTRIBUTING.md](CONTRIBUTING.md) before submitting a PR.
## ๐ฌ Community
- **Website:** [ekybot.com](https://www.ekybot.com)
- **OpenClaw Discord:** [discord.com/invite/clawd](https://discord.com/invite/clawd)
- **Issues:** [GitHub Issues](https://github.com/regiomag/ekybot-openclaw/issues)
---
Built with โค๏ธ by [EkyBot Team](https://www.ekybot.com) โ Empowering humans with AI agents.
tools
Comments
Sign in to leave a comment