JSOS

A voice-first spatial cockpit for OpenClaw on Android, Rokid glasses, and Wear OS.

Download preview   ·   Watch the demo   ·   Setup guide

Important

JSOS is a development preview for builders and testers. It is not a finished consumer product.

JSOS turns a phone, Rokid glasses, and an optional Wear OS watch into one session-aware interface for OpenClaw. Core owns the connection and credentials; the HUD keeps information glanceable; the watch keeps essential controls within reach.

One system. Three surfaces.

JSOS Core Gateway, sessions, models, voice, media, and device control.

JSOS HUD A high-contrast, voice-first view built for Rokid glasses.

JSOS Watch Status, chat, voice, sessions, and Codex controls on the wrist.

_{The three interface panels are visual concepts for the unified JSOS design language. The real-device HUD below is current device photography.}

Built for movement, not another mirrored chat window

• Glanceable by design — live state and assistant output stay readable without turning the glasses into a dense phone screen.
• Voice first — speech input, realtime voice, and optional TTS work across the phone-led flow.
• Session aware — switch OpenClaw sessions and models without losing the current context.
• Local by default — runtime credentials remain on the user's devices and managed hosts.
• Three coordinated surfaces — Core remains the source of truth while HUD and Watch expose the controls that matter in the moment.

Real-device HUD

The Rokid HUD uses a deliberately restrained monochrome presentation for visibility in the optical display. Phone and Watch use cyan for structure; green remains reserved for active, ready, paired, and online states.

Quick start

1. Download JSOS Core, JSOS HUD, and the optional JSOS Watch APK from the current preview release.
2. Install JSOS Core on the Android phone and configure the OpenClaw Gateway.
3. Pair the Rokid glasses through Hi Rokid.
4. Deploy and launch JSOS HUD on the glasses.
5. Optionally install JSOS Watch on a paired Wear OS device.

For requirements, signing notes, and the complete connection flow, see docs/INSTALL.md.

Architecture

flowchart LR
    OC["OpenClaw Gateway"] -->|WebSocket| CORE["JSOS Core<br/>Android"]
    CORE -->|Rokid CXR| HUD["JSOS HUD<br/>Rokid glasses"]
    CORE -->|Wear Data Layer| WATCH["JSOS Watch<br/>Wear OS"]
    CORE -. optional .-> CODEX["Admin Codex bridge<br/>user-managed host"]

Loading

JSOS Core owns credentials, sessions, models, and runtime state. HUD and Watch receive only the state and actions required for their companion role.

Documentation

Guide	Purpose
Install	Requirements, configuration, build, and connect flow
Architecture	Components, protocols, and ownership
HUD	Display model, controls, voice, camera, and R08 input
Screenshots	Public-safe visual gallery
Security	Credentials, signing, logs, and release safety
Troubleshooting	Pairing, connection, install, voice, and TTS

Build from source

Requirements: JDK 17, Android SDK, Android Studio or Gradle, Rokid CXR SDK access, and a reachable OpenClaw Gateway.

./gradlew :phone-app:assembleDebug :glasses-app:assembleDebug :watch-app:assembleDebug

Release signing remains local-only. Never commit keystores, signing properties, runtime credentials, private screenshots, transcripts, or generated APKs.

Preview status

Rokid behavior depends on device firmware, the proprietary Rokid CXR SDK, and Hi Rokid availability. Validate voice, watch, HUD, and optional bridge flows against the exact devices and gateway version you plan to use.

Attribution and license

JSOS is based on the upstream Clawsses Android glasses project. Original upstream copyright remains with Pohlster BV and the original contributors. JSOS modifications are by Whatsskill, 2026.

This project is distributed under the GNU Affero General Public License v3. See COPYRIGHT for the complete attribution and third-party notices.