Spatial Operating System for Smart Glasses
JSOS is an Android-based smart-glasses interface for Rokid glasses and a local or private OpenClaw Gateway. It combines a phone-side control deck with a lightweight glasses HUD for sessions, voice input, camera handoff, direct R08 ring control, and optional private bridge workflows.
JSOS started as an AGPL-3.0 fork of the upstream Clawsses project and has been substantially reworked into a JSOS-specific development-preview project. It is not presented as a finished consumer product.
Download preview APKs | Watch showcase video | Screenshots | Quick start | Docs map
| Part | Runs on | Purpose |
|---|---|---|
| JSOS Core | Android phone | Connects to OpenClaw, manages sessions, stores local runtime settings, handles voice input, TTS settings, camera handoff, Rokid pairing, HUD deployment, glasses brightness, and the optional Admin Codex bridge client. |
| JSOS HUD | Rokid glasses | Renders the lightweight glasses HUD, receives streamed chat updates, handles touchpad and direct R08 ring gestures, stages voice input, displays sessions, requests photo capture, and triggers Rokid AI/photo/AR picture/recording scenes. |
| Admin Codex bridge | User-managed private host | Optional self-hosted bridge for showing Codex-style output inside JSOS Core and JSOS HUD. The bridge service, credentials, and server setup are not included in this repository. |
- JSOS is a development preview, not a finished consumer product.
- Rokid behavior depends on the proprietary Rokid CXR SDK, target device firmware, and Hi Rokid availability.
- OpenClaw Live Talk and the Admin Codex bridge path are experimental and should be tested against the target gateway/bridge version.
- Runtime OpenClaw, Rokid, OpenAI, ElevenLabs, and bridge credentials are configured locally and are not shipped in this repository.
- Release signing keys, local signing properties, and built APKs must remain private.
The full public-safe screenshot set is listed in docs/SCREENSHOTS.md. The main README keeps only a short preview so the GitHub project page stays readable.
- Download the latest JSOS Core and JSOS HUD APKs from GitHub Releases.
- Allow Android to install APKs from the app used to open the downloaded files.
- Install JSOS Core on the phone.
- Open JSOS Core and configure OpenClaw Gateway host, port, token, and required runtime credentials.
- Pair the Rokid glasses through Hi Rokid and connect them from JSOS Core.
- Install the separate JSOS HUD APK on the glasses through JSOS Core HUD Deployment, or manually through Hi Rokid / APK Manager.
- Launch JSOS HUD on the glasses and connect to the phone-side JSOS Core session flow.
| Component | Link | Responsibilities |
|---|---|---|
| OpenClaw Gateway | WebSocket to JSOS Core | AI sessions, chat streaming, tool execution, pairing/device approval. |
| JSOS Core | WebSocket to OpenClaw; Bluetooth CXR to JSOS HUD | Phone-side bridge, voice input, TTS playback, wake management, runtime setup, HUD deployment. |
| JSOS HUD | Bluetooth CXR messages from JSOS Core; local R08 BLE/HID/accessibility; local Rokid scene commands | Glasses HUD, gestures, session output, camera requests, AR picture/record triggers, session picker. |
| Optional Admin Codex bridge | WebSocket from JSOS Core to a user-managed private bridge | Experimental Codex-style output in JSOS HUD/Core, separate from OpenClaw agents. |
Requirements:
- Android Studio or a working Android Gradle environment with JDK 17.
- Android SDK and platform tools.
- Rokid glasses for real-device testing.
- Rokid CXR SDK access and credentials.
- A running OpenClaw Gateway reachable from the phone.
Debug builds are the normal local development path:
./gradlew :phone-app:assembleDebug :glasses-app:assembleDebugOn Windows PowerShell:
.\gradlew.bat :phone-app:assembleDebug :glasses-app:assembleDebugExpected debug outputs:
phone-app/build/outputs/apk/debug/phone-app-debug.apk
glasses-app/build/outputs/apk/debug/glasses-app-debug.apk
Release signing is local-only. Keep jsos-release.properties, keystores such as *.jks, credentials, and generated APKs private. Do not commit them.
| Path | Purpose |
|---|---|
phone-app/ |
JSOS Core Android phone app. Bridges OpenClaw, Rokid CXR, voice, TTS, sessions, camera handoff, and HUD deployment. |
glasses-app/ |
JSOS HUD Android glasses app. Renders the HUD, handles gestures, direct R08 ring control, sessions, staged input, voice state, camera requests, and Rokid AR picture/record triggers. |
shared/ |
Shared JSON protocol models used between phone, glasses, and OpenClaw-facing code. |
docs/ |
Public notes, setup details, Rokid references, screenshots, and long-form project documentation. |
gradle/ |
Gradle wrapper files. |
LICENSE |
GNU AGPL license text. |
COPYRIGHT |
Fork, attribution, modification, and third-party notices. |
| Document | What it covers |
|---|---|
| docs/INSTALL.md | Requirements, local configuration, OpenClaw setup, build commands, release signing, and connect flow. |
| docs/ARCHITECTURE.md | Phone app, glasses app, shared protocol, OpenClaw gateway protocol, phone-glasses messages, and emulator testing. |
| docs/HUD.md | HUD display model, controls, voice modes, camera/AR tools, direct R08 ring mappings, wake, and TTS behavior. |
| docs/CODEX-BRIDGE.md | Public-safe notes for the optional private Admin Codex bridge client. |
| docs/SECURITY.md | Credentials, signing files, network exposure, logs, screenshots, and release artifact safety. |
| docs/TROUBLESHOOTING.md | Connection, pairing, install, voice, TTS, wake, and emulator debug troubleshooting. |
| docs/SCREENSHOTS.md | Public-safe screenshot list and visual asset notes. |
| docs/ROKID.md | Rokid integration notes. |
| docs/ROKID_APK_INSTALLATION.md | Hi Rokid / APK installation notes. |
| docs/rokid-sdk/README.md | Public Rokid phone-side SDK reference notes included for development context. |
| docs/rokid-sdk-glasses/README.md | Public Rokid glasses-side SDK reference notes included for development context. |
| COPYRIGHT | Fork attribution, modification notices, and third-party notices. |
| LICENSE | GNU AGPL-3.0 license text. |
Do not publish:
local.propertiesjsos-release.propertiessigning.properties*.jks.envor.env.*- private keys, tokens, API keys, access keys, client secrets, or signing passwords
- built APKs from private local configurations
- logs, screenshots, or APKs containing transcripts, session keys, API keys, device identifiers, or account data
Use trusted private-network access for local gateways and private bridges. Do not expose an OpenClaw Gateway or experimental Admin Codex bridge directly to the public internet.
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, version 3. See LICENSE and COPYRIGHT.
The Rokid CXR SDK is proprietary software from Rokid and is licensed separately by Rokid. It is not covered by the AGPL license of this repository and must be obtained under Rokid's own terms. JSOS includes a small CXR-L compatibility AAR derived from Rokid's public Maven client-l:1.0.1 artifact for the Hi Rokid deployment flow; see phone-app/libs/README.md.
Thanks to: