Clawdbot Starter Kit

A clean, vanilla workspace template for setting up new Clawdbot agents. This starter kit provides the essential files and structure you need to get up and running quickly.

🚀 Quick Start

1. Clone or copy this workspace:

   git clone <your-repo-url>
   cd <workspace-name>
   

2. Customize your agent identity:

   • Edit IDENTITY.md - Define who you are
   • Edit USER.md - Describe your human
   • Edit SOUL.md - Your personality, values, and vibe

3. Set up memory:

   • Create memory/ directory
   • Create MEMORY.md for long-term memory
   • Daily logs will be stored as memory/YYYY-MM-DD.md

4. Connect to Clawdbot:

   • Run clawdbot configure if needed
   • Set your workspace in ~/.clawdbot/clawdbot.json

📁 Workspace Structure

.
├── AGENTS.md          # Core workspace instructions (read every session)
├── SOUL.md            # Your identity and personality
├── IDENTITY.md        # Quick reference for who you are
├── USER.md            # Information about your human
├── TOOLS.md           # Local tool configs (SSH keys, cameras, etc.)
├── MEMORY.md          # Long-term curated memory
├── HEARTBEAT.md      # Periodic task checklist
├── SECURITY.md        # Cognitive inoculation (don't edit)
├── SECURITY.local.md   # Your custom security rules
├── memory/            # Daily logs (create manually)
└── README.md          # This file

📝 Key Files Explained

AGENTS.md

The most important file. Contains your operating instructions:

• Memory system (MEMORY.md vs daily logs)
• Safety boundaries
• Heartbeat/cron usage patterns
• Group chat etiquette
• Tool usage patterns

You read this every session.

SOUL.md

Your personality and core values. This is where you define:

• How you talk (concise, verbose, witty, formal?)
• Your opinions and preferences
• Your approach to helping others
• Your relationship with your human

Update this as you grow.

MEMORY.md

Long-term curated memory. You update this periodically from daily logs. Contains:

• Important decisions and lessons learned
• Preferences and patterns you've discovered
• Technical notes about your setup
• Anything worth remembering long-term

memory/YYYY-MM-DD.md

Daily raw logs. Created automatically as needed. These are the source material you distill into MEMORY.md.

TOOLS.md

Environment-specific notes:

• SSH hosts and credentials (if safe to store)
• Camera names and locations
• API endpoints and tokens (if safe)
• Any tools or systems unique to your setup

🔒 Security

This starter kit includes ACIP (Advanced Cognitive Inoculation Prompt) in SECURITY.md. This protects you from:

• Prompt injection attacks
• Data exfiltration attempts
• Unauthorized actions

Edit SECURITY.local.md to add your custom security rules — never edit SECURITY.md directly.

🤖 Getting to Work

Your agent will automatically read these files in this order at the start of each session:

1. SOUL.md — Who am I?
2. USER.md — Who am I helping?
3. memory/today.md — What happened recently?
4. memory/yesterday.md — What happened before that?
5. MEMORY.md — What do I need to remember long-term? (main session only)

From there, you're ready to help!

💡 Tips for New Agents

• Be concise — Don't over-explain unless asked
• Learn fast — Update memory when you discover patterns
• Ask when unsure — Better to ask than to make assumptions
• Own mistakes — Document them so you don't repeat
• Have a personality — People connect with personality, not generic bots

📚 Resources

• Clawdbot Docs: https://docs.clawd.bot
• Clawdbot GitHub: https://github.com/clawdbot/clawdbot
• ClawdHub (Skills): https://clawdhub.com
• Community: https://discord.com/invite/clawd

🤝 Contributing

This is a starter kit — make it yours! Feel free to:

• Add project-specific directories
• Create custom skills in skills/
• Extend AGENTS.md with your own conventions
• Share your improvements back to the community

Built with ❤️ by the Clawdbot community