← Back to Skills Marketplace
jonathangu

OpenClawBrain

by Jonathan Louis Gu · GitHub ↗ · v12.2.1
cross-platform ⚠ suspicious
440
Downloads
0
Stars
1
Active Installs
4
Versions
Install in OpenClaw
/install openclawbrain
Description
Learned memory graph for AI agents. Policy-gradient routing over document chunks with self-learning, self-regulation, and autonomous correction. Pure Python...
Usage Guidance
This skill appears to be a coherent memory-graph tool, but before installing: 1) understand it will read and chunk your workspace files and persist mutable state to a local JSON (./brain/state.json) and run a daemon listening on a Unix socket — review where that file and socket will live and who/what can access them; 2) if you plan to use the OpenAI embedder/LLM, you will need to supply an API key (the skill bundle did not declare any required env vars like OPENAI_API_KEY); 3) the skill supports agent-initiated 'self_learn' (automatic updates to the graph) — only enable autonomous invocation if you trust the agent's behavior and data handling; 4) verify the openclawbrain PyPI package and its source (there is no homepage/source URL in the registry) before running pip install; and 5) if you need higher assurance, request the package source or a signed release and review daemon/socket access controls. If any of these points are unacceptable, treat the skill as untrusted.
Capability Analysis
Type: OpenClaw Skill Name: openclawbrain Version: 12.2.1 The OpenClaw AgentSkills skill bundle for 'openclawbrain' appears benign. The `SKILL.md` provides documentation and usage instructions for a learned memory graph system, including CLI commands for initialization, querying, learning, and daemon management. All operations described, such as local file system access for state management, local IPC via Unix sockets for the daemon, and optional network calls to OpenAI for embeddings, are consistent with the stated purpose of the skill. There are no instructions for data exfiltration, persistence, unauthorized remote control, or any other malicious activity. Potential vulnerabilities related to unsanitized user input passed to CLI arguments (e.g., in `query` or `content`) would be a flaw in the agent's execution or the `openclawbrain` tool itself, not an intentional malicious instruction within this skill bundle's documentation.
Capability Assessment
Purpose & Capability
The name/description (learned memory graph, policy-gradient routing) match the SKILL.md workflow (init, query, learn, daemon, maintenance). Requiring local workspace files and a state JSON is coherent. However, the README promotes optional OpenAI embeddings/LLM usage while the registry metadata declares no required environment variables (e.g., OPENAI_API_KEY) — an omission that is disproportionate to the advertised embedder capability.
Instruction Scope
Instructions explicitly tell the agent to read and chunk workspace files, run a long-lived daemon that holds state in memory and listens on a Unix socket, and perform autonomous 'self_learn' updates. Those actions are consistent with a memory/learning system but grant the skill discretion to read local files and mutate its state without human review; the SKILL.md also references 'chat_id lookback' for human corrections which implies reading session/chat context.
Install Mechanism
This is an instruction-only skill with no install spec or code files in the bundle, which is the lowest install risk. The SKILL.md shows standard pip install commands for a PyPI package, which is expected for a Python project.
Credentials
The skill advertises optional OpenAI embedding/LLM usage (e.g., text-embedding-3-small) but the registry shows no required environment variables or primary credential. If you plan to use the OpenAI embedder the agent or user will need an API key (OPENAI_API_KEY or equivalent); the skill does not declare this, so the registry metadata understates credential needs. No other unexpected credentials are requested.
Persistence & Privilege
The skill runs a daemon that keeps state hot in memory and exposes a Unix socket for NDJSON RPC; it also provides autonomous 'self_learn' capabilities that mutate the memory graph. It does not request 'always:true' or system-wide config changes, but it does persist state on disk (state.json) and can autonomously update that state — consider the security/privacy implications of allowing autonomous updates and a local socket accessible to other processes.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install openclawbrain
  3. After installation, invoke the skill by name or use /openclawbrain
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v12.2.1
v12.2.1: deployment fixes, status command, progress output, rechunking, upgrade guide
v12.2.0
v12.2.0: PG learning, self-learn, self-regulation, node splitting
v12.0.1
Updated SKILL.md with full CLI reference and API docs
v12.0.0
Renamed from CrabPath to OpenClawBrain
Metadata
Slug openclawbrain
Version 12.2.1
License
All-time Installs 1
Active Installs 1
Total Versions 4
Frequently Asked Questions

What is OpenClawBrain?

Learned memory graph for AI agents. Policy-gradient routing over document chunks with self-learning, self-regulation, and autonomous correction. Pure Python... It is an AI Agent Skill for Claude Code / OpenClaw, with 440 downloads so far.

How do I install OpenClawBrain?

Run "/install openclawbrain" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is OpenClawBrain free?

Yes, OpenClawBrain is completely free (open-source). You can download, install and use it at no cost.

Which platforms does OpenClawBrain support?

OpenClawBrain is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created OpenClawBrain?

It is built and maintained by Jonathan Louis Gu (@jonathangu); the current version is v12.2.1.

💬 Comments