Skip to content

fw serve API

fw control plane

Start the server with fw serve [host:port]. The chat page is served on /.

Method Path Summary
POST /a2a Agent-to-Agent JSON-RPC 2.0
POST /acp Agent Client Protocol JSON-RPC 2.0
GET /claw/ranking Rust CLI and protocol rankings from fw-hermes-claw
POST /claw/run Execute Hermes/OpenClaw grounded goal loop
GET /claw/status Hermes/OpenClaw full-Rust runtime status
GET /cluster Cluster topology and registered browser WebGPU peers
POST /cluster/peers Register a browser WebGPU compute peer (peerId, vramGb, cpuCores)
POST /cluster/route KV-cache radix + disaggregated P/D routing decision
POST /graphql GraphQL query endpoint
GET /hardware OS UAPI/Win32/POSIX/Darwin & GPU/CPU/TPU hardware profile
GET /health Server health
POST /mcp Streamable HTTP MCP JSON-RPC 2.0 (fw-hermes-claw CliToMcpServer)
POST /v1/chat/completions OpenAI-compatible chat completion routed across hybrid cluster
GET /v1/crates/{op} Crate intelligence over crates.io: op is search, info, compare, rank, awesome or stack; arguments in the query (query, name, names, category, goal, limit, live)
GET /v1/models OpenAI-compatible models list
POST /v1beta/decisions Gemini Decision 1 calibrated zero-token decisions
GET /webgpu Browser page that runs a WebGPU compute shader and reports the result

Read from fw openapi.