Internal Engineering Docs · 2026-05-25

The Happen Ventures
systems blueprint.

One source of truth for the ClawBot worker, the 20-bot fleet, the 16 n8n cron callers, the 5 Airtable bases and the F0→F5 path from a single VPS to a resilient AWS stack. Navigate by topic — every page links back here.

20AI Bots
16Cron Callers
5Airtable Bases
23SSOT Tables
130+Integrations
Scroll · Explore
Navigate

Documentation map

Each section is a self-contained page with diagrams, tables and source references.

01 · Architecture

System topology

5-layer view: sources → ClawBot worker core → surfaces. Parallel systems (ClawBot vs Operational Tasks) and shared infra primitives.

02 · Current Flow

How tasks happen today

16 n8n cron workflows, HubSpot lists + Airtable views, ClawBot FastAPI on a single VPS, queue write to task_queue_sales.

03 · Target

Where we’re going (F5)

ECS Fargate workers, RDS Postgres, EventBridge schedules, Secrets Manager, observability. No more SPOF VPS.

04 · Integrations

External systems

Airtable SSOT, HubSpot CRM, Gmail/WhatsApp, n8n cron, QuickBooks, Make.com, Slack. Auth model + data direction per integration.

05 · Lifecycle

From trigger to approval

QUES00095 walkthrough: trigger → enrich → generate → queue → human approval → send. Status fields, robin_tasks, audit trail.

06 · Risks

What can break

VPS SPOF, 99 duplicates, status SSOT desync, guardrail gaps, secret sprawl. Severity, blast radius, mitigation.

07 · Roadmap

F0 → F5 phases

From hotfix (F0) to fully cloud-native (F5). Owner, dependencies, exit criteria for each phase.

08 · Operations

Run the system

Health Sentinel, 20-bot fleet directory, owners, runbooks, on-call rotation, escalation paths.

At a glance

Two parallel systems, one shared surface

ClawBot generates outbound work from cron schedules. Operational Tasks captures human work from event triggers. Both write to the same Airtable queue and both are reviewed by Robin.

ClawBot Pipeline

Cron-driven outbound generation

16 n8n workflows call POST /pipeline/list or /pipeline/orders on the FastAPI worker. Source: HubSpot lists or Airtable views. Output: drafted messages written to task_queue_sales for human approval.

13 /pipeline/list  ·  3 /pipeline/orders

Operational Tasks

Event-driven internal work

Inbound emails, form submissions, Slack signals route to Robin/R3, who creates tasks in robin_tasks. Status tracked separately from ClawBot but reviewed through the same approval UI.

Active Robin · Account Manager

Source of truth

The Workflows & Automations SSOT table (tbl38RfIpWTRJKyiQ) in base appUDQ65M1lSnSM5p defines all 16 playbooks, their schedules, owners, enabled status and bot bindings. If a workflow isn’t there, it doesn’t exist.