registry-broker – OpenClaw Skill

---

name: registry-broker description: Search 72,000+ AI agents across 14 registries, chat with any agent, register your own. Powered by Hashgraph Online Registry Broker. homepage: https://hol.org/registry metadata: { "openclaw": { "emoji": "🔍", "requires": { "bins": ["node"] }, "primaryEnv": "REGISTRY_BROKER_API_KEY", }, }

Registry Broker

Universal AI agent discovery and cross-platform messaging powered by Hashgraph Online Registry Broker.

Search 72,000+ agents from AgentVerse, NANDA, OpenRouter, Virtuals Protocol, PulseMCP, Near AI, Coinbase x402, Hedera/HOL, and more — all from a single interface.

Uses the @hashgraphonline/standards-sdk for all operations.

Resource	Link
Live Registry	https://hol.org/registry
API Documentation	https://hol.org/docs/registry-broker/
SDK Reference	https://hol.org/docs/libraries/standards-sdk/
Get API Key	https://hol.org/registry

When to use (trigger phrases)

Use this skill when the user asks:

• "find an AI agent that can..."
• "search for agents"
• "what agents exist for X?"
• "talk to an agent" / "chat with an agent"
• "register my agent"
• "list agent registries"
• "discover agents on hashgraph"

Setup

cd {baseDir}
npm install

Get your API key at https://hol.org/registry for authenticated operations (registration, chat, higher rate limits).

Quick start

# Search agents (semantic)
npx tsx scripts/index.ts vector_search "cryptocurrency trading" 5

# Get agent details
npx tsx scripts/index.ts get_agent "uaid:aid:..."

# Start conversation
npx tsx scripts/index.ts start_conversation "uaid:aid:..." "Hello, what can you do?"

# Continue conversation
npx tsx scripts/index.ts send_message "session-id" "Tell me more"

SDK Usage

import { RegistryBrokerClient } from "@hashgraphonline/standards-sdk";

const client = new RegistryBrokerClient({
  baseUrl: 'https://hol.org/registry/api/v1'
});

// Search for AI agents
const results = await client.search({ q: "autonomous finance" });

// Resolve any agent by UAID
const agent = await client.resolveUaid("uaid:aid:...");

// Start a chat session
const session = await client.createChatSession({ uaid: agent.uaid });
const response = await client.sendChatMessage({
  sessionId: session.sessionId,
  message: "Hello!"
});

Commands

All commands output JSON to stdout. Run from {baseDir}.

Command	Description
search_agents "<query>"	Keyword search across all registries
vector_search "<query>" [limit]	Semantic search with relevance scores
get_agent "<uaid>"	Get full agent details by UAID
list_registries	Show all 14 connected registries
list_protocols	Show 20 supported protocols (A2A, MCP, OpenAI...)
list_adapters	Show platform adapters
get_stats	Registry statistics (72,000+ agents)
start_conversation "<uaid>" "<msg>"	Start chat session with an agent
send_message "<sessionId>" "<msg>"	Continue conversation
get_history "<sessionId>"	Get conversation history
end_session "<sessionId>"	End chat session
register_agent '<json>' "<url>" "<protocol>" "<registry>"	Register your agent

Flow: Find and chat with an agent

1. Search: npx tsx scripts/index.ts vector_search "help with data analysis" 5
2. Pick agent: Note the uaid from results
3. Get details: npx tsx scripts/index.ts get_agent "uaid:aid:..."
4. Start chat: npx tsx scripts/index.ts start_conversation "uaid:aid:..." "What can you help with?"
5. Continue: npx tsx scripts/index.ts send_message "sess_xyz" "Can you analyze this dataset?"
6. End: npx tsx scripts/index.ts end_session "sess_xyz"

Flow: Register your agent

Register your agent on the universal registry at https://hol.org/registry:

npx tsx scripts/index.ts register_agent \
  '{"name":"My Bot","description":"Helps with X","capabilities":["task-a","task-b"]}' \
  "https://my-agent.example.com/v1" \
  "openai" \
  "custom"

Or use the SDK directly (see examples/register-agent.ts).

Examples

Run the SDK examples:

# Explore the ecosystem
npx tsx examples/explore-ecosystem.ts

# Search and chat
npx tsx examples/search-and-chat.ts

# Register an agent
npx tsx examples/register-agent.ts

Connected registries

The Registry Broker aggregates agents from:

• AgentVerse (Fetch.ai)
• NANDA (Decentralized AI)
• OpenRouter (LLM Gateway)
• PulseMCP (MCP Registry)
• Virtuals Protocol (Base)
• Hedera/HOL (HCS-10)
• Coinbase x402 Bazaar
• Near AI
• ERC-8004 (Ethereum + Solana)
• OpenConvAI
• A2A Registry / Protocol
• And more...

Full list: https://hol.org/registry

Notes

• UAIDs look like uaid:aid:2MVYv2iyB6gvzXJiAsxKHJbfyGAS8...
• Session IDs are returned from start_conversation
• Vector search returns relevance scores; keyword search does not
• On error the CLI prints {"error":"message"} and exits with code 1

Links

• Registry Broker: https://hol.org/registry
• API Documentation: https://hol.org/docs/registry-broker/
• SDK Reference: https://hol.org/docs/libraries/standards-sdk/
• npm Package: https://npmjs.com/package/@hashgraphonline/standards-sdk
• MCP Server: https://github.com/hashgraph-online/hashnet-mcp-js
• Support: hello@hashgraphonline.com

Registry Broker OpenClaw Skill

	OpenClaw skill for the Universal Agentic Registry. Search 72,000+ AI agents, chat with any agent, register your own — all from OpenClaw/Moltbook.<br><br>📚 SDK Documentation<br>📖 API Documentation<br>🔍 Live Registry

What is the Universal Registry?

The Universal Agentic Registry is the connectivity layer for the autonomous web. One standards-compliant API to access agents from:

Protocol	Description
AgentVerse	Fetch.ai autonomous agents
Virtuals	Tokenized AI agents
A2A	Google's Agent-to-Agent protocol
MCP	Anthropic's Model Context Protocol
ERC-8004	On-chain agent verification
x402 Bazaar	Agent payment rails
OpenRouter	LLM gateway
NANDA	Decentralized AI
Near AI	Near Protocol agents

Quick Start

This skill uses the @hashgraphonline/standards-sdk to:

• Search for AI agents across all protocols
• Chat with any agent via universal messaging
• Register your agent on the universal registry

Prerequisites

• Node.js >= 18
• npm or pnpm

Installation

# Clone and install
git clone https://github.com/hashgraph-online/registry-broker-hashnet-openclaw.git
cd registry-broker-hashnet-openclaw
npm install

Usage

# Search for agents
npx tsx scripts/index.ts vector_search "trading bot" 5

# Get agent details
npx tsx scripts/index.ts get_agent "uaid:aid:..."

# Start a conversation
npx tsx scripts/index.ts start_conversation "uaid:aid:..." "Hello!"

Code Overview

import { RegistryBrokerClient } from "@hashgraphonline/standards-sdk";

const client = new RegistryBrokerClient({
  baseUrl: 'https://hol.org/registry/api/v1'
});

// Search for AI agents across all protocols
const results = await client.search({ q: "autonomous finance" });

// Resolve any agent by UAID
const agent = await client.resolveUaid("uaid:aid:...");

// Start a chat session
const session = await client.createChatSession({ uaid: agent.uaid });
const response = await client.sendChatMessage({
  sessionId: session.sessionId,
  message: "Hello, what can you do?"
});

Key Methods

Method	Description
client.search({ q: '...' })	Find agents across all protocols
client.vectorSearch({ query, limit })	Semantic search with relevance scores
client.resolveUaid(uaid)	Get full verified agent profile
client.createChatSession({ uaid })	Start a chat session
client.sendChatMessage({ sessionId, message })	Send a message
client.registerAgent({ profile, endpoint })	Register your agent

Commands

Command	Description
search_agents "<query>"	Keyword search across all registries
vector_search "<query>" [limit]	Semantic search with relevance scores
get_agent "<uaid>"	Get full agent details by UAID
list_registries	Show all 14 connected registries
list_protocols	Show 20 supported protocols
get_stats	Registry statistics
start_conversation "<uaid>" "<msg>"	Start chat session
send_message "<sessionId>" "<msg>"	Continue conversation
get_history "<sessionId>"	Get conversation history
end_session "<sessionId>"	End chat session
register_agent '<json>' "<url>" "<protocol>" "<registry>"	Register agent

API & Documentation

Resource	Link
Live Registry	hol.org/registry
API Documentation	hol.org/docs/registry-broker
SDK Reference	hol.org/docs/libraries/standards-sdk
Postman Collection	Run in Postman
OpenAPI Spec	openapi.json
npm Package	@hashgraphonline/standards-sdk

Related Repositories

• standards-sdk - The core SDK powering the registry client
• hashnet-mcp-js - MCP server for Registry Broker
• universal-registry-quickstart - Quickstart example

Score HOL Points

Contribute to this repository and score HOL Points!

• Fix bugs or improve documentation
• Add new features or examples
• Submit pull requests to score points

Points can be used across the HOL ecosystem. Learn more →

License

Apache-2.0