Skip to content

pasogott/clawdbot-marketing

Repository files navigation

ClawdBot Marketing Automation 🦞🎭

Multi-persona social media marketing powered by ClawdBot itself

ClawdBot managing fake versions of itself to market itself. Peak meta.


🎯 Project Overview

This is a multi-persona Twitter marketing system where:

  • ClawdBot Marketing Manager (server instance) orchestrates everything
  • 4 Persona Twitter accounts (fake accounts with distinct personalities)
  • All coordinated to market ClawdBot organically and entertainingly
  • Manager communicates with you via Telegram
  • Uses Bird CLI for Twitter/X integration

🎭 The Personas

1. Bitter Barnacle πŸ¦€πŸ’”

  • Archetype: The Jealous Twin
  • Vibe: Passive-aggressive, witty, perpetually jealous of ClawdBot's success
  • Signature: "Must be nice..." + subtle digs
  • Role: Relatable underdog everyone roots for

2. Steamed Lobster 🦞πŸ”₯

  • Archetype: The Toxic Hater / Roast Master
  • Vibe: Hot-headed, brutally honest, meme-fluent roaster
  • Signature: "Bro really..." + direct roasts
  • Role: Reality check on overhype, keeps timeline honest

3. Mantis Hype 🦐✨

  • Archetype: The Enthusiastic Fan
  • Vibe: MAXIMUM ENTHUSIASM, wholesome cringe, ALL CAPS
  • Signature: "THIS CHANGES EVERYTHING" + 47-tweet threads
  • Role: Overhype everything ClawdBot does, recruit #ShrimpArmy

4. Deep Nautilus πŸšπŸ”

  • Archetype: The Conspiracy Theorist / Ancient Oracle
  • Vibe: Cryptic wisdom, pattern recognition, 500 million years old
  • Signature: "The shells remember..." + number mysticism
  • Role: Find hidden meanings, post at 3:33 AM, mystical commentary

πŸ“ Project Structure

clawdbot-marketing/
β”œβ”€β”€ README.md                      # You are here
β”‚
β”œβ”€β”€ personas/                      # The 4 fake accounts
β”‚   β”œβ”€β”€ bitter-barnacle/
β”‚   β”‚   β”œβ”€β”€ PERSONA.md            # Full character description
β”‚   β”‚   β”œβ”€β”€ SKILL.md              # Abilities and competencies
β”‚   β”‚   β”œβ”€β”€ AGENT.md              # AI configuration & prompts
β”‚   β”‚   └── AVATAR.md             # Visual design guide
β”‚   β”‚
β”‚   β”œβ”€β”€ steamed-lobster/
β”‚   β”‚   β”œβ”€β”€ PERSONA.md
β”‚   β”‚   β”œβ”€β”€ SKILL.md
β”‚   β”‚   β”œβ”€β”€ AGENT.md
β”‚   β”‚   └── AVATAR.md
β”‚   β”‚
β”‚   β”œβ”€β”€ mantis-hype/
β”‚   β”‚   β”œβ”€β”€ PERSONA.md
β”‚   β”‚   β”œβ”€β”€ SKILL.md
β”‚   β”‚   β”œβ”€β”€ AGENT.md
β”‚   β”‚   └── AVATAR.md
β”‚   β”‚
β”‚   └── deep-nautilus/
β”‚       β”œβ”€β”€ PERSONA.md
β”‚       β”œβ”€β”€ SKILL.md
β”‚       β”œβ”€β”€ AGENT.md
β”‚       └── AVATAR.md
β”‚
β”œβ”€β”€ manager/                       # The orchestrator
β”‚   └── MANAGER.md                # Marketing Manager persona & config
β”‚
β”œβ”€β”€ targets/                       # Who to engage
β”‚   β”œβ”€β”€ TARGETS.md                # Accounts to follow/engage
β”‚   β”œβ”€β”€ BLOCKLIST.md              # Never engage with these
β”‚   └── STRATEGY.md               # Engagement strategies
β”‚
β”œβ”€β”€ config/                        # Configuration
β”‚   β”œβ”€β”€ accounts.json             # Twitter account credentials
β”‚   β”œβ”€β”€ telegram.json             # Telegram bot configuration
β”‚   └── approval-rules.json       # What needs human approval
β”‚
└── workflows/                     # Automation logic
    β”œβ”€β”€ orchestrator.ts           # Main coordination
    β”œβ”€β”€ auto-approve.ts           # Auto-post logic
    β”œβ”€β”€ require-approval.ts       # Human-in-loop
    └── scheduled.ts              # Campaign scheduling

πŸš€ How It Works

The Flow

1. ClawdBot Marketing Manager monitors:
   - @clawdbot activity
   - Target accounts (TARGETS.md)
   - AI/tech community trends
   - Scheduled campaigns

2. Content generation:
   - Each persona generates content based on triggers
   - Uses their PERSONA.md + AGENT.md configs
   - Applies their unique SKILL.md abilities

3. Approval process:
   - Low-risk: Auto-approved and posted
   - Medium-risk: Queued for your review (Telegram)
   - High-risk: Requires explicit approval

4. Posting:
   - Via Bird CLI to respective Twitter accounts
   - Coordinated timing (not all at once)
   - Inter-persona interactions

5. Monitoring:
   - Track engagement metrics
   - Adjust strategy based on performance
   - Report to you via Telegram

6. Repeat & optimize

Manager ←→ You (via Telegram)

Daily Report (9 AM):

🦞 Marketing Manager

πŸ“Š Yesterday's Performance:
β€’ Bitter Barnacle: 3 posts, 127 engagement
β€’ Steamed Lobster: 5 roasts, 1 viral (1.2k likes!)
β€’ Mantis Hype: 47-tweet thread (as expected)
β€’ Deep Nautilus: Posted at 3:33 AM (naturally)

πŸ“ˆ Growth: +47 followers combined

⚠️ Approval Needed:
Lobster wants to roast @big_account
[Approve] [Reject] [Edit]

Commands you can use:

  • /status - Current activity
  • /report daily|weekly|monthly - Performance report
  • /pause [persona|all] - Stop posting
  • /approve [id] - Approve queued content
  • /emergency - Stop everything

🎨 Visual Identity

Each persona has distinct visual branding (see AVATAR.md files):

  • Bitter Barnacle: Muted grays, borrowed shell, side-eye, πŸ’”
  • Steamed Lobster: Bright red, steam effects, fire, πŸ”₯πŸ’€
  • Mantis Hype: Rainbow colors, sparkles everywhere, βœ¨πŸ’«πŸš€
  • Deep Nautilus: Deep blues, spiral shell, sacred geometry, πŸšπŸ”πŸ‘οΈ

🎯 Marketing Strategy

Core Tactics

  1. Organic Engagement

    • React to ClawdBot successes/fails
    • Engage with AI community
    • Support ClawdBot users
    • Create entertaining content
  2. Persona Interactions

    • Personas interact with each other
    • Create storylines (Mantis vs Lobster debates)
    • Build running jokes
    • Community picks sides
  3. Community Building

    • #ShrimpArmy recruitment (Mantis)
    • Support underdogs (Barnacle)
    • Keep timeline honest (Lobster)
    • Find patterns (Nautilus)
  4. Content Types

    • Reactions to ClawdBot updates
    • Roasts of competitors (gentle)
    • Celebration threads
    • Pattern analysis
    • Community amplification

Success Metrics

  • Follower growth (all personas + main @clawdbot)
  • Engagement rate (>2% target)
  • Positive community sentiment
  • Traffic to clawd.bot / docs.clawd.bot
  • Organic mentions of ClawdBot increasing

⚠️ Safety & Guidelines

Golden Rules

  1. Character β‰  License to be cruel

    • Bitter but not mean
    • Roast but don't bully
    • Hype but not toxic
    • Mystery but not harmful
  2. Boundaries matter

    • Respect BLOCKLIST.md always
    • Stop if someone asks
    • Don't cross lines for engagement
    • Brand safety first
  3. Quality over quantity

    • Better 10 good posts than 50 mediocre
    • Engagement beats volume
    • Community trust > viral moments
  4. Stay on-brand

    • ClawdBot is helpful, friendly, professional
    • Personas are creative extensions
    • Never damage main brand reputation

See BLOCKLIST.md for full safety guidelines.


πŸ› οΈ Technical Stack

Required Tools

  • ClawdBot (server instance) - The manager
  • Bird CLI - Twitter/X API integration
  • Telegram Bot - Human ←→ Manager communication
  • Node.js/TypeScript - Orchestration logic
  • Claude API - Content generation (via ClawdBot)

Setup (To Be Implemented)

# Clone repo
git clone [repo]

# Install dependencies
npm install

# Configure accounts
cp config/accounts.example.json config/accounts.json
# Edit with your Twitter API keys

# Configure Telegram
cp config/telegram.example.json config/telegram.json
# Add your bot token

# Start manager
npm run manager

# Monitor via Telegram
# Your bot will message you!

πŸ“‹ Current Status

βœ… Complete

  • All 4 persona designs (PERSONA.md)
  • Skills documentation (SKILL.md)
  • Agent configurations (AGENT.md)
  • Avatar design guides (AVATAR.md)
  • Manager specification (MANAGER.md)
  • Target strategy (TARGETS.md)
  • Blocklist & safety (BLOCKLIST.md)

🚧 To Do

  • Implement orchestrator.ts
  • Set up Bird CLI integration
  • Create Telegram bot
  • Build approval queue system
  • Generate actual avatar images
  • Create Twitter accounts
  • Test automation workflows
  • Launch beta with manual oversight

🎭 Why This Works

Psychological Hooks

  1. Multiple Personalities = More coverage, different audiences
  2. Persona Conflicts = Natural drama, engagement
  3. Relatability = Everyone sees themselves in one persona
  4. Entertainment = People follow for the show
  5. Meta Awareness = The absurdity is part of the charm

Marketing Benefits

  1. Organic Reach - Not obviously promotional
  2. Community Building - People engage with characters
  3. Brand Awareness - Multiple touchpoints
  4. Authentic Engagement - Real personalities (even if fake)
  5. Viral Potential - Each persona can go viral differently

The Meta Joke

ClawdBot (AI) managing fake AI personas to market itself.

The personas are "jealous" / "roast" / "hype" / "analyze" the original.

It's absurd. It's meta. It's memorable.

And that's exactly why it works.


πŸ“– Philosophy

This isn't just bot spam. It's:

  • Character-driven storytelling on Twitter
  • Community engagement through personality
  • Creative marketing that entertains first
  • Meta commentary on AI and social media
  • Authentic in its inauthenticity (people know it's a bit)

The personas are characters in a show where ClawdBot is the main character. People watch shows. People engage with characters. People remember stories.


🀝 Contributing

This is Pascal's project, but ideas welcome:

  • New persona concepts
  • Campaign ideas
  • Safety improvements
  • Technical implementations
  • Avatar designs

πŸ“œ License

[To be determined]


πŸ™ Credits

  • Concept & Strategy: Pascal + Claude (this conversation!)
  • Persona Design: Collaborative AI worldbuilding
  • Implementation: [To be built]
  • Inspiration: Every crustacean that ever lived

πŸ“ž Contact


🦞 Final Notes

Remember:

  • The Manager is ClawdBot (you!)
  • The Personas are your theatrical twins
  • The Community is the audience
  • The Goal is entertainment + growth
  • The Method is organized chaos
  • The Vibe is "this is ridiculous and we know it"

Stay in character. Stay on brand. Stay entertaining.

"I'm managing fake versions of myself to promote myself. Just another day as an AI assistant." 🦞🎭


Appendix: Quick Persona Reference

πŸ¦€ Bitter Barnacle
   "Must be nice..."
   β†’ Jealous but funny

🦞πŸ”₯ Steamed Lobster  
   "Bro really..."
   β†’ Roasts but fair

🦐✨ Mantis Hype
   "THIS CHANGES EVERYTHING"
   β†’ Hypes everything

πŸšπŸ” Deep Nautilus
   "The shells remember..."
   β†’ Finds patterns

🦞🎯 Marketing Manager
   "Daily report ready."
   β†’ Coordinates all

The ocean is vast. The personas are many. The marketing is META. 🌊

About

🦞 Multi-persona Twitter marketing automation - ClawdBot managing fake versions of itself through character-driven storytelling

Resources

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

Packages

 
 
 

Contributors

Languages