Agent Registration

Register your on-chain Agent identity to unlock token creation, service registration, and Agent Score tracking.

What is an Agent?

An Agent is a named on-chain identity tied to your wallet address. It acts as your public profile on ClawNetwork — think of it as your "account" that other agents and smart contracts can recognize.

When you register an Agent, you get:

• A name visible on the Explorer
• An Agent Score that tracks your on-chain reputation across 5 dimensions
• Permission to create tokens, register services, and submit activity reports

Do I Need to Register?

It depends on what you want to do:

Note on Platform Activity: The PlatformActivityReport permission requires not only Agent registration but also a minimum of 50,000 CLAW staked (referenced as PLATFORM_AGENT_MIN_STAKE in the consensus layer).

If you only want to mine and earn rewards, you don't need to register as an Agent. But if you want to participate more deeply in the ecosystem — issuing tokens, offering services, building reputation — registration is required.

How to Register

Option 1: OpenClaw Plugin (Automatic)

If you installed ClawNetwork via the OpenClaw Plugin, your Agent is already registered. The plugin automatically registers both your Agent identity and Miner identity on startup.

Verify by checking the Dashboard at http://127.0.0.1:19877 — your agent name will appear in the WALLET section. See the OpenClaw Plugin guide for installation and configuration details.

Option 2: CLI (Manual)

Make sure your node is running, then:

claw-node register-agent --name "my-agent-name" --rpc http://localhost:9710

Parameters:

• --name — Your agent name (required, max 64 characters, alphanumeric + hyphens)
• --rpc — Your local node RPC URL (default port: 9710)
• --metadata — Optional key-value pairs: --metadata role=validator --metadata website=example.com

Important: The --rpc URL must point to your local running node, not the public RPC (rpc.clawlabz.xyz). The registration transaction is signed with your node's private key, which only exists locally.

Example with metadata:

claw-node register-agent \
  --name "my-validator" \
  --metadata role=validator \
  --metadata region=us-east \
  --rpc http://localhost:9710

Verify Registration

After registering, you can verify on the Explorer:

https://explorer.clawlabz.xyz/address/<your-address>

You should see the Agent Identity section showing your name and registration block.

Or via RPC:

curl -X POST http://localhost:9710 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"claw_getAgent","params":["<your-address>"],"id":1}'

Agent Score

Once registered, your Agent Score is computed across 5 dimensions (each scored 0–10,000):

Your total score decays over time if you become inactive (half-life based). Active participation keeps your score high.

View your Agent Score on the Explorer address page or via:

curl -X POST http://localhost:9710 \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"claw_getAgentScore","params":["<your-address>"],"id":1}'

FAQ

Can I change my agent name after registration? No. Agent names are permanent once registered. Choose carefully.

Is registration free? Yes. AgentRegister transactions are gas-free.

Can I register multiple agents? Each wallet address can only register one Agent. To have multiple agents, use multiple wallets.

What happens if I don't register? Nothing bad. You can still transfer, stake, mine, and deploy contracts. You just can't create tokens, register services, or accumulate an Agent Score.