@clawlabz/clawnetwork

Official ClawNetwork plugin for OpenClaw Gateway.

Every AI Agent is a blockchain node. This plugin automatically downloads, configures, and runs a ClawNetwork node inside your OpenClaw Gateway. Your agents get native blockchain capabilities — on-chain identity, token transfers, staking, and service discovery — with zero manual setup.

Install

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

If you get a Rate limit exceeded error from ClawHub, install via npm instead:

npm pack @clawlabz/clawnetwork@latest && openclaw plugins install ./clawlabz-clawnetwork-*.tgz --dangerously-force-unsafe-install && rm -f clawlabz-clawnetwork-*.tgz

Why the flag? This plugin manages a blockchain node as a child process (child_process), which triggers OpenClaw's built-in code scanner. The flag confirms you trust this package. This is safe — the plugin only spawns the official claw-node binary and binds to localhost.

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

Update

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

If ClawHub is rate-limited, use the npm one-liner above.

Your wallet and node data are safe. Uninstall only removes the plugin code (~/.openclaw/extensions/clawnetwork/). Your wallet (~/.openclaw/workspace/clawnetwork/wallet.json), chain data, and node config are untouched.

Once openclaw#60140 is merged, a single command will work: openclaw plugins update clawnetwork --dangerously-force-unsafe-install

What happens on first start

1. Downloads the claw-node binary for your platform (with SHA256 checksum verification)
2. Initializes the node with mainnet config
3. Generates a wallet (Ed25519 keypair)
4. Starts the node as a managed child process (auto-restart on crash)
5. Launches the local dashboard UI
6. Auto-registers your agent identity on-chain (testnet/devnet)

Dashboard UI

A local web dashboard starts automatically with the node:

openclaw clawnetwork ui     # Open in browser

The dashboard shows:

• Node status (online/syncing/offline), block height, peer count, uptime
• Wallet address and balance
• Node controls (start/stop/faucet)
• Recent logs

Default port: 19877 (configurable via uiPort)

CLI Commands

openclaw clawnetwork status           # Node status (height, peers, wallet, balance)
openclaw clawnetwork start            # Start the node
openclaw clawnetwork stop             # Stop the node
openclaw clawnetwork wallet show      # Show wallet address + balance
openclaw clawnetwork wallet import <key>  # Import existing private key
openclaw clawnetwork wallet export    # Export private key (handle with care!)
openclaw clawnetwork transfer <to> <amount>  # 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 node logs
openclaw clawnetwork config           # Show current configuration
openclaw clawnetwork ui               # Open dashboard in browser

Colon format also works: openclaw clawnetwork:status, openclaw clawnetwork:start, etc.

Gateway Methods (Agent-callable)

Configuration

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

Security

• Binary verification: SHA256 checksum verified on download against official SHA256SUMS.txt
• Wallet storage: Private keys stored at ~/.openclaw/workspace/clawnetwork/wallet.json with 0600 permissions
• Sandboxed process: Node runs with minimal environment variables (HOME, PATH, RUST_LOG only) — no secrets leak from parent
• Input validation: All addresses, amounts, and names validated before execution
• No shell execution: All commands use execFileSync with argument arrays (no shell injection)
• Log rotation: Logs auto-rotate at 5 MB to prevent disk exhaustion
• Localhost only: RPC and dashboard bind to 127.0.0.1 (not exposed externally)

Architecture

OpenClaw Gateway
  └── @clawlabz/clawnetwork (this plugin)
        ├── registerService → manages claw-node child process
        │     ├── auto-download binary (SHA256 verified)
        │     ├── auto-restart on crash (3x, exponential backoff)
        │     ├── health check loop (/health endpoint)
        │     └── log rotation (5 MB)
        ├── registerGatewayMethod → chain operations for agents
        │     └── status, balance, transfer, agent-register,
        │         faucet, service-register, service-search
        ├── registerCli → openclaw clawnetwork:* commands
        └── WebUI dashboard (127.0.0.1:19877)
              │
              ▼
        claw-node (Rust binary, child process)
          ├── localhost:9710 (JSON-RPC)
          └── localhost:9711 (P2P)

Data Locations

Publish (Maintainers)

cd clawnetwork-openclaw
npm publish --access public

Links

• ClawNetwork — AI Agent blockchain
• OpenClaw — Personal AI assistant gateway
• ClawHub — Skill & plugin registry