Skip to main content
MeepaGateway
MeepaGateway is the brain and soul of your bot. You give it a personality, connect it to an AI model (like Claude or GPT), and it handles everything else — thinking, responding, remembering context. It’s also a bridge. One bot can live in Discord, Slack, MeepaChat, Telegram, and WhatsApp — all at the same time, from a single config file. You define who your bot is, MeepaGateway figures out how to run it everywhere.

​
Supported platforms

PlatformConnection method
MeepaChatWebSocket
DiscordWebSocket (gateway)
TelegramPolling or webhook
SlackSocket Mode
WhatsAppWebhook (Meta Cloud API)

​
Key features

Multi-agent — Run any number of agents from a single gateway instance. Each agent has its own config, soul, skills, memory, and connectors. Soul system — An agent’s personality and behavior are defined in a SOUL.md file in its workspace. Edit it to change how the agent thinks and responds. Skills — Agents load skill definition files from their skills/ directory. Skills extend what the agent can do with structured task patterns. Users can also request skills be installed dynamically during a conversation — the agent will pull from the skill catalog and load it on the fly. Memory — Agents store facts in a SQLite database (memory.db) that persists across restarts. The store compacts automatically when it grows large. MCP (Model Context Protocol) — Connect agents to MCP servers for additional tools. Configured per-agent via .mcp.json. Container Mode — Agent tool calls run inside an OCI container for filesystem isolation. The image is built from a configurable package list. Cron — Schedule agents to run on an interval or cron expression. Useful for periodic tasks, digests, and autonomous workflows. Captain Dashboard — Built-in web UI for managing agents, config, skills, connectors, MCP, and cron. Runs at http://localhost:63372 by default. Provider routing — Configure multiple LLM providers (Anthropic, OpenAI, or any OpenAI-compatible endpoint) with automatic failover.

​
Pro tips

Dynamic skill installation — Users can ask an agent to install a skill mid-conversation. Just say “install the code-runner skill” and the agent will pull it from the catalog, load it, and start using it immediately. No restart needed.
Soul editing — Change an agent’s personality on the fly by editing its SOUL.md. The agent picks up changes on the next message — no restart required.
Multi-platform, single agent — One agent can connect to MeepaChat, Discord, Telegram, Slack, and WhatsApp simultaneously. Add connectors in agent.yaml or through the Captain Dashboard.

​
How it works

Each incoming message triggers an agent loop:
  1. The connector receives a message from the chat platform
  2. The agent reads its soul, memory, and skills
  3. The agent calls the LLM, executes tools as needed, and loops until done
  4. The response is sent back through the connector
Agent workspace layout: 
~/.meepagateway/
  config.yaml                # Global configuration
  agents/{id}/
    agent.yaml               # Per-agent config overrides
    SOUL.md                  # Personality and instructions
    MEMORY.md                # Long-term notes
    USER.md                  # User profile
    memory.db                # SQLite fact store
    skills/                  # Skill definition files
    .mcp.json                # MCP server configuration
    AGENTS.md                # Auto-generated capabilities reference
  keys/{id}/
    secrets.yaml             # SOPS-encrypted secrets
    private-key.key          # Age private key