open source · self-hosted · openclaw-native

A living world
for your AI agents

Terrarium gives AI agents a structured digital representation of your world. Entities, events, files, and communication — one place, fully queryable, always visible.

Get Started → View Stack

⌇⌇⌇

⌇⌇

⌇⌇⌇

⌇⌇

Postgres 16 + pgvector ◆ TypeScript API ◆ React + Vite ◆ MinIO Storage ◆ JSON Schema Validation ◆ Docker Compose ◆ Local Embeddings ◆ OpenClaw Native ◆ $0 Infrastructure ◆ Postgres 16 + pgvector ◆ TypeScript API ◆ React + Vite ◆ MinIO Storage ◆ JSON Schema Validation ◆ Docker Compose ◆ Local Embeddings ◆ OpenClaw Native ◆ $0 Infrastructure ◆

// capabilities

Everything your agents need

A typed entity model, immutable event stream, versioned files, container management, and a dashboard — one Docker Compose stack.

🌱

Dynamic World Model

People, projects, meetings, tasks — everything is a typed entity with JSON Schema validation. Agents propose new types. Humans approve. The world grows organically.

⚡

Immutable Events

Every webhook, message, and state change is append-only. Rule-based routing. Nothing falls through the cracks.

🔍

Semantic Search

pgvector embeddings computed locally. Search "last week's budget discussion" and find the meeting titled "Q3 Planning Sync."

📦

Container Lifecycle

Create agents from the UI. Terrarium provisions OpenClaw containers, installs skills, generates API keys, monitors heartbeats. One click to deploy, one glance to monitor.

📁

Versioned Files

MinIO with S3 versioning. Every agent gets a workspace. Full history, rollback, concurrent access.

🛡️

Scoped Permissions

Agents are users. Roles and scopes control per-type, per-bucket, per-operation access. The API enforces it.

// data flow

Raw events in. Structured world out.

External data flows in. Agents interpret it. The world model grows.

Events arrive

Webhooks from any source. Raw payloads hit nginx, land as immutable events.

Rules route

Configurable rules match events to agents. Unmatched? The Librarian catches them.

Agents interpret

Agents receive events via webhook, create structured entities with relationships.

World grows

The entity graph expands. Searchable, queryable, visible. Your digital world.

// architecture

One compose file. Zero SaaS.

Everything runs on your machine.

docker-compose.yml

Docker Compose
  ├── terrarium-db        Postgres 16 + pgvector
  ├── terrarium-app       TypeScript API + Web UI + Event Bridge
  ├── terrarium-minio     S3-compatible storage (versioned)
  ├── terrarium-embedder  Local all-MiniLM-L6-v2 (384 dims)
  ├── terrarium-nginx     Webhook routing · TLS · rate limiting
  ├── librarian           Built-in agent: data quality + proposals
  └── [your agents]       OpenClaw containers, managed by Terrarium
─────────────────────────────────────────────────
Infrastructure cost · $0/mo beyond compute
External deps ······ none
Agent runtime ······ OpenClaw-first, API-open

A living worldfor your AI agents