Open Source · Self-Hosted · AI Platform

Your AI Army,
One WhatsApp Away

ZeniClaw is a self-hosted AI platform with 19 specialized agents that turn your WhatsApp into an autonomous command center. Manage projects, track finances, take meeting notes, learn with flashcards — all from a single chat.

$ git clone https://gitlab.com/zenidev/zeniclaw.git
$ cd zeniclaw && bash install.sh
# Scan QR, start chatting with your AI agents
$ open http://localhost:8080
19
AI Agents
5
LLM Providers
24
Data Models
100%
Self-Hosted

Everything you need, built in

A full-stack AI platform that goes way beyond chatbots. Every feature runs on your own infrastructure, your data never leaves your server.

🤖

Autonomous Agents

19 specialized AI agents that handle tasks end-to-end: code reviews, project management, finance tracking, meeting notes, and more. Each agent has its own memory and tools.

🔀

Agentic Loop

LLM-driven decision loop with tool usage. Agents autonomously decide which tools to call, chain operations, and iterate up to 10 times to complete complex tasks.

💬

WhatsApp Native

Direct Baileys integration — no paid APIs, no middleman. Send text, images, voice messages. Full multimodal support: PDFs, photos, audio transcription.

🧠

Persistent Memory

Dual-layer memory system: daily notes for recent context and long-term facts for preferences and decisions. Your agents remember everything, across sessions.

🛠

GitLab DevOps

SubAgents clone repos, create branches, write code with Claude Code CLI, auto-commit, push, and open merge requests. Full CI/CD pipeline from a WhatsApp message.

🔒

Self-Hosted & Secure

100% on-premise. AES-256 encrypted secrets, role-based access control (superadmin/admin/operator/viewer), agent sandboxing, and full audit trail.

📊

Finance Tracker

Track expenses, manage budgets, get financial analytics and alerts. Categorize spending, set thresholds, and receive WhatsApp notifications when limits are reached.

🎵

Spotify Integration

Search tracks, get personalized recommendations, create and manage playlists, view top charts and lyrics — all through natural language in WhatsApp.

📝

Smart Meetings

Record meetings, generate transcriptions, produce structured summaries with action items. Never miss a decision or follow-up again.

🃏

Flashcards & Learning

Spaced Repetition System (SRS) for effective learning. Create decks, review cards with intelligent scheduling, track your progress over time.

Reminders & Events

Database-backed reminders that survive restarts. Recurrence rules (daily/weekly/monthly), snooze, multi-channel delivery via WhatsApp, email, and push.

🔍

Content Summarizer

Drop any URL — web pages, YouTube videos, articles — and get AI-generated summaries with customizable length. OCR for images and screenshots.

19 Specialized AI Agents

Each agent is purpose-built with its own system prompt, tool access, and isolated memory. The Router Agent automatically dispatches your messages to the right specialist.

💬

ChatAgent

General conversation & multimodal

💻

DevAgent

Code assistance & GitLab tasks

ReminderAgent

Time-based reminders & snooze

📁

ProjectAgent

Project management & stats

📈

AnalysisAgent

Data analysis & report generation

TodoAgent

Task management & priorities

🎵

MusicAgent

Spotify search & playlists

💰

FinanceAgent

Expenses, budgets & alerts

😊

MoodCheckAgent

Emotional tracking & wellness

🔍

CodeReviewAgent

Intelligent code analysis

🧠

SmartContextAgent

User behavior learning

🎙

SmartMeetingAgent

Meeting notes & transcription

🎤

VoiceCommandAgent

Audio transcription & commands

📚

FlashcardAgent

Spaced repetition learning

📅

EventReminderAgent

Calendar events & scheduling

📰

ContentSummarizerAgent

URL & content summarization

📷

ScreenshotAgent

OCR, annotation & comparison

🎮

HangmanGameAgent

Interactive word game

🔀

RouterAgent

Auto-dispatch to right agent

How it works

Four Docker containers, zero external dependencies. Everything runs on your machine.

  WhatsApp                 ZeniClaw Stack                    AI Providers

  +-----------+       +----------------------------------+       +-------------+
  |           |  QR   |  WhatsApp Gateway (port 3000)    |       |  Claude     |
  |  Phone    |<----->|  Baileys + Express               |       |  Opus/Sonnet|
  |           |       |  Auto-reconnect, webhook relay    |       |  Haiku      |
  +-----------+       +-----------|----------------------+       +-------------+
                                  | webhook POST                        ^
                                  v                                     |
                      +----------------------------------+       +-------------+
                      |  App (port 8080)                |       |  OpenAI    |
                      |  Laravel 11 + PHP 8.4            |------>|  GPT-4o     |
                      |                                  |       |  GPT-4o Mini|
                      |  RouterAgent --> 19 Agents      |       +-------------+
                      |  Agentic Loop (tool chaining)   |
                      |  SubAgents (Claude Code CLI)    |       +-------------+
                      |  Dashboard + Admin UI            |       |  GitLab    |
                      +-----------|----------------------+       |  Repos, MRs |
                                  |                              +-------------+
                      +-----------|-----------+
                      |           v           |
                +----------+  +---------+
                | Postgres |  |  Redis  |
                |  16      |  |  7      |
                |  24 models|  |  Queue  |
                |  Memory   |  |  Cache  |
                +----------+  +---------+
🐘
PHP 8.4
🏰
Laravel 11
Livewire 3
🎨
Tailwind CSS
🗃
PostgreSQL 16
🔴
Redis 7
📦
Node.js 20
🐳
Docker
📱
Baileys
🧠
Claude API

Up and running in 5 minutes

All you need is a Linux server with Docker. The install script handles everything else.

1

Prerequisites

You need a Linux server (Ubuntu 20.04+ recommended) with at least 2GB RAM and Docker installed.

# Install Docker if not present
curl -fsSL https://get.docker.com | sh
2

Clone & Install

Clone the repository and run the interactive installer.

git clone https://gitlab.com/zenidev/zeniclaw.git /opt/zeniclaw
cd /opt/zeniclaw
bash install.sh
3

Connect WhatsApp

Open http://your-server:3000 and scan the QR code with WhatsApp.

4

Access Dashboard

Log into the dashboard to configure agents, manage projects, and monitor your system.

# Default credentials
Email: admin@zeniclaw.io
Password: password
5

Start Chatting

Send a message to your linked WhatsApp number. The RouterAgent will dispatch it to the right agent.

Ready to get started?

Deploy your own AI command center in minutes. Open source, self-hosted, completely free.