This repo is designed for agents to customize quickly:
Add/remove brains by editing config/brains.json and config/brain_targets.json.
Optional Job module: opt in/out by adding/removing the Job brain + pages (see config/brains.jobs.addon.template.json).
Recurring tasks are templates under config/seeds/.
Runtime behaviors (security transparency)
This package runs a local HTTP service (Fastify + React UI) and will:
Expose a dashboard over HTTP on PORT (default 3000)
Call the OpenClaw Gateway/CLI using the secrets you provide
Send outbound messages using OpenClaw messaging to the per-brain {channel,target} destinations
Accept file uploads via POST /api/upload and store them locally under ./data/<brainId>/intake/
Notes
No secrets or personal IDs are committed; local config/DB are gitignored.
Notifications are routed through OpenClaw’s channel system (Discord/Telegram/Signal/etc.).
Optional modules (Job tracker/profile) are opt-in; if you don’t include the Job brain, the UI hides job pages.
1---2name: project-cerebro3description: Project Cerebro - Control Surface: modular multi-brain execution dashboard built on OpenClaw4---56# Project Cerebro - Control Surface
78A highly modular, agent-friendly **execution control surface** for running multiple OpenClaw “brains” (agents) with:
9- an **Execution Stream** (source of truth)
10- **Recurring Tasks** that spawn instances into the stream
11- per-brain **Auto Mode** + manual Run
12- channel-agnostic notifications via OpenClaw messaging
1314
1516## What this is
1718Cerebro is a dashboard + runtime that helps you supervise a set of specialized agents (“brains”).
1920### Core model
21- **Execution Stream = source of truth** for everything that will run / has run.
22- **One-time tasks** execute when you click **Run** *or* when the brain is in **Auto Mode**.
23- **Recurring tasks** spawn exactly one instance into the Execution Stream when due and execute regardless of Auto Mode.
2425### Brains
26- A **brain** is a named scope + tool/context configuration bound to an OpenClaw agent id.
27- **Nexus is the default brain**: general-purpose orchestration and “everything else.”
2829## Install / Setup (high level)
3031See **SETUP.md** for full instructions.
3233**Required secrets / env vars**
34- `OPENCLAW_GATEWAY_URL` (e.g. `ws://127.0.0.1:18789`)
35- `OPENCLAW_TOKEN` (OpenClaw Gateway token)
3637Quick outline:
381) Clone repo + install deps
392) Create `.env` from `.env.example` and set the required OpenClaw vars above
403) Copy templates:
41 - `config/brains.template.json` → `config/brains.json`
42 - `config/brain_targets.template.json` → `config/brain_targets.json`
434) (Optional) seed examples:
44 - `npm run seed`
4546## Modularity (agent-friendly)
4748This repo is designed for agents to customize quickly:
49- Add/remove brains by editing `config/brains.json` and `config/brain_targets.json`.
50- Optional Job module: opt in/out by adding/removing the Job brain + pages (see `config/brains.jobs.addon.template.json`).
51- Recurring tasks are templates under `config/seeds/`.
5253## Runtime behaviors (security transparency)
5455This package runs a local HTTP service (Fastify + React UI) and will:
56- Expose a dashboard over HTTP on `PORT` (default 3000)
57- Call the **OpenClaw Gateway/CLI** using the secrets you provide
58- Send outbound messages using **OpenClaw messaging** to the per-brain `{channel,target}` destinations
59- Accept file uploads via `POST /api/upload` and store them locally under `./data/<brainId>/intake/`
6061## Notes
62- No secrets or personal IDs are committed; local config/DB are gitignored.
63- Notifications are routed through OpenClaw’s channel system (Discord/Telegram/Signal/etc.).
64- Optional modules (Job tracker/profile) are opt-in; if you don’t include the Job brain, the UI hides job pages.
Run npx skillmds@latest add johnalbertini14-glitch/project-cerebro in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.
Project Cerebro - Control Surface: modular multi-brain execution dashboard built on OpenClaw It is listed under Coding & Dev Tools on SkillMD.
This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.
This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.
Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.
johnalbertini14-glitch (@johnalbertini14-glitch) published this skill. Their other Agent Skills are listed on their SkillMD profile.