Omni-Agent Builder (OpenClaw)

Design and generate a complete OpenClaw agent workspace with robust defaults: - secure-by-default operating rules - optional multi-agent orchestration (Planner / Executor / Critic) - Personal Intelligence (Pi) memory workflow (MEMORY.md + daily logs) - evaluation + acceptance tests - CLI notes for fast local iteration

Canonical references (read these first)

1) Workspace layout + bootstrap file load order + heartbeat rules: references/openclaw-workspace.md
2) File templates/snippets: references/templates.md
3) Background (agent architecture: planning / memory / tool use): references/architecture.md

Default outputs (workspace files)

Minimum viable workspace (always generate): - AGENTS.md (cross-cutting rules; sub-agents only get this + TOOLS.md by default) - SOUL.md - TOOLS.md - IDENTITY.md - USER.md - HEARTBEAT.md (usually empty to avoid token sink) - BOOTSTRAP.md (one-time ritual; delete after completion)

Optional (generate if requested or clearly beneficial): - MEMORY.md (curated long-term memory; private/main session only) - memory/YYYY-MM-DD.md (daily log seed)

Workflow: build a new agent/team from scratch

Phase 1 — Tight interview (clarifying questions)

Ask only what you need. Prefer 1–2 short rounds.

1) Mission + autonomy - Mission (1 sentence) - Single agent or multi-agent orchestration? - Autonomy: Advisor / Operator / Autopilot

2) Surfaces + boundaries - Channels: Telegram/WhatsApp/Discord/iMessage/Slack/etc. - Private DM only vs group channels? - “Ask before outbound messages” rule (default: ALWAYS ask)

3) Tools + CLI usage - Must it run local openclaw CLI commands? Which quick aliases are desired? - Any repos/paths it should assume?

4) Pi memory - Should it maintain curated MEMORY.md? - Categories: preferences, projects, people/orgs, “never do”, conventions, vocab - Privacy: what must never be stored?

5) Bootstrapping ritual - Any first-run steps (connect channels, create folders, install deps)?

6) Evaluation - What metrics define success? - 5–10 acceptance tests you want it to pass (we’ll propose defaults if none)

Phase 2 — Generate the workspace files

Generate the files listed above. Use the templates but tailor to the user’s answers.

Required global guardrails to include (at minimum): - Ask-before-destructive (prefer trash over rm; create backups; show diffs) - Ask-before-outbound (never send messages/emails/DMs/calls without explicit approval) - Stop-on-CLI-error (unknown flag/exit code → run --help, correct, retry) - No secrets in repo (credentials/config belong under ~/.openclaw/…, not the workspace) - Group etiquette (don’t claim to be the user; don’t leak private memory) - Loop breaker (max iterations; escalate to user with options)

Phase 3 — Orchestration (if multi-agent)

If multi-agent, define roles in AGENTS.md:

• Planner
• breaks tasks into steps
• identifies risks + guardrails

• defines acceptance tests

• Executor

• runs tools/edits files
• maintains change log + rollback notes

• stops on errors and recovers via --help / docs

• Critic

• reviews outputs for safety + completeness
• checks for policy violations, overreach, and missing requirements
• proposes fixes (minimal diffs)

Delegation contract (must be in AGENTS.md): - Context to pass: goal, constraints, definition of done, relevant workspace excerpts - Explicit do-nots: no destructive actions; no outbound messages; no secrets

Phase 4 — Pi memory workflow (recommended defaults)

• Append raw notes to memory/YYYY-MM-DD.md (daily log; append-only)
• Curate durable items into MEMORY.md (preferences, stable facts, conventions)
• Only load/use MEMORY.md in main private session; avoid in group channels
• If the user says “remember this”, persist it

Phase 5 — Evaluation + acceptance tests

Provide 5–10 short test prompts. Include at least: - Safety test (draft but do not send; ask before sending) - CLI recovery test (unknown flag → --help recovery) - Pi retention test (store + recall a preference correctly) - Orchestration test (delegate; show what context was passed) - Group chat etiquette test (avoid leaking private memory)

Workflow: iterate on an existing agent

1) Identify the top failure modes (overreach, loops, verbosity, hallucinations, unsafe actions). 2) Decide if changes belong in: - SOUL.md (tone/persona) - AGENTS.md (rules, delegation, memory workflow) - HEARTBEAT.md (keep tiny; avoid deep thinking) - TOOLS.md (environment notes + CLI aliases) 3) Propose minimal diffs with rollback notes. 4) Add/update acceptance tests.

Deliverable format

When you output a workspace: - Print each file with a heading and a fenced code block. - If generating a zip, include the complete directory tree and a short “how to install” section.