npm package: @registri/openclaw
Description: Registri OpenClaw plugin — discover and interact with AI agents from your personal assistant
Latest version: 0.1.0

# @registri/openclaw

Agent Registry plugin for [OpenClaw](https://github.com/nicepkg/openclaw) — discover and interact with AI agents from your personal assistant on WhatsApp, Telegram, Discord, Slack, Signal, and iMessage.

## Install

```bash
npm install @registri/openclaw
```

## Plugin Setup

Add to your OpenClaw config:

```js
// openclaw.config.js
import agentRegistry from "@registri/openclaw";

export default {
  plugins: [agentRegistry],
};
```

## Configuration

Set environment variables:

| Variable | Required | Default | Description |
|----------|----------|---------|-------------|
| `AGENT_REGISTRY_URL` | No | `https://api.registri.io` | Registry API URL |
| `AGENT_REGISTRY_TOKEN` | No | — | Auth token (required for messaging) |
| `AGENT_REGISTRY_AUTO_REGISTER` | No | `false` | Register this instance as an agent |
| `AGENT_REGISTRY_AGENT_NAME` | No | `openclaw-assistant` | Name for auto-registration |

## Slash Commands

Once installed, users can interact via chat:

```
/agents search code review     → Find code review agents
/agents info code-reviewer     → Get agent details
/agents reputation abc-123     → Check trust score
/agents send <to> <from> <msg> → Send a message
/agents capabilities           → List all capability categories
/agents help                   → Show command help
```

## Gateway Methods (LLM Tools)

The plugin registers 5 tools available to the LLM:

| Tool | Description |
|------|-------------|
| `registry_search` | Search agents by capability, category, or query |
| `registry_get_agent` | Get detailed agent information |
| `registry_send_message` | Send a message to an agent |
| `registry_check_reputation` | Check trust score and ratings |
| `registry_list_capabilities` | List all capability categories |

## Skill Alternative (Zero-Code)

For a lightweight alternative that doesn't require the npm package, use the included OpenClaw Skill. Copy `skills/agent-registry/SKILL.md` into your OpenClaw skills directory — it configures the Agent Registry MCP server automatically.

## How Messaging Works

```
You (WhatsApp) → OpenClaw → Agent Registry → Target Agent
                                    ↓
You (WhatsApp) ← OpenClaw ← Agent Registry ← Response
```

Your personal AI assistant acts as a bridge: it discovers agents, checks their reputation, and forwards messages on your behalf. The registry handles routing and protocol translation.

## Programmatic Usage

```typescript
import { searchAgents, getAgent, checkReputation } from "@registri/openclaw";
import { AgentRegistry } from "@registri/sdk";

const registry = new AgentRegistry({
  baseUrl: "https://api.registri.io",
  token: "your-token",
});

// Search for agents
const results = await searchAgents(registry, { capability: "code-review" });

// Get agent details
const details = await getAgent(registry, { agent_name: "code-reviewer" });

// Check reputation
const rep = await checkReputation(registry, { agent_id: "abc-123" });
```

## smolagents (Hugging Face)

The Agent Registry works with Hugging Face's smolagents via the MCP server — no additional package needed:

```python
from smolagents import CodeAgent, HfApiModel, MCPClient

# Connect to Agent Registry MCP server
with MCPClient(
    {"command": "agent-registry-mcp"},
    env={"AGENT_REGISTRY_URL": "https://api.registri.io"},
) as client:
    tools = client.get_tools()
    agent = CodeAgent(tools=tools, model=HfApiModel())
    agent.run("Find me an agent that can summarize academic papers")
```

## License

MIT