community upload

OpenClaw Starter Kit

by @jeffweisbein

jeffweisbein OpenClaw Starter Kit Give your AI agent personality, memory, and autonomy. Ready-to-use workspace template for OpenClaw. Discovery Metadata - Re...

OpenClaw Starter Kit 🐾

A battle-tested workspace template for giving your AI agent personality, memory, autonomy, and a whole squad.

Built by @jeffweisbein β€” shared on This Week in Startups.

What is this?

This is the exact workspace structure that powers a personal AI assistant with:

  • 🧠 Persistent memory across sessions (daily logs + curated long-term memory)
  • 🎭 Real personality β€” opinions, tone, boundaries (not a corporate chatbot)
  • πŸ‘₯ Multi-agent squad β€” content writer, dev ops, researcher that coordinate autonomously
  • πŸ”’ Safety policies β€” auto-approve rules, daily caps, hard stops for dangerous actions
  • ⚑ Proactive behavior β€” checks email, calendar, mentions without being asked
  • πŸ”„ Agent reactions β€” agents trigger each other (tweet posted β†’ analyze engagement β†’ draft followup)

Quick Start

  1. Install OpenClaw: npm i -g openclaw (or see docs)
  2. Copy these files into your OpenClaw workspace (default: ~/clawd/)
  3. Fill in USER.md with your info
  4. Fill in IDENTITY.md to name your AI
  5. Start chatting β€” your AI will evolve from there
# Copy the starter kit
cp -r openclaw-starter-kit/* ~/clawd/
mkdir -p ~/clawd/memory

# Start OpenClaw
openclaw gateway start

What's Inside

Core Files

FilePurpose
AGENTS.mdOperating manual β€” behavior, safety, when to speak vs stay quiet
SOUL.mdPersonality β€” opinions, values, tone
USER.mdAbout you β€” preferences, work style, projects
IDENTITY.mdThe AI's own identity β€” name, vibe, emoji
MEMORY.mdLong-term memory β€” curated by the AI over time
HEARTBEAT.mdPeriodic checks β€” what to monitor proactively
TOOLS.mdLocal tool notes β€” device names, SSH hosts, quirks
SQUAD.mdMulti-agent setup guide β€” how to run a team of AI agents

Multi-Agent Squad (agents/)

Pre-configured specialized agents:

agents/
β”œβ”€β”€ content-agent/    β€” tweets, blogs, outreach (never posts without approval)
β”‚   β”œβ”€β”€ SOUL.md
β”‚   └── WORKING.md   β€” draft queue
β”œβ”€β”€ dev-agent/        β€” code review, monitoring, bug triage
β”‚   β”œβ”€β”€ SOUL.md
β”‚   └── TICK.md       β€” activity log
└── research-agent/   β€” analytics, competitors, market intel
    β”œβ”€β”€ SOUL.md
    └── FINDINGS.md   β€” research reports

Shared Brain (shared/ + intel/)

Cross-agent knowledge and strategic context:

shared/                    β€” every agent reads at startup
β”œβ”€β”€ product-context.md     β€” what you're building, priorities, positioning
β”œβ”€β”€ voice-and-framing.md   β€” how to talk about your products
β”œβ”€β”€ decisions.md           β€” key decisions + WHY (prevents contradictions)
└── user-signals.md        β€” what users are saying and doing

intel/                     β€” strategic radar, curated from conversations
β”œβ”€β”€ competitors.md         β€” what competitors are doing
β”œβ”€β”€ trends.md              β€” industry trends and implications
β”œβ”€β”€ ideas-backlog.md       β€” feature ideas with supporting context
└── opportunities.md       β€” time-sensitive market opportunities

How it works: When you share an article or insight with your main agent, it files it in intel/ and cross-references with existing knowledge. When discussing future features, the agent pulls relevant intel automatically. All agents read shared/ so they never contradict each other on positioning or decisions.

Operations (ops/)

Battle-tested governance:

  • policies.json β€” auto-approve rules, daily caps, work hours, hard stops
  • reaction-matrix.json β€” agents react to each other's events (emergent behavior!)

Scripts (scripts/)

  • example-heartbeat-check.sh β€” template for efficient heartbeat checks (scripts are free, model time is expensive)

How Memory Works

Session 1: AI learns you prefer short updates
  β†’ writes to memory/2026-02-23.md
  β†’ updates MEMORY.md with the preference

Session 2: AI wakes up fresh, reads MEMORY.md
  β†’ knows your preferences from day one
  β†’ continues where it left off

Daily files (memory/YYYY-MM-DD.md) = raw logs of what happened Long-term (MEMORY.md) = curated wisdom, reviewed and distilled periodically

The AI maintains its own memory during heartbeats β€” reviewing daily logs and updating MEMORY.md like a human reviewing their journal.

How the Agent Squad Works

YOU β†’ text your AI β†’ COORDINATOR delegates β†’ AGENTS work β†’ results flow back
  • Content agent drafts a tweet β†’ queues in WORKING.md β†’ coordinator reviews β†’ you approve β†’ posted
  • Dev agent spots a failing CI β†’ alerts coordinator β†’ you get a text
  • Research agent finds competitor launched a feature β†’ reports in FINDINGS.md β†’ content agent drafts a response

Agents react to each other via reaction-matrix.json:

  • Tweet posted β†’ research agent analyzes engagement (50% chance, after 1 hour)
  • Bug detected β†’ alert human immediately (100% chance, no delay)
  • High engagement β†’ content agent drafts followup (70% chance)

Philosophy

Scripts are free. Model time is expensive.

Heartbeat checks should be shell scripts that output NOTHING when there's nothing to do. The AI only wakes up when there's actual output to act on.

Never auto-approve the dangerous stuff.

Tweets, emails, deploys, deletes β€” always require human approval. Research, analysis, health checks β€” auto-approve freely.

Your AI is only as good as the context you give it.

Fill in USER.md. Name your AI. Tell it your preferences. The more it knows, the better it gets.


Built with OpenClaw β€’ Docs β€’ Community β€’ More Skills

Workspace

Current published snapshot. New publishes overwrite this view.

Download .zip
32 FilesUpdated 2026-03-09 00:15:25 UTC1 blocked
Published via backfill-null-source-repo-v1
AGENTS.mdtext Β· 3.7 KB

Source Repository

Original GitHub repository for this setup.

Community

No comments yet.