Faceclaw

Installing Faceclaw

Read this first

Faceclaw is unofficial and unsupported, and it replaces the firmware on your glasses. Installing it means running code that Even Realities did not write and will not help you with. The app can put the stock firmware back, but you are doing this at your own risk.

What you need

  • A pair of Even Realities G2 glasses.
  • An Android phone. Faceclaw runs as a background app and talks to the glasses over Bluetooth LE.
  • Optionally, a Wear OS 3+ watch, if you want the watch remote instead of the R1 ring.

There is no iOS version, and there will not be one — the app depends on Android APIs for background Bluetooth, notification access and media control.

Install the app

Faceclaw is not on the Play Store. Download the most recent APK from the releases page and open it on your phone; Android will ask you to allow installing apps from that source.

Install the firmware

Faceclaw needs custom firmware on the glasses, and installs it for you. On first run, the onboarding flow will offer to download the stock firmware from Even Realities, apply the g2flash patches locally, and flash the result. You confirm the flash on the glasses themselves.

Onboarding also offers a preview-only path, which connects to unmodified glasses so you can look around before committing. Faceclaw can restore the stock firmware later from the same screens.

Grant permissions

Android does not reliably prompt for everything Faceclaw uses. After installing, go to Settings → Apps → Faceclaw and check that permissions are granted — notification access and Bluetooth in particular — or parts of the app will silently do nothing.

Also exempt Faceclaw from battery optimization. Being a background app on a locked Android phone is fraught, and manufacturer-specific battery software may pause it or throttle it to low CPU usage.

Optional extras

  • Watch remote. The Wear OS app is a separate Gradle build in wear/, sideloaded over adb; it needs no Play Store, but the phone side requires Google Play services.
  • API keys. The voice assistant needs a model provider key (Anthropic or OpenAI), cloud transcription needs a key for OpenAI Whisper, ElevenLabs or Soniox, and turn-by-turn directions need a Mapbox token. On-device transcription needs no key.
  • Terminal mirroring. Install g2mirror on the machine whose terminal you want to see.
  • External agent. To route assistant queries to your own long-running agent, install the faceclaw-agent-bridge OpenClaw plugin; setup lives in that repository's README.

Building from source

Faceclaw is a NativeScript app written in TypeScript and Java, and builds with an Android SDK 35 environment and a JDK 21. The README has the current build and adb instructions; they are kept there rather than duplicated here, so they stay in step with the code.