Adds a WebSocket adapter that lets Claw3D connect to a Hermes AI agent
runtime without any changes to the frontend. The adapter implements the
full Claw3D gateway protocol and bridges it to the Hermes HTTP API.
Changes:
- server/hermes-gateway-adapter.js: WebSocket bridge implementing the
Claw3D gateway protocol against the Hermes HTTP API. Supports all
core methods (agents, sessions, chat streaming, cron, config, files,
approvals) and multi-agent orchestration via spawn_agent/delegate_task
tools. Persists conversation history to ~/.hermes/clawd3d-history.json.
- scripts/clawd3d-start.sh: All-in-one startup script that launches
Hermes, the adapter, and the Next.js dev server with auto port
conflict resolution. Alias as `claw3d` for convenience.
- src/features/office/hooks/useCronAgents.ts: Hook that polls the
gateway for cron-scheduled agents and surfaces them in the 3D office.
- package.json: adds `hermes-adapter` npm script
- .env.example: documents Hermes config vars
- docs/hermes-gateway.md: setup guide and protocol reference
Usage:
npm run hermes-adapter # start adapter (connect to http://localhost:8642)
npm run dev # start Claw3D, point browser at localhost:3000
# or: bash scripts/clawd3d-start.sh (starts everything automatically)
Both OpenClaw and Hermes are supported simultaneously — the gateway URL
in NEXT_PUBLIC_GATEWAY_URL determines which backend Claw3D connects to.
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
gsknnft