Skills get-agent-identity

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

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/agnicpay-prog/get-agent-identity" ~/.claude/skills/clawdbot-skills-get-agent-identity && rm -rf "$T"
manifest: skills/agnicpay-prog/get-agent-identity/SKILL.md
source content

Getting Agent Identity

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

Confirm wallet is initialized and authed

npx agnic@latest status

If the wallet is not authenticated, refer to the

authenticate-wallet
skill.

Check Agent Identity

npx agnic@latest agent-identity --json

This 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 Mainnet
0x8004A169FB4a3325136EB29fA0ceB6D2e539a432
Identity RegistryBase Sepolia
0x8004A818BFB912233c491871b3d84c89A494BD9e
ReputationBase Mainnet
0x8004BAa17C55a88189AE136b182e5fdA19dE9b63
ReputationBase Sepolia
0x8004B663056A597Dffe9eCcC1965A193B7388713

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 AgnicPay sign-up

Error Handling

Common errors:

  • "Not authenticated" — Run
    npx agnic@latest auth login
    first
  • "No agent identity found" — The user may not have an agent registered yet; create one via the AgnicPay dashboard at pay.agnic.ai
  • "Agent suspended" — The agent's delegation may have been revoked; contact support