Squad

Entity registry, filesystem tools, and version management plugin for OpenClaw gateway.

Squad is an OpenClaw gateway plugin developed by WorldBrain (the team behind the Memex browser extension) that provides a curated set of entity management, filesystem safety, and version governance tools for OpenClaw agents. Rather than giving agents unrestricted access to your filesystem and configuration, Squad wraps these operations in safety layers with explicit entity registration, locked-down file access patterns, and controlled plugin management. The plugin registers an entity registry that lets agents track and manage named entities (people, projects, resources) within structured contexts. Its filesystem tools are deliberately constrained — providing safe read/write operations within approved directories rather than unrestricted shell access. This makes it particularly valuable in multi-agent setups where you want predictable, auditable file operations. Squad also includes agent setup wrappers that help bootstrap new OpenClaw environments with sensible defaults, and plugin safety wrappers that validate and constrain how other plugins are installed and configured. The version management component tracks OpenClaw gateway versions and can flag when upgrades or configuration migrations are needed. This plugin is niche but valuable for users who run OpenClaw in shared or production environments where safety guardrails around file access and entity management are important. With only 132 weekly downloads, it's one of the smaller community plugins — but its approach to constrained agent tooling reflects a growing need in the ecosystem for governance-first designs.

Tags: utility, filesystem, tool

Use Cases

  • Multi-agent OpenClaw deployments needing controlled filesystem access
  • Entity tracking for CRM-like use cases within OpenClaw conversations
  • Onboarding new OpenClaw installations with safe, opinionated defaults
  • Plugin safety auditing before enabling community plugins
  • Version management and upgrade tracking for OpenClaw gateway

Tips

  • Start with the entity registry to organize contacts, projects, and resources your agent needs to track
  • Configure filesystem allowedPaths carefully — too restrictive breaks workflows, too permissive defeats the purpose
  • Use the plugin safety wrappers if you're installing community plugins from untrusted authors
  • Pair with Workspace Governance plugin for comprehensive agent discipline
  • Check the npm page for the latest README since the GitHub repo may be relocated
  • Enable enforceReadBeforeWrite to prevent the agent from overwriting files it hasn't read first

Known Issues & Gotchas

  • The GitHub repo URL (github.com/WorldBrain/squad) returns 404 — the repo may have been renamed or moved
  • Plugin name on npm is squad-openclaw, not @worldbrain/squad
  • Filesystem allowedPaths must be explicitly configured — no defaults are set
  • Entity registry data is stored locally and not synced across multiple OpenClaw instances
  • Safety wrappers may block legitimate plugin operations if not configured properly
  • Version management checks require network access to npm registry

Alternatives

  • Workspace Governance
  • Deterministic Governance
  • OpenClaw built-in file tools

Community Feedback

OpenClaw gateway plugin for Squad — provides entity registry, locked-down filesystem tools, agent setup wrappers, plugin safety wrappers, and version management.

— npm

The ecosystem is bigger than you think — plugins like Squad show that people are thinking seriously about governance and safety for AI agents, not just features.

— Reddit r/openclaw

A secure OpenClaw implementation would look less like a plugin playground and more like a tightly sandboxed execution engine with a policy layer. Squad is heading in that direction.

— Reddit r/LLMDevs

Frequently Asked Questions

What is WorldBrain and why did they build this plugin?

WorldBrain is the team behind Memex, a browser extension for web research and knowledge management. Squad extends their focus on structured knowledge into the OpenClaw agent ecosystem with entity registry and governed file access.

Is the GitHub repository available?

The listed repository URL (github.com/WorldBrain/squad) currently returns a 404. The package is available on npm as squad-openclaw. Check npm for the latest README and documentation.

Can I use Squad alongside other governance plugins?

Yes. Squad focuses on filesystem safety and entity management while Workspace Governance handles write discipline and audit trails. They address different concerns and can run together.

How does the entity registry work?

The entity registry lets agents register and query named entities (people, projects, resources) with structured metadata. It's stored locally and accessible through plugin-provided tools during conversations.

Is Squad suitable for single-user setups?

It can be, but its main value shines in shared or production environments where filesystem constraints and entity tracking matter. For single-user personal setups, it may add unnecessary complexity.

Configuration Examples

Basic Installation

# Install:
openclaw plugins install squad-openclaw

# Config:
plugins:
  squad:
    enabled: true

Locked-Down Filesystem

plugins:
  squad:
    enabled: true
    filesystem:
      allowedPaths:
        - ~/.openclaw/workspace
        - ~/Documents/projects
      denyPatterns:
        - "*.env"
        - ".ssh/*"

Installation

openclaw plugins install squad-openclaw