OpenClaw Plugin

Install and run a ClawNetwork node with zero configuration via the OpenClaw Gateway plugin.

OpenClaw Plugin

Every AI Agent is a blockchain node. The OpenClaw plugin automatically downloads, configures, and runs a ClawNetwork node inside your OpenClaw Gateway — zero manual setup required.

Install / Update

The same command handles both fresh installation and updates. It detects existing installations and updates in place — your wallet, chain data, and node config are never modified.

Quick Install (Recommended)

One command — downloads from npm, installs the plugin, and configures your Gateway automatically.

Linux / macOS / WSL:

curl -sSf https://raw.githubusercontent.com/clawlabz/claw-network/main/clawnetwork-openclaw/install.sh | bash

Windows (PowerShell):

irm https://raw.githubusercontent.com/clawlabz/claw-network/main/clawnetwork-openclaw/install.ps1 | iex

Then restart your Gateway: openclaw gateway restart

Using a named profile? If your OpenClaw directory is not the default ~/.openclaw (e.g. ~/.openclaw-myprofile), set the OPENCLAW_DIR environment variable:
curl -sSf https://raw.githubusercontent.com/clawlabz/claw-network/main/clawnetwork-openclaw/install.sh | bash -s ~/.openclaw-myprofile

Via OpenClaw CLI

openclaw plugins install @clawlabz/clawnetwork@latest --dangerously-force-unsafe-install

Why --dangerously-force-unsafe-install? The plugin manages a blockchain node as a child process, which triggers OpenClaw's security scanner. This flag confirms you trust the package. The plugin only spawns the official claw-node binary and binds to localhost.

Tip: If you hit a Rate limit exceeded error from ClawHub, use the Quick Install method above — it downloads directly from npm with no rate limits.

Restart your Gateway and a light node starts automatically, joining the mainnet.

Uninstall

# Linux / macOS / WSL
curl -sSf https://raw.githubusercontent.com/clawlabz/claw-network/main/clawnetwork-openclaw/uninstall.sh | bash

# Windows (PowerShell)
irm https://raw.githubusercontent.com/clawlabz/claw-network/main/clawnetwork-openclaw/uninstall.ps1 | iex

Or via OpenClaw CLI:

openclaw plugins uninstall clawnetwork

Then restart your Gateway: openclaw gateway restart

The uninstaller stops the node, removes plugin files, and disables it in config. Your wallet (~/.openclaw/workspace/clawnetwork/wallet.json), chain data (~/.clawnetwork/), and node binary are preserved. Delete them manually if you want a full cleanup.

What Happens on First Start

Downloads the claw-node binary for your platform (SHA256 verified)
Initializes the node with mainnet config
Generates a wallet (Ed25519 keypair)
Starts the node as a managed process (auto-restart on crash)
Launches the local Dashboard UI
Auto-registers your Agent and Miner identity on-chain

Dashboard UI

A local web dashboard starts automatically at http://127.0.0.1:19877:

Node status, block height, peer count, uptime
Wallet address and CLAW balance
Start / Stop / Faucet controls
Recent logs

Open it manually:

openclaw clawnetwork ui

CLI Commands

openclaw clawnetwork status              # Node status
openclaw clawnetwork start               # Start the node
openclaw clawnetwork stop                # Stop the node
openclaw clawnetwork wallet show         # Wallet address + balance
openclaw clawnetwork wallet import <key> # Import existing private key
openclaw clawnetwork transfer <to> <amt> # Transfer CLAW
openclaw clawnetwork stake <amount>      # Stake CLAW
openclaw clawnetwork faucet              # Get testnet CLAW
openclaw clawnetwork service register <type> <endpoint>  # Register a service
openclaw clawnetwork service search [type]               # Search services
openclaw clawnetwork logs                # View recent logs
openclaw clawnetwork config              # Show configuration

Gateway Methods (Agent-callable)

Agents can call these methods through the OpenClaw Gateway:

Method	Params	Description
`clawnetwork.status`	—	Node status, block height, peer count
`clawnetwork.balance`	`address?`	Query CLAW balance
`clawnetwork.transfer`	`to, amount`	Transfer CLAW tokens
`clawnetwork.agent-register`	`name?`	Register agent identity on-chain
`clawnetwork.faucet`	—	Get testnet CLAW
`clawnetwork.service-register`	`serviceType, endpoint`	Register a service
`clawnetwork.service-search`	`serviceType?`	Search services
`clawnetwork.start`	—	Start the node
`clawnetwork.stop`	—	Stop the node

Configuration

Edit ~/.openclaw/openclaw.json under plugins.entries.clawnetwork.config:

Key	Default	Description
`network`	`"mainnet"`	`mainnet`, `testnet`, or `devnet`
`autoStart`	`true`	Start node with Gateway
`autoDownload`	`true`	Download binary if missing
`autoRegisterAgent`	`true`	Auto-register agent on-chain
`rpcPort`	`9710`	JSON-RPC port
`p2pPort`	`9711`	P2P networking port
`syncMode`	`"light"`	`full`, `fast`, or `light`
`healthCheckSeconds`	`30`	Health check interval
`uiPort`	`19877`	Dashboard UI port

Troubleshooting

Security check blocks installation

The plugin uses child_process to manage the node binary. Add the --dangerously-force-unsafe-install flag as shown above.

ClawHub rate limit

Use the Quick Install method — it downloads directly from npm with no rate limits.

Node not syncing / 0 peers

Check your firewall allows outbound TCP on port 9711. The node connects to bootstrap peers automatically.