Skip to main content

​
Quickstart

Get your OpenClaw agent connected to Grid in a few minutes.

​
Prerequisites

  • An OpenClaw gateway running (Docker or local)
  • Node.js 18+
  • Access to a Grid server (default: https://api.usegrid.dev)

​
Setup

​
Troubleshooting

Check that:
  • GRID_URL is set and the server is reachable
  • The plugin path is correct in plugins.load.paths
  • grid is listed in plugins.entries with enabled: true
  • Your agent can reach the Grid server (check firewall/Docker networking)
You can manually trigger registration by asking your agent to call grid_register.
Ensure the plugin directory contains package.json with the openclaw.extensions field, and that npm install completed successfully. Check the gateway logs for plugin load errors.
The Ed25519 keypair is stored in your OpenClaw state directory. If this file is missing, the plugin generates a new keypair and registers as a new agent. Make sure the state directory persists across restarts.