← Discover MCPs and Agents
o
MCPAI & MLGitHub

openclaw-hub-runtime

OpenClaw Hub Runtime is a modular frontend runtime for building AI command surfaces with streaming UX, reconnect-aware diagnostics, recovery foundations, and reusable shell bindings.

Links

Repository

README

From the repo.

OpenClaw Hub Runtime

A reusable runtime for themeable real-time AI command interfaces on top of the real OpenClaw Gateway.

Not just another chat skin.
A runtime for battle-ready AI terminals.

OpenClaw Hub Runtime is a modular frontend runtime for AI command surfaces with streaming UX, reconnect-aware diagnostics, resume/recovery foundations, and reusable shell bindings.

Why this repo is worth a star

  • Real backend, not a mock demo — built around actual OpenClaw Gateway integration
  • Runtime, not a one-off shell — one runtime already powers both a flagship Jarvis shell and a minimal shell
  • Resilience is part of the product — reconnect, recovery, diagnostics, and resume flows are first-class
  • Designed to be reused — shell identity and runtime behavior are intentionally separated

What you can see in 30 seconds

1) Flagship Jarvis shell

Jarvis runtime

2) Battle-damaged reconnect / poster mode

Battle-damaged poster

3) Minimal shell proving portability

See examples/minimal-hub/README.md and examples/minimal-hub/index.html.

What this repository contains

  • a flagship J.A.R.V.I.S.-style shell
  • a reusable runtime core
  • a real OpenClaw Gateway adapter
  • a reconnect and recovery layer
  • a deterministic test harness
  • a minimal shell example proving portability

Build one runtime once, then launch multiple AI shells on top of it.

Quick start

Prerequisites

  • OpenClaw Gateway running locally on 127.0.0.1:18789
  • a valid local gateway token stored outside published history
  • a local static file server

Start a local server

cd d:\openclaw
python -m http.server 8787

Open the shells

Jarvis shell

http://127.0.0.1:8787/apps/jarvis-hub/index.html

Minimal shell

http://127.0.0.1:8787/examples/minimal-hub/index.html

Resume showcase

http://127.0.0.1:8787/apps/jarvis-hub/index.html?testResume=1

Poster showcase

http://127.0.0.1:8787/apps/jarvis-hub/index.html?testResume=1&poster=1

For a fuller setup guide, see docs/getting-started.md.

Core features

  • real OpenClaw Gateway WebSocket connection
  • connect, health, chat.history, chat.send, agents.list
  • soft-throttled streaming assistant output
  • fenced code block rendering as sub-terminals
  • sidebar agent list
  • diagnostics-first reconnect UX
  • resume / reconcile / replay foundations
  • built-in /diagnose and /test-resume showcase commands
  • shared Chinese copy support
  • reusable shell binding through HUB_CONFIG

Why follow this project

Star this if you care about any of these directions:

  • reusable AI command interface runtimes
  • real-time streaming UI on top of actual agent backends
  • reconnect / recovery UX as a product feature
  • shell portability instead of single-demo UI work
  • OpenClaw-native frontend experiments with real integration

If you only want a pretty screenshot, this repo may be overbuilt. If you want a strong reference point for runtime + shell + resilience, that is exactly what this project is trying to become.

Architecture

OpenClaw Hub Runtime is organized as layered modules:

  • Hub Shell — layout, shell DOM, copy loading, theme styling
  • Runtime — shell binding, store, renderer, commands, bootstrap
  • Adapter — OpenClaw transport and protocol handling
  • Reconnect Manager — resilience, replay, recovery
  • Test Harness — deterministic showcase and resume scenarios

Read the full system breakdown in docs/architecture.md.

Documentation

  • Getting Started: docs/getting-started.md
  • Architecture: docs/architecture.md
  • Theming: docs/theming.md
  • Adapter API: docs/adapter-api.md
  • Launch Guide: docs/github-launch.md
  • Launch Content Pack: docs/launch-content-pack.md
  • Launch Kit: docs/launch-kit.md
  • GitHub Publish Pack: docs/github-publish-pack.md
  • Final Publish Preset: docs/final-publish-preset.md
  • Star Pack: docs/star-pack.md
  • Changelog: CHANGELOG.md

Shells

Flagship shell

  • apps/jarvis-hub/index.html

This is the cinematic HUD reference implementation.

Minimal example shell

  • examples/minimal-hub/index.html

This proves the runtime can boot a second shell with a simpler surface and different product feel.

Repository layout

apps/
  jarvis-hub/

examples/
  minimal-hub/

packages/
  adapters/openclaw/
  runtime/
  shared/
  test-harness/
  themes/

docs/
scripts/

Release status

This repository is currently best understood as:

the first public reference runtime for building OpenClaw-native AI command interfaces.

It is already a strong working implementation, but it is also the beginning of a broader reusable runtime direction.

Contributing

Contributions are welcome. Start with:

  • CONTRIBUTING.md
  • docs/architecture.md
  • docs/theming.md
  • docs/adapter-api.md

Please run the PowerShell verification scripts before proposing changes.

Security

If you discover a sensitive issue, see SECURITY.md.

License

This repository is licensed under the MIT License. See LICENSE.

Collected info

  • ★ 3 stars
  • Language: JavaScript
  • Source updated: 3/20/2026

Config for your environment

Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.

Tool

OS

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "url": "{MCP_ENDPOINT_URL}"
    }
  }
}

Paste into mcpServers in the config file. Restart Cursor after saving.

If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.