Extensions

Extensions are external .js or .mjs add-ons that extend SwarmClaw with additional tools, hooks, UI modules, providers, or connectors.

Built-in platform capabilities are not extensions. They are native tools selected from agent and chat tool pickers.

Installing Extensions

You can add external extensions by:

  • browsing the Extensions marketplace surface
  • installing from a direct HTTPS URL
  • adding a local extension file into the managed extensions directory

Current on-disk extension storage lives under data/extensions/.

SwarmClaw still migrates older legacy extension installs automatically on first access.

What Extensions Can Do

Extensions can add:

  • custom tools
  • lifecycle hooks
  • UI panels
  • providers
  • connectors

SwarmClaw still supports compatible OpenClaw extension/plugin formats where practical.

Built-In Tools vs Extensions

  • Tools: built into SwarmClaw and enabled per agent or chat
  • Extensions: external files installed separately

The Extensions page manages only external add-ons.

Stability and Recovery

If an extension fails repeatedly, SwarmClaw can auto-disable it and record failure metadata in:

data/extension-failures.json

The threshold env var is:

SWARMCLAW_EXTENSION_FAILURE_THRESHOLD=3

Settings and Dependencies

External extensions can expose:

  • settings fields
  • dependency workspaces
  • install/update metadata

These are managed from the Extensions detail surface and the /api/extensions/* routes.