scripts/README.md

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:

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:

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:

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:

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