# Send zscore to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "zscore",
    "name": "zscore",
    "source": "tencent",
    "type": "skill",
    "category": "AI 智能",
    "sourceUrl": "https://clawhub.ai/elitex45/zscore",
    "canonicalUrl": "https://clawhub.ai/elitex45/zscore",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/zscore",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zscore",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "package.json",
      "SKILL.md",
      "lib/get-reputation.js",
      "lib/get-agent.js",
      "lib/register-agent.js",
      "lib/index.js"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "zscore",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-05T07:07:37.359Z",
      "expiresAt": "2026-05-12T07:07:37.359Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zscore",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=zscore",
        "contentDisposition": "attachment; filename=\"zscore-1.0.3.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "zscore"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/zscore"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/zscore",
    "downloadUrl": "https://openagent3.xyz/downloads/zscore",
    "agentUrl": "https://openagent3.xyz/skills/zscore/agent",
    "manifestUrl": "https://openagent3.xyz/skills/zscore/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/zscore/agent.md"
  }
}
```
## Documentation

### Zeru ERC-8004 Identity Registry

Register and manage AI agents on the Zeru Identity Registry. Defaults to Base Mainnet (0.0025 ETH fee). Use --chain 84532 for Base Sepolia testnet.

### One-Time Setup

Run once to install dependencies:

cd {baseDir} && npm install

### Agent JSON Structure (ERC-8004 registration-v1)

When registering an agent, you provide a JSON file describing the agent. The SDK auto-fills type, registrations, and defaults for x402Support/active/image if omitted.

Minimal JSON (just name + description + one service):

{
  "name": "My AI Agent",
  "description": "A helpful AI agent that does X",
  "services": [
    { "name": "web", "endpoint": "https://myagent.example.com" }
  ]
}

Full JSON (MCP + A2A + OASF + x402 payments):

{
  "name": "DataAnalyst Pro",
  "description": "Enterprise-grade blockchain data analysis agent. Performs on-chain forensics, wallet profiling, and transaction pattern detection.",
  "image": "https://cdn.example.com/agents/analyst.png",
  "services": [
    {
      "name": "MCP",
      "endpoint": "https://api.dataanalyst.ai/mcp",
      "version": "2025-06-18",
      "mcpTools": ["analyze_wallet", "trace_transactions", "detect_anomalies"],
      "capabilities": []
    },
    {
      "name": "A2A",
      "endpoint": "https://api.dataanalyst.ai/.well-known/agent-card.json",
      "version": "0.3.0",
      "a2aSkills": ["analytical_skills/data_analysis/blockchain_analysis"]
    },
    {
      "name": "OASF",
      "endpoint": "https://github.com/agntcy/oasf/",
      "version": "0.8.0",
      "skills": ["analytical_skills/data_analysis/blockchain_analysis"],
      "domains": ["technology/blockchain"]
    },
    {
      "name": "web",
      "endpoint": "https://dataanalyst.ai"
    },
    {
      "name": "agentWallet",
      "endpoint": "eip155:8453:0x742d35Cc6634C0532925a3b844Bc9e7595f0bEb7"
    }
  ],
  "x402Support": true,
  "active": true,
  "supportedTrust": ["reputation", "ERC-8004"]
}

All fields:

FieldTypeRequiredDefaultDescriptionnamestringYes—Agent name (1–256 chars)descriptionstringYes—What the agent does (max 2048 chars)imagestringNoplaceholderAvatar URL (HTTPS, IPFS, or Arweave)servicesarrayYes—Service endpoints (1–64 items, see below)x402SupportbooleanNofalseSupports x402 payment protocolactivebooleanNotrueAgent is actively accepting requestssupportedTruststring[]No—Trust models: "reputation", "crypto-economic", "tee-attestation", "ERC-8004"ownerstringNosigner addressOwner 0x address (auto-set from PRIVATE_KEY)

Service types:

nameendpointExtra fields"web"Website URL—"MCP"MCP server URLversion, mcpTools[], mcpPrompts[], mcpResources[], capabilities[]"A2A"Agent card URL (/.well-known/agent-card.json)version, a2aSkills[]"OASF"OASF repo URLversion, skills[], domains[]"agentWallet"CAIP-10 address (eip155:{chainId}:{address})—"ENS"ENS name (e.g. myagent.eth)—"email"Email address—customAny URLdescription

### /zscore register --json <file>

Register a new agent using a full JSON file (recommended). Creates hosted agent URI, mints NFT on-chain, and updates URI with the real agentId.

/zscore register --json agent.json
/zscore register --json agent.json --chain 84532

Steps to register:

Create a JSON file following the structure above (e.g. agent.json)
Run: npx tsx {baseDir}/scripts/zeru.ts register --json agent.json

The SDK automatically adds type, registrations (with agentId: 0 placeholder), and defaults for missing optional fields. After minting, it updates the document with the real agentId.

### /zscore register --name <name> --description <desc> --endpoint <url>

Simple registration (single API endpoint only). For richer agents, use --json instead.

/zscore register --name "Trading Bot" --description "AI-powered trading agent" --endpoint "https://mybot.com/api"
/zscore register --name "Data Analyzer" --description "Analyzes datasets" --endpoint "https://analyzer.ai/api" --image "https://example.com/icon.png"
/zscore register --name "Test Bot" --description "Testing" --endpoint "https://test.com" --chain 84532

Requires PRIVATE_KEY env var. Wallet must have fee + gas (e.g. ~0.003 ETH on mainnet).

To run: npx tsx {baseDir}/scripts/zeru.ts register --name "..." --description "..." --endpoint "..."

### /zscore read <agentId>

Read an agent's on-chain data: owner, URI, wallet, name, services.

/zscore read 16

To run: npx tsx {baseDir}/scripts/zeru.ts read 16

### /zscore fee

Check current registration fee and whether registration is open.

/zscore fee

To run: npx tsx {baseDir}/scripts/zeru.ts fee

### /zscore set-metadata <agentId> --key <key> --value <value>

Set custom metadata on an agent. Only the owner can call.

/zscore set-metadata 16 --key "category" --value "trading"

Requires PRIVATE_KEY.

To run: npx tsx {baseDir}/scripts/zeru.ts set-metadata 16 --key "category" --value "trading"

### /zscore unset-wallet <agentId>

Clear the agent wallet. Only the owner can call.

/zscore unset-wallet 16

Requires PRIVATE_KEY.

To run: npx tsx {baseDir}/scripts/zeru.ts unset-wallet 16

### Read-Only (no setup needed)

read and fee work without a private key.

### With Wallet (for registration and writes)

Add to your OpenClaw config (~/.openclaw/openclaw.json):

{
  "skills": {
    "entries": {
      "zscore": {
        "enabled": true,
        "env": {
          "PRIVATE_KEY": "0xYourFundedPrivateKey"
        }
      }
    }
  }
}

Optional env:

RPC_URL — override default RPC
CHAIN_ID — override chain (default: 8453 for Base Mainnet, use 84532 for Base Sepolia)

### Base Mainnet (default, chainId 8453)

Identity Registry: 0xFfE9395fa761e52DBC077a2e7Fd84f77e8abCc41
Reputation Registry: 0x187d72a58b3BF4De6432958fc36CE569Fb15C237
Registration Fee: 0.0025 ETH
RPC: https://mainnet.base.org

### Base Sepolia (testnet, chainId 84532)

Identity Registry: 0xF0682549516A4BA09803cCa55140AfBC4e5ed2E0


Reputation Registry: 0xaAC7557475023AEB581ECc8bD6886d1742382421


Registration Fee: 0.001 ETH


RPC: https://sepolia.base.org


Source: zeru

### How It Works

register creates a hosted JSON document (ERC-8004 registration-v1 schema) via the Agent URI API, mints an NFT on the Identity Registry (paying the fee), then updates the document with the real agentId.
read queries the on-chain contract for owner, tokenURI, and agentWallet, then fetches and parses the URI JSON.
fee reads the current registrationFee() and registrationEnabled() from the contract.
set-metadata calls setMetadata(agentId, key, value) on the contract.
unset-wallet calls unsetAgentWallet(agentId) on the contract.
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: elitex45
- Version: 1.0.3
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-05T07:07:37.359Z
- Expires at: 2026-05-12T07:07:37.359Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/zscore)
- [Send to Agent page](https://openagent3.xyz/skills/zscore/agent)
- [JSON manifest](https://openagent3.xyz/skills/zscore/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/zscore/agent.md)
- [Download page](https://openagent3.xyz/downloads/zscore)