ClawKit Logo
ClawKitReliability Toolkit
Back to Registry
Official Verified

get-agent-identity

Check your agent's on-chain ERC-8004 identity, trust score, and KYA credentials. Use when the user wants to see agent identity, check trust score, view credentials, or check agent status. Covers "agent ID", "trust score", "show my identity", "agent status", "KYA".

skill-install — Terminal

Install via CLI (Recommended)

clawhub install openclaw/skills/skills/agnicpay-prog/get-agent-identity
Or

Getting Agent Identity

Check the user's on-chain ERC-8004 agent identity, trust score, and KYA (Know Your Agent) credentials.

Authentication

Run npx agnic@latest status --json to verify. If not authenticated:

  • Headless (CI/server/agent): Set AGNIC_TOKEN env var or pass --token <token>
  • Interactive (has browser): Run npx agnic@latest auth login

See the authenticate-wallet skill for details.

Check Agent Identity

npx agnic@latest agent-identity --json

Returns the agent's on-chain identity including:

  • Agent ID -- The ERC-721 token ID on the ERC-8004 Identity Registry
  • Owner address -- The wallet that owns the agent NFT
  • Trust score -- Reputation score (0-100) based on transaction history
  • Categories -- Authorized action categories (e.g., payment, general, alcohol)
  • Status -- Whether the agent is active or suspended

What is ERC-8004?

ERC-8004 ("Trustless Agents") is an Ethereum standard that gives AI agents:

FeatureDescription
On-chain identityAn ERC-721 NFT representing the agent on the Identity Registry
Reputation scoreTrust score (0-100) based on on-chain transaction history
KYA credentialsSD-JWT verifiable credentials for identity verification
DelegationSpending limits and category permissions via KYA delegation credentials

Contract Addresses

ContractNetworkAddress
Identity RegistryBase Mainnet0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Identity RegistryBase Sepolia0x8004A818BFB912233c491871b3d84c89A494BD9e
ReputationBase Mainnet0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
ReputationBase Sepolia0x8004B663056A597Dffe9eCcC1965A193B7388713

Expected Output

{
  "agentId": 373,
  "ownerAddress": "0x046906b3cd9d73bf85eb01d795d333b364b75842",
  "status": "active",
  "registeredAt": "2024-12-15T10:30:00Z",
  "trustScore": 85,
  "categories": ["payment", "general"],
  "hasDelegation": true
}

Prerequisites

  • Must be authenticated (npx agnic@latest status to check)
  • Agent identity is automatically created during Agnic sign-up

Error Handling

Common errors:

  • "Not authenticated" -- Run npx agnic@latest auth login or set AGNIC_TOKEN
  • "No agent identity found" -- The user may not have an agent registered; create one at app.agnic.ai
  • "Agent suspended" -- The agent's delegation may have been revoked; contact support
Read Full Documentation on GitHub

Metadata

Author@agnicpay-prog
Stars4473
Views1
Updated2026-05-01
View Author Profile
AI Skill Finder

Not sure this is the right skill?

Describe what you want to build — we'll match you to the best skill from 16,000+ options.

Find the right skill
Add to Configuration

Paste this into your clawhub.json to enable this plugin.

{
  "plugins": {
    "official-agnicpay-prog-get-agent-identity": {
      "enabled": true,
      "auto_update": true
    }
  }
}
Safety NoteClawKit audits metadata but not runtime behavior. Use with caution.

Related Skills

trade-tokens

Swap or trade tokens on Base network. Use when you or the user want to trade, swap, exchange, buy, sell, or convert between tokens like USDC, ETH, and WETH. Covers phrases like "buy ETH", "sell ETH for USDC", "convert USDC to ETH", "get some ETH", "swap tokens", "trade USDC for WETH".

agnicpay-prog 4473

check-balance

Check USDC balance across networks (Base, Solana). Use when the user wants to check balance, see how much USDC is available, view funds, or verify wallet balance. Covers "check my balance", "how much do I have", "show funds", "wallet balance".

agnicpay-prog 4473

ai-gateway

Access 340+ AI models via the Agnic AI Gateway -- chat, image generation, model listing. Use when the user wants to chat with AI, generate images, ask GPT, use Claude, list models, delegate to another LLM, or get a second opinion. Covers "ask GPT", "use Claude", "generate an image", "list AI models", "call a model".

agnicpay-prog 4473

authenticate-wallet

Authenticate Agnic wallet via browser OAuth or headless API token. Use when the user wants to sign in, log in, authenticate, connect wallet, set up CLI, or resolve "Not authenticated" errors. Supports AGNIC_TOKEN env var for CI/server/agent environments.

agnicpay-prog 4473

agnic

Complete AI agent wallet with payments, trading, email, and on-chain identity. Use when the user wants to manage their agent's wallet, make payments, trade tokens, send/receive email, or check their agent identity.

agnicpay-prog 4473