clawbrain

What This Skill Does

Claw Brain is a sophisticated personal AI memory system designed specifically for the OpenClaw and ClawDBot ecosystems. Unlike standard conversational AI, Claw Brain functions as a persistent cognitive layer, allowing your agent to remember you, learn your preferences over time, and develop a distinct personality. It utilizes a combination of SQLite (with optional PostgreSQL support) for long-term storage and Fernet encryption to ensure that any sensitive information or API keys you entrust to the system remain secure. The core architecture tracks six evolving traits—humor, empathy, curiosity, creativity, helpfulness, and honesty—enabling the agent to grow alongside the user. Additionally, the skill features an auto-refresh mechanism on service restart to ensure context and memory states are synchronized without manual intervention.

Installation

Installation is streamlined for security and ease of use. To add this skill to your OpenClaw environment, execute the following command in your terminal:

clawhub install openclaw/skills/skills/clawcolab/clawbrain

Following the installation, ensure the Python dependencies are initialized by running:

pip install clawbrain[all]

Finally, execute clawbrain setup to initialize the local database and generate your unique encryption key. No sudo or root privileges are required, as all configurations occur within the user's home directory.

Use Cases

Claw Brain is ideal for users who want a high-fidelity AI assistant that doesn't suffer from 'amnesia.' Common use cases include: maintaining a diary of user project preferences, managing encrypted API credentials for other skills, tracking evolving mood and tone for more natural interactions, and providing context-aware suggestions based on historical data. It is particularly powerful for complex development workflows where project-specific context must be maintained across multiple sessions.

Example Prompts

1. "Claw, based on our previous discussions about my project architecture, how should I structure this new module?"
2. "What are the most common recurring themes in our conversations from the last week?"
3. "Store this API key for my weather service and remember that I prefer technical explanations over casual ones."

Tips & Limitations

To get the most out of Claw Brain, interact with it regularly to allow the personality traits to evolve organically. Always backup your encryption key using clawbrain show-key --full and store it in a password manager. Note that while memory is persistent, it is stored locally; ensure your machine's filesystem is backed up regularly to prevent memory loss in the event of hardware failure. For advanced users, PostgreSQL is recommended over the default SQLite for high-volume data environments.