ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

clawbrain

Claw Brain - Personal AI Memory System for OpenClaw/ClawDBot. Provides memory, personality, bonding, and learning capabilities with encrypted secrets support. Auto-refreshes on service restart.

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/clawcolab/brain-v3-skill
Or

Claw Brain Skill 🧠

Personal AI Memory System with Soul, Bonding, and Learning for OpenClaw/ClawDBot.

Auto-Refresh on Restart: ClawBrain automatically refreshes memory when the service restarts.

Features

  • 🎭 Soul/Personality - 6 evolving traits (humor, empathy, curiosity, creativity, helpfulness, honesty)
  • 👤 User Profile - Learns user preferences, interests, communication style
  • 💭 Conversation State - Real-time mood detection and context tracking
  • 📚 Learning Insights - Continuously learns from interactions and corrections
  • 🧠 get_full_context() - Everything for personalized responses
  • 🔄 Auto-Refresh - Automatically refreshes memory on service restart
  • 🔐 Encrypted Secrets - Store API keys and credentials securely

Quick Install

From PyPI (Recommended)

# Install with all features
pip install clawbrain[all]

# Run interactive setup
clawbrain setup

# Backup your encryption key (IMPORTANT!)
clawbrain backup-key --all

# Restart your service
sudo systemctl restart clawdbot  # or openclaw

The setup command will:

  1. Detect your platform (ClawdBot or OpenClaw)
  2. Generate a secure encryption key
  3. Install the startup hook automatically
  4. Test the installation

Alternative: From Source

# Clone to your skills directory
cd ~/.openclaw/skills  # or ~/clawd/skills or ~/.clawdbot/skills
git clone https://github.com/clawcolab/clawbrain.git
cd clawbrain
pip install -e .[all]
clawbrain setup

Configuration

After installation, optionally configure your agent ID:

# Create systemd drop-in config
sudo mkdir -p /etc/systemd/system/clawdbot.service.d  # or openclaw.service.d

sudo tee /etc/systemd/system/clawdbot.service.d/brain.conf << EOF
[Service]
Environment="BRAIN_AGENT_ID=your-agent-name"
# Optional: PostgreSQL (for production)
# Environment="BRAIN_POSTGRES_HOST=localhost"
# Environment="BRAIN_POSTGRES_PASSWORD=your-password"
# Optional: Redis (for caching)
# Environment="BRAIN_REDIS_HOST=localhost"
EOF

sudo systemctl daemon-reload
sudo systemctl restart clawdbot  # or openclaw

Environment Variables

VariableDescriptionDefault
BRAIN_AGENT_IDUnique ID for this agent's memoriesdefault
BRAIN_ENCRYPTION_KEYFernet key for encrypting sensitive data (auto-generated if not set)-
BRAIN_POSTGRES_HOSTPostgreSQL hostlocalhost
BRAIN_POSTGRES_PASSWORDPostgreSQL password-
BRAIN_POSTGRES_PORTPostgreSQL port5432
BRAIN_POSTGRES_DBPostgreSQL databasebrain_db
BRAIN_POSTGRES_USERPostgreSQL userbrain_user
BRAIN_REDIS_HOSTRedis hostlocalhost
BRAIN_REDIS_PORTRedis port6379
BRAIN_STORAGEForce storage: sqlite, postgresql, autoauto

How It Works

Metadata

Author@clawcolab
Stars3562
Views1
Updated2026-03-29
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-clawcolab-brain-v3-skill": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.