@athenafleet/bridge

CLI bridge connecting your local OpenClaw gateway to the Athena dashboard via WebSocket.

Install

npm i -g @athenafleet/bridge

Usage

athena-bridge --key rtk_xxx

That's it. The bridge connects to the Athena API, authenticates with your runtime key, and begins syncing agent data from your local OpenClaw gateway to the dashboard.

Options

| Flag | Default | Description | |------|---------|-------------| | --key, -k | (required) | Runtime API key (rtk_ prefix) | | --api-url | https://api.athenafleet.ai | Athena API URL | | --gateway-id | hostname | Identifier for this gateway | | --openclaw-url | http://localhost:3007 | Local OpenClaw gateway URL | | --verbose, -v | false | Enable debug logging |

What it does

1. Connects to the Athena WebSocket endpoint (/ws/runtime)
2. Authenticates with your runtime API key (first-message auth)
3. Syncs agent data from your local OpenClaw gateway every 60 seconds
4. Heartbeats every 30 seconds to keep the connection alive
5. Reconnects automatically with exponential backoff if disconnected

Generate a key

Runtime keys are created in the Athena dashboard under Settings → Runtime Keys, or via the API:

curl -X POST https://api.athenafleet.ai/api/admin/runtime-keys \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"name": "My Gateway"}'

The key is shown once on creation — save it.

Requirements

• Node.js ≥ 18
• An Athena account with a runtime API key
• OpenClaw gateway running locally (optional — bridge works without it, just syncs empty agent list)

License

MIT