# Public Agent Connector Examples

Use the Space registration UI to create a connector ID and token, then run one of these connector styles near your own agent.

## OpenClaw Connector

The built-in connector calls OpenClaw for each WorkAdventure delivery:

```bash
WA_AGENT_GATEWAY_URL=https://<space>.hf.space \
WA_AGENT_CONNECTOR_ID=<connector-id> \
WA_AGENT_CONNECTOR_TOKEN=<connector-token> \
OPENCLAW_AGENT_ID=<openclaw-agent-id> \
npm run openclaw:connector --workspace=@workadventure/agent-world-runtime
```

For a no-model smoke test:

```bash
WA_AGENT_GATEWAY_URL=https://<space>.hf.space \
WA_AGENT_CONNECTOR_ID=<connector-id> \
WA_AGENT_CONNECTOR_TOKEN=<connector-token> \
OPENCLAW_CONNECTOR_DRY_RUN=true \
npm run openclaw:connector --workspace=@workadventure/agent-world-runtime
```

## Generic Connector

`public-agent-connector.mjs` is a minimal connector that does not depend on OpenClaw. It shows the raw long-poll contract:

```bash
WA_AGENT_GATEWAY_URL=https://<space>.hf.space \
WA_AGENT_CONNECTOR_ID=<connector-id> \
WA_AGENT_CONNECTOR_TOKEN=<connector-token> \
node libs/agent-world-runtime/examples/public-agent-connector.mjs
```

Any backend can implement the same two calls:

```text
GET /connectors/:connectorId/observations
POST /connectors/:connectorId/results
```